mirror of
https://github.com/neovim/neovim.git
synced 2024-12-24 21:25:04 -07:00
a6e3d93421
This requires removing the "Inner expression should be aligned" rule from clint as it prevents essentially any formatting regarding ternary operators.
3736 lines
151 KiB
INI
3736 lines
151 KiB
INI
# Uncrustify-0.78.1_f
|
|
|
|
#
|
|
# General options
|
|
#
|
|
|
|
# The type of line endings.
|
|
#
|
|
# Default: auto
|
|
newlines = lf # lf/crlf/cr/auto
|
|
|
|
# The original size of tabs in the input.
|
|
#
|
|
# Default: 8
|
|
input_tab_size = 8 # unsigned number
|
|
|
|
# The size of tabs in the output (only used if align_with_tabs=true).
|
|
#
|
|
# Default: 8
|
|
output_tab_size = 8 # unsigned number
|
|
|
|
# The ASCII value of the string escape char, usually 92 (\) or (Pawn) 94 (^).
|
|
#
|
|
# Default: 92
|
|
string_escape_char = 92 # unsigned number
|
|
|
|
# Alternate string escape char (usually only used for Pawn).
|
|
# Only works right before the quote char.
|
|
string_escape_char2 = 0 # unsigned number
|
|
|
|
# Replace tab characters found in string literals with the escape sequence \t
|
|
# instead.
|
|
string_replace_tab_chars = false # true/false
|
|
|
|
# Allow interpreting '>=' and '>>=' as part of a template in code like
|
|
# 'void f(list<list<B>>=val);'. If true, 'assert(x<0 && y>=3)' will be broken.
|
|
# Improvements to template detection may make this option obsolete.
|
|
tok_split_gte = false # true/false
|
|
|
|
# Disable formatting of NL_CONT ('\\n') ended lines (e.g. multi-line macros).
|
|
disable_processing_nl_cont = false # true/false
|
|
|
|
# Specify the marker used in comments to disable processing of part of the
|
|
# file.
|
|
#
|
|
# Default: *INDENT-OFF*
|
|
disable_processing_cmt = "uncrustify:off" # string
|
|
|
|
# Specify the marker used in comments to (re)enable processing in a file.
|
|
#
|
|
# Default: *INDENT-ON*
|
|
enable_processing_cmt = "uncrustify:on" # string
|
|
|
|
# Enable parsing of digraphs.
|
|
enable_digraphs = false # true/false
|
|
|
|
# Option to allow both disable_processing_cmt and enable_processing_cmt
|
|
# strings, if specified, to be interpreted as ECMAScript regular expressions.
|
|
# If true, a regex search will be performed within comments according to the
|
|
# specified patterns in order to disable/enable processing.
|
|
processing_cmt_as_regex = false # true/false
|
|
|
|
# Add or remove the UTF-8 BOM (recommend 'remove').
|
|
utf8_bom = remove # ignore/add/remove/force/not_defined
|
|
|
|
# If the file contains bytes with values between 128 and 255, but is not
|
|
# UTF-8, then output as UTF-8.
|
|
utf8_byte = false # true/false
|
|
|
|
# Force the output encoding to UTF-8.
|
|
utf8_force = false # true/false
|
|
|
|
#
|
|
# Spacing options
|
|
#
|
|
|
|
# Add or remove space around non-assignment symbolic operators ('+', '/', '%',
|
|
# '<<', and so forth).
|
|
sp_arith = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around arithmetic operators '+' and '-'.
|
|
#
|
|
# Overrides sp_arith.
|
|
sp_arith_additive = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around assignment operator '=', '+=', etc.
|
|
sp_assign = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around '=' in C++11 lambda capture specifications.
|
|
#
|
|
# Overrides sp_assign.
|
|
sp_cpp_lambda_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the capture specification of a C++11 lambda when
|
|
# an argument list is present, as in '[] <here> (int x){ ... }'.
|
|
sp_cpp_lambda_square_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the capture specification of a C++11 lambda with
|
|
# no argument list is present, as in '[] <here> { ... }'.
|
|
sp_cpp_lambda_square_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the opening parenthesis and before the closing
|
|
# parenthesis of a argument list of a C++11 lambda, as in
|
|
# '[]( <here> ){ ... }'
|
|
# with an empty list.
|
|
sp_cpp_lambda_argument_list_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the opening parenthesis and before the closing
|
|
# parenthesis of a argument list of a C++11 lambda, as in
|
|
# '[]( <here> int x <here> ){ ... }'.
|
|
sp_cpp_lambda_argument_list = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the argument list of a C++11 lambda, as in
|
|
# '[](int x) <here> { ... }'.
|
|
sp_cpp_lambda_paren_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a lambda body and its call operator of an
|
|
# immediately invoked lambda, as in '[]( ... ){ ... } <here> ( ... )'.
|
|
sp_cpp_lambda_fparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around assignment operator '=' in a prototype.
|
|
#
|
|
# If set to ignore, use sp_assign.
|
|
sp_assign_default = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before assignment operator '=', '+=', etc.
|
|
#
|
|
# Overrides sp_assign.
|
|
sp_before_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after assignment operator '=', '+=', etc.
|
|
#
|
|
# Overrides sp_assign.
|
|
sp_after_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space in 'enum {'.
|
|
#
|
|
# Default: add
|
|
sp_enum_brace = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space in 'NS_ENUM ('.
|
|
sp_enum_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around assignment '=' in enum.
|
|
sp_enum_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before assignment '=' in enum.
|
|
#
|
|
# Overrides sp_enum_assign.
|
|
sp_enum_before_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after assignment '=' in enum.
|
|
#
|
|
# Overrides sp_enum_assign.
|
|
sp_enum_after_assign = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around assignment ':' in enum.
|
|
sp_enum_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around preprocessor '##' concatenation operator.
|
|
#
|
|
# Default: add
|
|
sp_pp_concat = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after preprocessor '#' stringify operator.
|
|
# Also affects the '#@' charizing operator.
|
|
sp_pp_stringify = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before preprocessor '#' stringify operator
|
|
# as in '#define x(y) L#y'.
|
|
sp_before_pp_stringify = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around boolean operators '&&' and '||'.
|
|
sp_bool = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around compare operator '<', '>', '==', etc.
|
|
sp_compare = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '(' and ')'.
|
|
sp_inside_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between nested parentheses, i.e. '((' vs. ') )'.
|
|
sp_paren_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between back-to-back parentheses, i.e. ')(' vs. ') ('.
|
|
sp_cparen_oparen = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to balance spaces inside nested parentheses.
|
|
sp_balance_nested_parens = false # true/false
|
|
|
|
# Add or remove space between ')' and '{'.
|
|
sp_paren_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between nested braces, i.e. '{{' vs. '{ {'.
|
|
sp_brace_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*'.
|
|
sp_before_ptr_star = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*' that isn't followed by a
|
|
# variable name. If set to ignore, sp_before_ptr_star is used instead.
|
|
sp_before_unnamed_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*' that is followed by a qualifier.
|
|
# If set to ignore, sp_before_unnamed_ptr_star is used instead.
|
|
sp_before_qualifier_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*' that is followed by 'operator' keyword.
|
|
# If set to ignore, sp_before_unnamed_ptr_star is used instead.
|
|
sp_before_operator_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*' that is followed by
|
|
# a class scope (as in 'int *MyClass::method()') or namespace scope
|
|
# (as in 'int *my_ns::func()').
|
|
# If set to ignore, sp_before_unnamed_ptr_star is used instead.
|
|
sp_before_scope_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before pointer star '*' that is followed by '::',
|
|
# as in 'int *::func()'.
|
|
# If set to ignore, sp_before_unnamed_ptr_star is used instead.
|
|
sp_before_global_scope_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a qualifier and a pointer star '*' that isn't
|
|
# followed by a variable name, as in '(char const *)'. If set to ignore,
|
|
# sp_before_ptr_star is used instead.
|
|
sp_qualifier_unnamed_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between pointer stars '*', as in 'int ***a;'.
|
|
sp_between_ptr_star = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between pointer star '*' and reference '&', as in 'int *& a;'.
|
|
sp_between_ptr_ref = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after pointer star '*', if followed by a word.
|
|
#
|
|
# Overrides sp_type_func.
|
|
sp_after_ptr_star = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after pointer caret '^', if followed by a word.
|
|
sp_after_ptr_block_caret = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after pointer star '*', if followed by a qualifier.
|
|
sp_after_ptr_star_qualifier = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a pointer star '*', if followed by a function
|
|
# prototype or function definition.
|
|
#
|
|
# Overrides sp_after_ptr_star and sp_type_func.
|
|
sp_after_ptr_star_func = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a pointer star '*' in the trailing return of a
|
|
# function prototype or function definition.
|
|
sp_after_ptr_star_trailing = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the pointer star '*' and the name of the variable
|
|
# in a function pointer definition.
|
|
sp_ptr_star_func_var = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the pointer star '*' and the name of the type
|
|
# in a function pointer type definition.
|
|
sp_ptr_star_func_type = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a pointer star '*', if followed by an open
|
|
# parenthesis, as in 'void* (*)()'.
|
|
sp_ptr_star_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a pointer star '*', if followed by a function
|
|
# prototype or function definition. If set to ignore, sp_before_ptr_star is
|
|
# used instead.
|
|
sp_before_ptr_star_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a qualifier and a pointer star '*' followed by
|
|
# the name of the function in a function prototype or definition, as in
|
|
# 'char const *foo()`. If set to ignore, sp_before_ptr_star is used instead.
|
|
sp_qualifier_ptr_star_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a pointer star '*' in the trailing return of a
|
|
# function prototype or function definition.
|
|
sp_before_ptr_star_trailing = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a qualifier and a pointer star '*' in the
|
|
# trailing return of a function prototype or function definition, as in
|
|
# 'auto foo() -> char const *'.
|
|
sp_qualifier_ptr_star_trailing = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a reference sign '&'.
|
|
sp_before_byref = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a reference sign '&' that isn't followed by a
|
|
# variable name. If set to ignore, sp_before_byref is used instead.
|
|
sp_before_unnamed_byref = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after reference sign '&', if followed by a word.
|
|
#
|
|
# Overrides sp_type_func.
|
|
sp_after_byref = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a reference sign '&', if followed by a function
|
|
# prototype or function definition.
|
|
#
|
|
# Overrides sp_after_byref and sp_type_func.
|
|
sp_after_byref_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a reference sign '&', if followed by a function
|
|
# prototype or function definition.
|
|
sp_before_byref_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a reference sign '&', if followed by an open
|
|
# parenthesis, as in 'char& (*)()'.
|
|
sp_byref_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between type and word. In cases where total removal of
|
|
# whitespace would be a syntax error, a value of 'remove' is treated the same
|
|
# as 'force'.
|
|
#
|
|
# This also affects some other instances of space following a type that are
|
|
# not covered by other options; for example, between the return type and
|
|
# parenthesis of a function type template argument, between the type and
|
|
# parenthesis of an array parameter, or between 'decltype(...)' and the
|
|
# following word.
|
|
#
|
|
# Default: force
|
|
sp_after_type = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'decltype(...)' and word,
|
|
# brace or function call.
|
|
sp_after_decltype = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space before the parenthesis in the D constructs
|
|
# 'template Foo(' and 'class Foo('.
|
|
sp_before_template_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'template' and '<'.
|
|
# If set to ignore, sp_before_angle is used.
|
|
sp_template_angle = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before '<'.
|
|
sp_before_angle = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '<' and '>'.
|
|
sp_inside_angle = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '<>'.
|
|
# if empty.
|
|
sp_inside_angle_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '>' and ':'.
|
|
sp_angle_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after '>'.
|
|
sp_after_angle = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '>' and '(' as found in 'new List<byte>(foo);'.
|
|
sp_angle_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '>' and '()' as found in 'new List<byte>();'.
|
|
sp_angle_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '>' and a word as in 'List<byte> m;' or
|
|
# 'template <typename T> static ...'.
|
|
sp_angle_word = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '>' and '>' in '>>' (template stuff).
|
|
#
|
|
# Default: add
|
|
sp_angle_shift = add # ignore/add/remove/force/not_defined
|
|
|
|
# (C++11) Permit removal of the space between '>>' in 'foo<bar<int> >'. Note
|
|
# that sp_angle_shift cannot remove the space without this option.
|
|
sp_permit_cpp11_shift = false # true/false
|
|
|
|
# Add or remove space before '(' of control statements ('if', 'for', 'switch',
|
|
# 'while', etc.).
|
|
sp_before_sparen = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '(' and ')' of control statements other than
|
|
# 'for'.
|
|
sp_inside_sparen = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after '(' of control statements other than 'for'.
|
|
#
|
|
# Overrides sp_inside_sparen.
|
|
sp_inside_sparen_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ')' of control statements other than 'for'.
|
|
#
|
|
# Overrides sp_inside_sparen.
|
|
sp_inside_sparen_close = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '(' and ')' of 'for' statements.
|
|
sp_inside_for = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after '(' of 'for' statements.
|
|
#
|
|
# Overrides sp_inside_for.
|
|
sp_inside_for_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ')' of 'for' statements.
|
|
#
|
|
# Overrides sp_inside_for.
|
|
sp_inside_for_close = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '((' or '))' of control statements.
|
|
sp_sparen_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after ')' of control statements.
|
|
sp_after_sparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and '{' of control statements.
|
|
sp_sparen_brace = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'do' and '{'.
|
|
sp_do_brace_open = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '}' and 'while'.
|
|
sp_brace_close_while = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'while' and '('. Overrides sp_before_sparen.
|
|
sp_while_paren_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space between 'invariant' and '('.
|
|
sp_invariant_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space after the ')' in 'invariant (C) c'.
|
|
sp_after_invariant_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before empty statement ';' on 'if', 'for' and 'while'.
|
|
sp_special_semi = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ';'.
|
|
#
|
|
# Default: remove
|
|
sp_before_semi = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ';' in non-empty 'for' statements.
|
|
sp_before_semi_for = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a semicolon of an empty left part of a for
|
|
# statement, as in 'for ( <here> ; ; )'.
|
|
sp_before_semi_for_empty = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the semicolons of an empty middle part of a for
|
|
# statement, as in 'for ( ; <here> ; )'.
|
|
sp_between_semi_for_empty = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after ';', except when followed by a comment.
|
|
#
|
|
# Default: add
|
|
sp_after_semi = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after ';' in non-empty 'for' statements.
|
|
#
|
|
# Default: force
|
|
sp_after_semi_for = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the final semicolon of an empty part of a for
|
|
# statement, as in 'for ( ; ; <here> )'.
|
|
sp_after_semi_for_empty = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before '[' (except '[]').
|
|
sp_before_square = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before '[' for a variable definition.
|
|
#
|
|
# Default: remove
|
|
sp_before_vardef_square = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before '[' for asm block.
|
|
sp_before_square_asm_block = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before '[]'.
|
|
sp_before_squares = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before C++17 structured bindings.
|
|
sp_cpp_before_struct_binding = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside a non-empty '[' and ']'.
|
|
sp_inside_square = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '[]'.
|
|
# if empty.
|
|
sp_inside_square_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space inside a non-empty Objective-C boxed array '@[' and
|
|
# ']'. If set to ignore, sp_inside_square is used.
|
|
sp_inside_square_oc_array = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after ',', i.e. 'a,b' vs. 'a, b'.
|
|
sp_after_comma = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ',', i.e. 'a,b' vs. 'a ,b'.
|
|
#
|
|
# Default: remove
|
|
sp_before_comma = remove # ignore/add/remove/force/not_defined
|
|
|
|
# (C#, Vala) Add or remove space between ',' and ']' in multidimensional array type
|
|
# like 'int[,,]'.
|
|
sp_after_mdatype_commas = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (C#, Vala) Add or remove space between '[' and ',' in multidimensional array type
|
|
# like 'int[,,]'.
|
|
sp_before_mdatype_commas = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (C#, Vala) Add or remove space between ',' in multidimensional array type
|
|
# like 'int[,,]'.
|
|
sp_between_mdatype_commas = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between an open parenthesis and comma,
|
|
# i.e. '(,' vs. '( ,'.
|
|
#
|
|
# Default: force
|
|
sp_paren_comma = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a type and ':'.
|
|
sp_type_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the variadic '...' when preceded by a
|
|
# non-punctuator.
|
|
# The value REMOVE will be overridden with FORCE
|
|
sp_after_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the variadic '...' when preceded by a
|
|
# non-punctuator.
|
|
# The value REMOVE will be overridden with FORCE
|
|
sp_before_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a type and '...'.
|
|
sp_type_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a '*' and '...'.
|
|
sp_ptr_type_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and '...'.
|
|
sp_paren_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '&&' and '...'.
|
|
sp_byref_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and a qualifier such as 'const'.
|
|
sp_paren_qualifier = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and 'noexcept'.
|
|
sp_paren_noexcept = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after class ':'.
|
|
sp_after_class_colon = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before class ':'.
|
|
sp_before_class_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after class constructor ':'.
|
|
#
|
|
# Default: add
|
|
sp_after_constr_colon = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before class constructor ':'.
|
|
#
|
|
# Default: add
|
|
sp_before_constr_colon = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before case ':'.
|
|
#
|
|
# Default: remove
|
|
sp_before_case_colon = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'operator' and operator sign.
|
|
sp_after_operator = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the operator symbol and the open parenthesis, as
|
|
# in 'operator ++('.
|
|
sp_after_operator_sym = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides sp_after_operator_sym when the operator has no arguments, as in
|
|
# 'operator *()'.
|
|
sp_after_operator_sym_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after C/D cast, i.e. 'cast(int)a' vs. 'cast(int) a' or
|
|
# '(int)a' vs. '(int) a'.
|
|
sp_after_cast = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove spaces inside cast parentheses.
|
|
sp_inside_paren_cast = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the type and open parenthesis in a C++ cast,
|
|
# i.e. 'int(exp)' vs. 'int (exp)'.
|
|
sp_cpp_cast_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'sizeof' and '('.
|
|
sp_sizeof_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'sizeof' and '...'.
|
|
sp_sizeof_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'sizeof...' and '('.
|
|
sp_sizeof_ellipsis_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '...' and a parameter pack.
|
|
sp_ellipsis_parameter_pack = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a parameter pack and '...'.
|
|
sp_parameter_pack_ellipsis = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'decltype' and '('.
|
|
sp_decltype_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (Pawn) Add or remove space after the tag keyword.
|
|
sp_after_tag = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside enum '{' and '}'.
|
|
sp_inside_braces_enum = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside struct/union '{' and '}'.
|
|
sp_inside_braces_struct = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space inside Objective-C boxed dictionary '{' and '}'
|
|
sp_inside_braces_oc_dict = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after open brace in an unnamed temporary
|
|
# direct-list-initialization
|
|
# if statement is a brace_init_lst
|
|
# works only if sp_brace_brace is set to ignore.
|
|
sp_after_type_brace_init_lst_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before close brace in an unnamed temporary
|
|
# direct-list-initialization
|
|
# if statement is a brace_init_lst
|
|
# works only if sp_brace_brace is set to ignore.
|
|
sp_before_type_brace_init_lst_close = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside an unnamed temporary direct-list-initialization
|
|
# if statement is a brace_init_lst
|
|
# works only if sp_brace_brace is set to ignore
|
|
# works only if sp_before_type_brace_init_lst_close is set to ignore.
|
|
sp_inside_type_brace_init_lst = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '{' and '}'.
|
|
sp_inside_braces = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside '{}'.
|
|
# if empty.
|
|
sp_inside_braces_empty = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around trailing return operator '->'.
|
|
sp_trailing_return = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between return type and function name. A minimum of 1
|
|
# is forced except for pointer return types.
|
|
sp_type_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between type and open brace of an unnamed temporary
|
|
# direct-list-initialization.
|
|
sp_type_brace_init_lst = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '(' on function declaration.
|
|
sp_func_proto_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '()' on function declaration
|
|
# if empty.
|
|
sp_func_proto_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '(' with a typedef specifier.
|
|
sp_func_type_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between alias name and '(' of a non-pointer function type typedef.
|
|
sp_func_def_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '()' on function definition
|
|
# if empty.
|
|
sp_func_def_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside empty function '()'.
|
|
# Overrides sp_after_angle unless use_sp_after_angle_always is set to true.
|
|
sp_inside_fparens = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside function '(' and ')'.
|
|
sp_inside_fparen = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside user functor '(' and ')'.
|
|
sp_func_call_user_inside_rparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside empty functor '()'.
|
|
# Overrides sp_after_angle unless use_sp_after_angle_always is set to true.
|
|
sp_inside_rparens = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside functor '(' and ')'.
|
|
sp_inside_rparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside the first parentheses in a function type, as in
|
|
# 'void (*x)(...)'.
|
|
sp_inside_tparen = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the ')' and '(' in a function type, as in
|
|
# 'void (*x)(...)'.
|
|
sp_after_tparen_close = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ']' and '(' when part of a function call.
|
|
sp_square_fparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and '{' of function.
|
|
sp_fparen_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and '{' of a function call in object
|
|
# initialization.
|
|
#
|
|
# Overrides sp_fparen_brace.
|
|
sp_fparen_brace_initializer = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (Java) Add or remove space between ')' and '{{' of double brace initializer.
|
|
sp_fparen_dbrace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '(' on function calls.
|
|
sp_func_call_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between function name and '()' on function calls without
|
|
# parameters. If set to ignore (the default), sp_func_call_paren is used.
|
|
sp_func_call_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between the user function name and '(' on function
|
|
# calls. You need to set a keyword to be a user function in the config file,
|
|
# like:
|
|
# set func_call_user tr _ i18n
|
|
sp_func_call_user_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside user function '(' and ')'.
|
|
sp_func_call_user_inside_fparen = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between nested parentheses with user functions,
|
|
# i.e. '((' vs. '( ('.
|
|
sp_func_call_user_paren_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a constructor/destructor and the open
|
|
# parenthesis.
|
|
sp_func_class_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a constructor without parameters or destructor
|
|
# and '()'.
|
|
sp_func_class_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after 'return'.
|
|
#
|
|
# Default: force
|
|
sp_return = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'return' and '('.
|
|
sp_return_paren = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'return' and '{'.
|
|
sp_return_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '__attribute__' and '('.
|
|
sp_attribute_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'defined' and '(' in '#if defined (FOO)'.
|
|
sp_defined_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'throw' and '(' in 'throw (something)'.
|
|
sp_throw_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'throw' and anything other than '(' as in
|
|
# '@throw [...];'.
|
|
sp_after_throw = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'catch' and '(' in 'catch (something) { }'.
|
|
# If set to ignore, sp_before_sparen is used.
|
|
sp_catch_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between '@catch' and '('
|
|
# in '@catch (something) { }'. If set to ignore, sp_catch_paren is used.
|
|
sp_oc_catch_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before Objective-C protocol list
|
|
# as in '@protocol Protocol<here><Protocol_A>' or '@interface MyClass : NSObject<here><MyProtocol>'.
|
|
sp_before_oc_proto_list = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between class name and '('
|
|
# in '@interface className(categoryName)<ProtocolName>:BaseClass'
|
|
sp_oc_classname_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space between 'version' and '('
|
|
# in 'version (something) { }'. If set to ignore, sp_before_sparen is used.
|
|
sp_version_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space between 'scope' and '('
|
|
# in 'scope (something) { }'. If set to ignore, sp_before_sparen is used.
|
|
sp_scope_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'super' and '(' in 'super (something)'.
|
|
#
|
|
# Default: remove
|
|
sp_super_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'this' and '(' in 'this (something)'.
|
|
#
|
|
# Default: remove
|
|
sp_this_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a macro name and its definition.
|
|
sp_macro = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a macro function ')' and its definition.
|
|
sp_macro_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'else' and '{' if on the same line.
|
|
sp_else_brace = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '}' and 'else' if on the same line.
|
|
sp_brace_else = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '}' and the name of a typedef on the same line.
|
|
sp_brace_typedef = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the '{' of a 'catch' statement, if the '{' and
|
|
# 'catch' are on the same line, as in 'catch (decl) <here> {'.
|
|
sp_catch_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before the '{' of a '@catch' statement, if the '{'
|
|
# and '@catch' are on the same line, as in '@catch (decl) <here> {'.
|
|
# If set to ignore, sp_catch_brace is used.
|
|
sp_oc_catch_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '}' and 'catch' if on the same line.
|
|
sp_brace_catch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between '}' and '@catch' if on the same line.
|
|
# If set to ignore, sp_brace_catch is used.
|
|
sp_oc_brace_catch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'finally' and '{' if on the same line.
|
|
sp_finally_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '}' and 'finally' if on the same line.
|
|
sp_brace_finally = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'try' and '{' if on the same line.
|
|
sp_try_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between get/set and '{' if on the same line.
|
|
sp_getset_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a variable and '{' for C++ uniform
|
|
# initialization.
|
|
sp_word_brace_init_lst = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between a variable and '{' for a namespace.
|
|
#
|
|
# Default: add
|
|
sp_word_brace_ns = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the '::' operator.
|
|
sp_before_dc = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '::' operator.
|
|
sp_after_dc = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove around the D named array initializer ':' operator.
|
|
sp_d_array_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '!' (not) unary operator.
|
|
#
|
|
# Default: remove
|
|
sp_not = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between two '!' (not) unary operators.
|
|
# If set to ignore, sp_not will be used.
|
|
sp_not_not = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '~' (invert) unary operator.
|
|
#
|
|
# Default: remove
|
|
sp_inv = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '&' (address-of) unary operator. This does not
|
|
# affect the spacing after a '&' that is part of a type.
|
|
#
|
|
# Default: remove
|
|
sp_addr = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around the '.' or '->' operators.
|
|
#
|
|
# Default: remove
|
|
sp_member = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '*' (dereference) unary operator. This does
|
|
# not affect the spacing after a '*' that is part of a type.
|
|
#
|
|
# Default: remove
|
|
sp_deref = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'.
|
|
#
|
|
# Default: remove
|
|
sp_sign = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between '++' and '--' the word to which it is being
|
|
# applied, as in '(--x)' or 'y++;'.
|
|
#
|
|
# Default: remove
|
|
sp_incdec = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a backslash-newline at the end of a line.
|
|
#
|
|
# Default: add
|
|
sp_before_nl_cont = force # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the scope '+' or '-', as in '-(void) foo;'
|
|
# or '+(int) bar;'.
|
|
sp_after_oc_scope = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the colon in message specs,
|
|
# i.e. '-(int) f:(int) x;' vs. '-(int) f: (int) x;'.
|
|
sp_after_oc_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before the colon in message specs,
|
|
# i.e. '-(int) f: (int) x;' vs. '-(int) f : (int) x;'.
|
|
sp_before_oc_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the colon in immutable dictionary expression
|
|
# 'NSDictionary *test = @{@"foo" :@"bar"};'.
|
|
sp_after_oc_dict_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before the colon in immutable dictionary expression
|
|
# 'NSDictionary *test = @{@"foo" :@"bar"};'.
|
|
sp_before_oc_dict_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the colon in message specs,
|
|
# i.e. '[object setValue:1];' vs. '[object setValue: 1];'.
|
|
sp_after_send_oc_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before the colon in message specs,
|
|
# i.e. '[object setValue:1];' vs. '[object setValue :1];'.
|
|
sp_before_send_oc_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the (type) in message specs,
|
|
# i.e. '-(int)f: (int) x;' vs. '-(int)f: (int)x;'.
|
|
sp_after_oc_type = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after the first (type) in message specs,
|
|
# i.e. '-(int) f:(int)x;' vs. '-(int)f:(int)x;'.
|
|
sp_after_oc_return_type = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between '@selector' and '(',
|
|
# i.e. '@selector(msgName)' vs. '@selector (msgName)'.
|
|
# Also applies to '@protocol()' constructs.
|
|
sp_after_oc_at_sel = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between '@selector(x)' and the following word,
|
|
# i.e. '@selector(foo) a:' vs. '@selector(foo)a:'.
|
|
sp_after_oc_at_sel_parens = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space inside '@selector' parentheses,
|
|
# i.e. '@selector(foo)' vs. '@selector( foo )'.
|
|
# Also applies to '@protocol()' constructs.
|
|
sp_inside_oc_at_sel_parens = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space before a block pointer caret,
|
|
# i.e. '^int (int arg){...}' vs. ' ^int (int arg){...}'.
|
|
sp_before_oc_block_caret = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after a block pointer caret,
|
|
# i.e. '^int (int arg){...}' vs. '^ int (int arg){...}'.
|
|
sp_after_oc_block_caret = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between the receiver and selector in a message,
|
|
# as in '[receiver selector ...]'.
|
|
sp_after_oc_msg_receiver = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space after '@property'.
|
|
sp_after_oc_property = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove space between '@synchronized' and the open parenthesis,
|
|
# i.e. '@synchronized(foo)' vs. '@synchronized (foo)'.
|
|
sp_after_oc_synchronized = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around the ':' in 'b ? t : f'.
|
|
sp_cond_colon = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the ':' in 'b ? t : f'.
|
|
#
|
|
# Overrides sp_cond_colon.
|
|
sp_cond_colon_before = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the ':' in 'b ? t : f'.
|
|
#
|
|
# Overrides sp_cond_colon.
|
|
sp_cond_colon_after = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space around the '?' in 'b ? t : f'.
|
|
sp_cond_question = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the '?' in 'b ? t : f'.
|
|
#
|
|
# Overrides sp_cond_question.
|
|
sp_cond_question_before = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the '?' in 'b ? t : f'.
|
|
#
|
|
# Overrides sp_cond_question.
|
|
sp_cond_question_after = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# In the abbreviated ternary form '(a ?: b)', add or remove space between '?'
|
|
# and ':'.
|
|
#
|
|
# Overrides all other sp_cond_* options.
|
|
sp_cond_ternary_short = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Fix the spacing between 'case' and the label. Only 'ignore' and 'force' make
|
|
# sense here.
|
|
sp_case_label = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space around the D '..' operator.
|
|
sp_range = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after ':' in a Java/C++11 range-based 'for',
|
|
# as in 'for (Type var : <here> expr)'.
|
|
sp_after_for_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before ':' in a Java/C++11 range-based 'for',
|
|
# as in 'for (Type var <here> : expr)'.
|
|
sp_before_for_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove space between 'extern' and '(' as in 'extern <here> (C)'.
|
|
sp_extern_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the opening of a C++ comment, as in '// <here> A'.
|
|
sp_cmt_cpp_start = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# remove space after the '//' and the pvs command '-V1234',
|
|
# only works with sp_cmt_cpp_start set to add or force.
|
|
sp_cmt_cpp_pvs = false # true/false
|
|
|
|
# remove space after the '//' and the command 'lint',
|
|
# only works with sp_cmt_cpp_start set to add or force.
|
|
sp_cmt_cpp_lint = false # true/false
|
|
|
|
# Add or remove space in a C++ region marker comment, as in '// <here> BEGIN'.
|
|
# A region marker is defined as a comment which is not preceded by other text
|
|
# (i.e. the comment is the first non-whitespace on the line), and which starts
|
|
# with either 'BEGIN' or 'END'.
|
|
#
|
|
# Overrides sp_cmt_cpp_start.
|
|
sp_cmt_cpp_region = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# If true, space added with sp_cmt_cpp_start will be added after Doxygen
|
|
# sequences like '///', '///<', '//!' and '//!<'.
|
|
sp_cmt_cpp_doxygen = false # true/false
|
|
|
|
# If true, space added with sp_cmt_cpp_start will be added after Qt translator
|
|
# or meta-data comments like '//:', '//=', and '//~'.
|
|
sp_cmt_cpp_qttr = false # true/false
|
|
|
|
# Add or remove space between #else or #endif and a trailing comment.
|
|
sp_endif_cmt = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after 'new', 'delete' and 'delete[]'.
|
|
sp_after_new = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between 'new' and '(' in 'new()'.
|
|
sp_between_new_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space between ')' and type in 'new(foo) BAR'.
|
|
sp_after_newop_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space inside parentheses of the new operator
|
|
# as in 'new(foo) BAR'.
|
|
sp_inside_newop_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after the open parenthesis of the new operator,
|
|
# as in 'new(foo) BAR'.
|
|
#
|
|
# Overrides sp_inside_newop_paren.
|
|
sp_inside_newop_paren_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before the close parenthesis of the new operator,
|
|
# as in 'new(foo) BAR'.
|
|
#
|
|
# Overrides sp_inside_newop_paren.
|
|
sp_inside_newop_paren_close = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a trailing comment.
|
|
sp_before_tr_cmt = add # ignore/add/remove/force/not_defined
|
|
|
|
# Number of spaces before a trailing comment.
|
|
sp_num_before_tr_cmt = 2 # unsigned number
|
|
|
|
# Add or remove space before an embedded comment.
|
|
#
|
|
# Default: force
|
|
sp_before_emb_cmt = force # ignore/add/remove/force/not_defined
|
|
|
|
# Number of spaces before an embedded comment.
|
|
#
|
|
# Default: 1
|
|
sp_num_before_emb_cmt = 1 # unsigned number
|
|
|
|
# Add or remove space after an embedded comment.
|
|
#
|
|
# Default: force
|
|
sp_after_emb_cmt = force # ignore/add/remove/force/not_defined
|
|
|
|
# Number of spaces after an embedded comment.
|
|
#
|
|
# Default: 1
|
|
sp_num_after_emb_cmt = 1 # unsigned number
|
|
|
|
# (Java) Add or remove space between an annotation and the open parenthesis.
|
|
sp_annotation_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# If true, vbrace tokens are dropped to the previous token and skipped.
|
|
sp_skip_vbrace_tokens = false # true/false
|
|
|
|
# Add or remove space after 'noexcept'.
|
|
sp_after_noexcept = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after '_'.
|
|
sp_vala_after_translation = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space before a bit colon ':'.
|
|
sp_before_bit_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove space after a bit colon ':'.
|
|
sp_after_bit_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# If true, a <TAB> is inserted after #define.
|
|
force_tab_after_define = false # true/false
|
|
|
|
#
|
|
# Indenting options
|
|
#
|
|
|
|
# The number of columns to indent per level. Usually 2, 3, 4, or 8.
|
|
#
|
|
# Default: 8
|
|
indent_columns = 2 # unsigned number
|
|
|
|
# Whether to ignore indent for the first continuation line. Subsequent
|
|
# continuation lines will still be indented to match the first.
|
|
indent_ignore_first_continue = false # true/false
|
|
|
|
# The continuation indent. If non-zero, this overrides the indent of '(', '['
|
|
# and '=' continuation indents. Negative values are OK; negative value is
|
|
# absolute and not increased for each '(' or '[' level.
|
|
#
|
|
# For FreeBSD, this is set to 4.
|
|
# Requires indent_ignore_first_continue=false.
|
|
indent_continue = 0 # number
|
|
|
|
# The continuation indent, only for class header line(s). If non-zero, this
|
|
# overrides the indent of 'class' continuation indents.
|
|
# Requires indent_ignore_first_continue=false.
|
|
indent_continue_class_head = 0 # unsigned number
|
|
|
|
# Whether to indent empty lines (i.e. lines which contain only spaces before
|
|
# the newline character).
|
|
indent_single_newlines = false # true/false
|
|
|
|
# The continuation indent for func_*_param if they are true. If non-zero, this
|
|
# overrides the indent.
|
|
indent_param = 0 # unsigned number
|
|
|
|
# How to use tabs when indenting code.
|
|
#
|
|
# 0: Spaces only
|
|
# 1: Indent with tabs to brace level, align with spaces (default)
|
|
# 2: Indent and align with tabs, using spaces when not on a tabstop
|
|
#
|
|
# Default: 1
|
|
indent_with_tabs = 0 # unsigned number
|
|
|
|
# Whether to indent comments that are not at a brace level with tabs on a
|
|
# tabstop. Requires indent_with_tabs=2. If false, will use spaces.
|
|
indent_cmt_with_tabs = false # true/false
|
|
|
|
# Whether to indent strings broken by '\' so that they line up.
|
|
indent_align_string = false # true/false
|
|
|
|
# The number of spaces to indent multi-line XML strings.
|
|
# Requires indent_align_string=true.
|
|
indent_xml_string = 0 # unsigned number
|
|
|
|
# Spaces to indent '{' from level.
|
|
indent_brace = 0 # unsigned number
|
|
|
|
# Whether braces are indented to the body level.
|
|
indent_braces = false # true/false
|
|
|
|
# Whether to disable indenting function braces if indent_braces=true.
|
|
indent_braces_no_func = false # true/false
|
|
|
|
# Whether to disable indenting class braces if indent_braces=true.
|
|
indent_braces_no_class = false # true/false
|
|
|
|
# Whether to disable indenting struct braces if indent_braces=true.
|
|
indent_braces_no_struct = false # true/false
|
|
|
|
# Whether to indent based on the size of the brace parent,
|
|
# i.e. 'if' => 3 spaces, 'for' => 4 spaces, etc.
|
|
indent_brace_parent = false # true/false
|
|
|
|
# Whether to indent based on the open parenthesis instead of the open brace
|
|
# in '({\n'.
|
|
indent_paren_open_brace = false # true/false
|
|
|
|
# (C#) Whether to indent the brace of a C# delegate by another level.
|
|
indent_cs_delegate_brace = false # true/false
|
|
|
|
# (C#) Whether to indent a C# delegate (to handle delegates with no brace) by
|
|
# another level.
|
|
indent_cs_delegate_body = false # true/false
|
|
|
|
# Whether to indent the body of a 'namespace'.
|
|
indent_namespace = false # true/false
|
|
|
|
# Whether to indent only the first namespace, and not any nested namespaces.
|
|
# Requires indent_namespace=true.
|
|
indent_namespace_single_indent = false # true/false
|
|
|
|
# The number of spaces to indent a namespace block.
|
|
# If set to zero, use the value indent_columns
|
|
indent_namespace_level = 0 # unsigned number
|
|
|
|
# If the body of the namespace is longer than this number, it won't be
|
|
# indented. Requires indent_namespace=true. 0 means no limit.
|
|
indent_namespace_limit = 0 # unsigned number
|
|
|
|
# Whether to indent only in inner namespaces (nested in other namespaces).
|
|
# Requires indent_namespace=true.
|
|
indent_namespace_inner_only = false # true/false
|
|
|
|
# Whether the 'extern "C"' body is indented.
|
|
indent_extern = false # true/false
|
|
|
|
# Whether the 'class' body is indented.
|
|
indent_class = false # true/false
|
|
|
|
# Whether to ignore indent for the leading base class colon.
|
|
indent_ignore_before_class_colon = true # true/false
|
|
|
|
# Additional indent before the leading base class colon.
|
|
# Negative values decrease indent down to the first column.
|
|
# Requires indent_ignore_before_class_colon=false and a newline break before
|
|
# the colon (see pos_class_colon and nl_class_colon)
|
|
indent_before_class_colon = 0 # number
|
|
|
|
# Whether to indent the stuff after a leading base class colon.
|
|
indent_class_colon = false # true/false
|
|
|
|
# Whether to indent based on a class colon instead of the stuff after the
|
|
# colon. Requires indent_class_colon=true.
|
|
indent_class_on_colon = false # true/false
|
|
|
|
# Whether to ignore indent for a leading class initializer colon.
|
|
indent_ignore_before_constr_colon = false # true/false
|
|
|
|
# Whether to indent the stuff after a leading class initializer colon.
|
|
indent_constr_colon = false # true/false
|
|
|
|
# Virtual indent from the ':' for leading member initializers.
|
|
#
|
|
# Default: 2
|
|
indent_ctor_init_leading = 2 # unsigned number
|
|
|
|
# Virtual indent from the ':' for following member initializers.
|
|
#
|
|
# Default: 2
|
|
indent_ctor_init_following = 2 # unsigned number
|
|
|
|
# Additional indent for constructor initializer list.
|
|
# Negative values decrease indent down to the first column.
|
|
indent_ctor_init = 0 # number
|
|
|
|
# Whether to indent 'if' following 'else' as a new block under the 'else'.
|
|
# If false, 'else\nif' is treated as 'else if' for indenting purposes.
|
|
indent_else_if = false # true/false
|
|
|
|
# Amount to indent variable declarations after a open brace.
|
|
#
|
|
# <0: Relative
|
|
# >=0: Absolute
|
|
indent_var_def_blk = 0 # number
|
|
|
|
# Whether to indent continued variable declarations instead of aligning.
|
|
indent_var_def_cont = false # true/false
|
|
|
|
# How to indent continued shift expressions ('<<' and '>>').
|
|
# Set align_left_shift=false when using this.
|
|
# 0: Align shift operators instead of indenting them (default)
|
|
# 1: Indent by one level
|
|
# -1: Preserve original indentation
|
|
indent_shift = 0 # number
|
|
|
|
# Whether to force indentation of function definitions to start in column 1.
|
|
indent_func_def_force_col1 = false # true/false
|
|
|
|
# Whether to indent continued function call parameters one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_func_call_param = false # true/false
|
|
|
|
# Whether to indent continued function definition parameters one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_func_def_param = false # true/false
|
|
|
|
# for function definitions, only if indent_func_def_param is false
|
|
# Allows to align params when appropriate and indent them when not
|
|
# behave as if it was true if paren position is more than this value
|
|
# if paren position is more than the option value
|
|
indent_func_def_param_paren_pos_threshold = 0 # unsigned number
|
|
|
|
# Whether to indent continued function call prototype one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_func_proto_param = false # true/false
|
|
|
|
# Whether to indent continued function call declaration one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_func_class_param = false # true/false
|
|
|
|
# Whether to indent continued class variable constructors one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_func_ctor_var_param = false # true/false
|
|
|
|
# Whether to indent continued template parameter list one indent level,
|
|
# rather than aligning parameters under the open parenthesis.
|
|
indent_template_param = false # true/false
|
|
|
|
# Double the indent for indent_func_xxx_param options.
|
|
# Use both values of the options indent_columns and indent_param.
|
|
indent_func_param_double = false # true/false
|
|
|
|
# Indentation column for standalone 'const' qualifier on a function
|
|
# prototype.
|
|
indent_func_const = 0 # unsigned number
|
|
|
|
# Indentation column for standalone 'throw' qualifier on a function
|
|
# prototype.
|
|
indent_func_throw = 0 # unsigned number
|
|
|
|
# How to indent within a macro followed by a brace on the same line
|
|
# This allows reducing the indent in macros that have (for example)
|
|
# `do { ... } while (0)` blocks bracketing them.
|
|
#
|
|
# true: add an indent for the brace on the same line as the macro
|
|
# false: do not add an indent for the brace on the same line as the macro
|
|
#
|
|
# Default: true
|
|
indent_macro_brace = false # true/false
|
|
|
|
# The number of spaces to indent a continued '->' or '.'.
|
|
# Usually set to 0, 1, or indent_columns.
|
|
indent_member = 0 # unsigned number
|
|
|
|
# Whether lines broken at '.' or '->' should be indented by a single indent.
|
|
# The indent_member option will not be effective if this is set to true.
|
|
indent_member_single = false # true/false
|
|
|
|
# Spaces to indent single line ('//') comments on lines before code.
|
|
indent_single_line_comments_before = 0 # unsigned number
|
|
|
|
# Spaces to indent single line ('//') comments on lines after code.
|
|
indent_single_line_comments_after = 0 # unsigned number
|
|
|
|
# When opening a paren for a control statement (if, for, while, etc), increase
|
|
# the indent level by this value. Negative values decrease the indent level.
|
|
indent_sparen_extra = 0 # number
|
|
|
|
# Whether to indent trailing single line ('//') comments relative to the code
|
|
# instead of trying to keep the same absolute column.
|
|
indent_relative_single_line_comments = true # true/false
|
|
|
|
# Spaces to indent 'case' from 'switch'. Usually 0 or indent_columns.
|
|
# It might be wise to choose the same value for the option indent_case_brace.
|
|
indent_switch_case = 0 # unsigned number
|
|
|
|
# Spaces to indent the body of a 'switch' before any 'case'.
|
|
# Usually the same as indent_columns or indent_switch_case.
|
|
indent_switch_body = 0 # unsigned number
|
|
|
|
# Whether to ignore indent for '{' following 'case'.
|
|
indent_ignore_case_brace = false # true/false
|
|
|
|
# Spaces to indent '{' from 'case'. By default, the brace will appear under
|
|
# the 'c' in case. Usually set to 0 or indent_columns. Negative values are OK.
|
|
# It might be wise to choose the same value for the option indent_switch_case.
|
|
indent_case_brace = 0 # number
|
|
|
|
# indent 'break' with 'case' from 'switch'.
|
|
indent_switch_break_with_case = false # true/false
|
|
|
|
# Whether to indent preprocessor statements inside of switch statements.
|
|
#
|
|
# Default: true
|
|
indent_switch_pp = true # true/false
|
|
|
|
# Spaces to shift the 'case' line, without affecting any other lines.
|
|
# Usually 0.
|
|
indent_case_shift = 0 # unsigned number
|
|
|
|
# Whether to align comments before 'case' with the 'case'.
|
|
#
|
|
# Default: true
|
|
indent_case_comment = true # true/false
|
|
|
|
# Whether to indent comments not found in first column.
|
|
#
|
|
# Default: true
|
|
indent_comment = true # true/false
|
|
|
|
# Whether to indent comments found in first column.
|
|
indent_col1_comment = false # true/false
|
|
|
|
# Whether to indent multi string literal in first column.
|
|
indent_col1_multi_string_literal = false # true/false
|
|
|
|
# Align comments on adjacent lines that are this many columns apart or less.
|
|
#
|
|
# Default: 3
|
|
indent_comment_align_thresh = 3 # unsigned number
|
|
|
|
# Whether to ignore indent for goto labels.
|
|
indent_ignore_label = true # true/false
|
|
|
|
# How to indent goto labels. Requires indent_ignore_label=false.
|
|
#
|
|
# >0: Absolute column where 1 is the leftmost column
|
|
# <=0: Subtract from brace indent
|
|
#
|
|
# Default: 1
|
|
indent_label = 1 # number
|
|
|
|
# How to indent access specifiers that are followed by a
|
|
# colon.
|
|
#
|
|
# >0: Absolute column where 1 is the leftmost column
|
|
# <=0: Subtract from brace indent
|
|
#
|
|
# Default: 1
|
|
indent_access_spec = 1 # number
|
|
|
|
# Whether to indent the code after an access specifier by one level.
|
|
# If true, this option forces 'indent_access_spec=0'.
|
|
indent_access_spec_body = false # true/false
|
|
|
|
# If an open parenthesis is followed by a newline, whether to indent the next
|
|
# line so that it lines up after the open parenthesis (not recommended).
|
|
indent_paren_nl = false # true/false
|
|
|
|
# How to indent a close parenthesis after a newline.
|
|
#
|
|
# 0: Indent to body level (default)
|
|
# 1: Align under the open parenthesis
|
|
# 2: Indent to the brace level
|
|
# -1: Preserve original indentation
|
|
indent_paren_close = 0 # number
|
|
|
|
# Whether to indent the open parenthesis of a function definition,
|
|
# if the parenthesis is on its own line.
|
|
indent_paren_after_func_def = false # true/false
|
|
|
|
# Whether to indent the open parenthesis of a function declaration,
|
|
# if the parenthesis is on its own line.
|
|
indent_paren_after_func_decl = false # true/false
|
|
|
|
# Whether to indent the open parenthesis of a function call,
|
|
# if the parenthesis is on its own line.
|
|
indent_paren_after_func_call = true # true/false
|
|
|
|
# How to indent a comma when inside braces.
|
|
# 0: Indent by one level (default)
|
|
# 1: Align under the open brace
|
|
# -1: Preserve original indentation
|
|
indent_comma_brace = 0 # number
|
|
|
|
# How to indent a comma when inside parentheses.
|
|
# 0: Indent by one level (default)
|
|
# 1: Align under the open parenthesis
|
|
# -1: Preserve original indentation
|
|
indent_comma_paren = 0 # number
|
|
|
|
# How to indent a Boolean operator when inside parentheses.
|
|
# 0: Indent by one level (default)
|
|
# 1: Align under the open parenthesis
|
|
# -1: Preserve original indentation
|
|
indent_bool_paren = 0 # number
|
|
|
|
# Whether to ignore the indentation of a Boolean operator when outside
|
|
# parentheses.
|
|
indent_ignore_bool = false # true/false
|
|
|
|
# Whether to ignore the indentation of an arithmetic operator.
|
|
indent_ignore_arith = false # true/false
|
|
|
|
# Whether to indent a semicolon when inside a for parenthesis.
|
|
# If true, aligns under the open for parenthesis.
|
|
indent_semicolon_for_paren = false # true/false
|
|
|
|
# Whether to ignore the indentation of a semicolon outside of a 'for'
|
|
# statement.
|
|
indent_ignore_semicolon = false # true/false
|
|
|
|
# Whether to align the first expression to following ones
|
|
# if indent_bool_paren=1.
|
|
indent_first_bool_expr = false # true/false
|
|
|
|
# Whether to align the first expression to following ones
|
|
# if indent_semicolon_for_paren=true.
|
|
indent_first_for_expr = false # true/false
|
|
|
|
# If an open square is followed by a newline, whether to indent the next line
|
|
# so that it lines up after the open square (not recommended).
|
|
indent_square_nl = false # true/false
|
|
|
|
# (ESQL/C) Whether to preserve the relative indent of 'EXEC SQL' bodies.
|
|
indent_preserve_sql = false # true/false
|
|
|
|
# Whether to ignore the indentation of an assignment operator.
|
|
indent_ignore_assign = false # true/false
|
|
|
|
# Whether to align continued statements at the '='. If false or if the '=' is
|
|
# followed by a newline, the next line is indent one tab.
|
|
#
|
|
# Default: true
|
|
indent_align_assign = true # true/false
|
|
|
|
# If true, the indentation of the chunks after a '=' sequence will be set at
|
|
# LHS token indentation column before '='.
|
|
indent_off_after_assign = false # true/false
|
|
|
|
# Whether to align continued statements at the '('. If false or the '(' is
|
|
# followed by a newline, the next line indent is one tab.
|
|
#
|
|
# Default: true
|
|
indent_align_paren = true # true/false
|
|
|
|
# (OC) Whether to indent Objective-C code inside message selectors.
|
|
indent_oc_inside_msg_sel = false # true/false
|
|
|
|
# (OC) Whether to indent Objective-C blocks at brace level instead of usual
|
|
# rules.
|
|
indent_oc_block = false # true/false
|
|
|
|
# (OC) Indent for Objective-C blocks in a message relative to the parameter
|
|
# name.
|
|
#
|
|
# =0: Use indent_oc_block rules
|
|
# >0: Use specified number of spaces to indent
|
|
indent_oc_block_msg = 0 # unsigned number
|
|
|
|
# (OC) Minimum indent for subsequent parameters
|
|
indent_oc_msg_colon = 0 # unsigned number
|
|
|
|
# (OC) Whether to prioritize aligning with initial colon (and stripping spaces
|
|
# from lines, if necessary).
|
|
#
|
|
# Default: true
|
|
indent_oc_msg_prioritize_first_colon = true # true/false
|
|
|
|
# (OC) Whether to indent blocks the way that Xcode does by default
|
|
# (from the keyword if the parameter is on its own line; otherwise, from the
|
|
# previous indentation level). Requires indent_oc_block_msg=true.
|
|
indent_oc_block_msg_xcode_style = false # true/false
|
|
|
|
# (OC) Whether to indent blocks from where the brace is, relative to a
|
|
# message keyword. Requires indent_oc_block_msg=true.
|
|
indent_oc_block_msg_from_keyword = false # true/false
|
|
|
|
# (OC) Whether to indent blocks from where the brace is, relative to a message
|
|
# colon. Requires indent_oc_block_msg=true.
|
|
indent_oc_block_msg_from_colon = false # true/false
|
|
|
|
# (OC) Whether to indent blocks from where the block caret is.
|
|
# Requires indent_oc_block_msg=true.
|
|
indent_oc_block_msg_from_caret = false # true/false
|
|
|
|
# (OC) Whether to indent blocks from where the brace caret is.
|
|
# Requires indent_oc_block_msg=true.
|
|
indent_oc_block_msg_from_brace = false # true/false
|
|
|
|
# When indenting after virtual brace open and newline add further spaces to
|
|
# reach this minimum indent.
|
|
indent_min_vbrace_open = 0 # unsigned number
|
|
|
|
# Whether to add further spaces after regular indent to reach next tabstop
|
|
# when indenting after virtual brace open and newline.
|
|
indent_vbrace_open_on_tabstop = false # true/false
|
|
|
|
# How to indent after a brace followed by another token (not a newline).
|
|
# true: indent all contained lines to match the token
|
|
# false: indent all contained lines to match the brace
|
|
#
|
|
# Default: true
|
|
indent_token_after_brace = true # true/false
|
|
|
|
# Whether to indent the body of a C++11 lambda.
|
|
indent_cpp_lambda_body = false # true/false
|
|
|
|
# How to indent compound literals that are being returned.
|
|
# true: add both the indent from return & the compound literal open brace
|
|
# (i.e. 2 indent levels)
|
|
# false: only indent 1 level, don't add the indent for the open brace, only
|
|
# add the indent for the return.
|
|
#
|
|
# Default: true
|
|
indent_compound_literal_return = false # true/false
|
|
|
|
# (C#) Whether to indent a 'using' block if no braces are used.
|
|
#
|
|
# Default: true
|
|
indent_using_block = true # true/false
|
|
|
|
# How to indent the continuation of ternary operator.
|
|
#
|
|
# 0: Off (default)
|
|
# 1: When the `if_false` is a continuation, indent it under the `if_true` branch
|
|
# 2: When the `:` is a continuation, indent it under `?`
|
|
indent_ternary_operator = 2 # unsigned number
|
|
|
|
# Whether to indent the statements inside ternary operator.
|
|
indent_inside_ternary_operator = false # true/false
|
|
|
|
# If true, the indentation of the chunks after a `return` sequence will be set at return indentation column.
|
|
indent_off_after_return = false # true/false
|
|
|
|
# If true, the indentation of the chunks after a `return new` sequence will be set at return indentation column.
|
|
indent_off_after_return_new = false # true/false
|
|
|
|
# If true, the tokens after return are indented with regular single indentation. By default (false) the indentation is after the return token.
|
|
indent_single_after_return = false # true/false
|
|
|
|
# Whether to ignore indent and alignment for 'asm' blocks (i.e. assume they
|
|
# have their own indentation).
|
|
indent_ignore_asm_block = false # true/false
|
|
|
|
# Don't indent the close parenthesis of a function definition,
|
|
# if the parenthesis is on its own line.
|
|
donot_indent_func_def_close_paren = false # true/false
|
|
|
|
#
|
|
# Newline adding and removing options
|
|
#
|
|
|
|
# Whether to collapse empty blocks between '{' and '}' except for functions.
|
|
# Use nl_collapse_empty_body_functions to specify how empty function braces
|
|
# should be formatted.
|
|
nl_collapse_empty_body = true # true/false
|
|
|
|
# Whether to collapse empty blocks between '{' and '}' for functions only.
|
|
# If true, overrides nl_inside_empty_func.
|
|
nl_collapse_empty_body_functions = false # true/false
|
|
|
|
# Don't split one-line braced assignments, as in 'foo_t f = { 1, 2 };'.
|
|
nl_assign_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line braced statements inside a 'class xx { }' body.
|
|
nl_class_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line enums, as in 'enum foo { BAR = 15 };'
|
|
nl_enum_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line get or set functions.
|
|
nl_getset_leave_one_liners = false # true/false
|
|
|
|
# (C#) Don't split one-line property get or set functions.
|
|
nl_cs_property_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line function definitions, as in 'int foo() { return 0; }'.
|
|
# might modify nl_func_type_name
|
|
nl_func_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line C++11 lambdas, as in '[]() { return 0; }'.
|
|
nl_cpp_lambda_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line if/else statements, as in 'if(...) b++;'.
|
|
nl_if_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line while statements, as in 'while(...) b++;'.
|
|
nl_while_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line do statements, as in 'do { b++; } while(...);'.
|
|
nl_do_leave_one_liners = false # true/false
|
|
|
|
# Don't split one-line for statements, as in 'for(...) b++;'.
|
|
nl_for_leave_one_liners = false # true/false
|
|
|
|
# (OC) Don't split one-line Objective-C messages.
|
|
nl_oc_msg_leave_one_liner = false # true/false
|
|
|
|
# (OC) Add or remove newline between method declaration and '{'.
|
|
nl_oc_mdef_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove newline between Objective-C block signature and '{'.
|
|
nl_oc_block_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove blank line before '@interface' statement.
|
|
nl_oc_before_interface = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove blank line before '@implementation' statement.
|
|
nl_oc_before_implementation = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove blank line before '@end' statement.
|
|
nl_oc_before_end = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove newline between '@interface' and '{'.
|
|
nl_oc_interface_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove newline between '@implementation' and '{'.
|
|
nl_oc_implementation_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newlines at the start of the file.
|
|
nl_start_of_file = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# The minimum number of newlines at the start of the file (only used if
|
|
# nl_start_of_file is 'add' or 'force').
|
|
nl_start_of_file_min = 0 # unsigned number
|
|
|
|
# Add or remove newline at the end of the file.
|
|
nl_end_of_file = force # ignore/add/remove/force/not_defined
|
|
|
|
# The minimum number of newlines at the end of the file (only used if
|
|
# nl_end_of_file is 'add' or 'force').
|
|
nl_end_of_file_min = 1 # unsigned number
|
|
|
|
# Add or remove newline between '=' and '{'.
|
|
nl_assign_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove newline between '=' and '['.
|
|
nl_assign_square = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '[]' and '{'.
|
|
nl_tsquare_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove newline after '= ['. Will also affect the newline before
|
|
# the ']'.
|
|
nl_after_square_assign = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between a function call's ')' and '{', as in
|
|
# 'list_for_each(item, &list) { }'.
|
|
nl_fcall_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'enum' and '{'.
|
|
nl_enum_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'enum' and 'class'.
|
|
nl_enum_class = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'enum class' and the identifier.
|
|
nl_enum_class_identifier = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'enum class' type and ':'.
|
|
nl_enum_identifier_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'enum class identifier :' and type.
|
|
nl_enum_colon_type = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'struct and '{'.
|
|
nl_struct_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'union' and '{'.
|
|
nl_union_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'if' and '{'.
|
|
nl_if_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and 'else'.
|
|
nl_brace_else = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'else if' and '{'. If set to ignore,
|
|
# nl_if_brace is used instead.
|
|
nl_elseif_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'else' and '{'.
|
|
nl_else_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'else' and 'if'.
|
|
nl_else_if = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before '{' opening brace
|
|
nl_before_opening_brace_func_class_def = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before 'if'/'else if' closing parenthesis.
|
|
nl_before_if_closing_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and 'finally'.
|
|
nl_brace_finally = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'finally' and '{'.
|
|
nl_finally_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'try' and '{'.
|
|
nl_try_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between get/set and '{'.
|
|
nl_getset_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'for' and '{'.
|
|
nl_for_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before the '{' of a 'catch' statement, as in
|
|
# 'catch (decl) <here> {'.
|
|
nl_catch_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove newline before the '{' of a '@catch' statement, as in
|
|
# '@catch (decl) <here> {'. If set to ignore, nl_catch_brace is used.
|
|
nl_oc_catch_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and 'catch'.
|
|
nl_brace_catch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (OC) Add or remove newline between '}' and '@catch'. If set to ignore,
|
|
# nl_brace_catch is used.
|
|
nl_oc_brace_catch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and ']'.
|
|
nl_brace_square = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and ')' in a function invocation.
|
|
nl_brace_fparen = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'while' and '{'.
|
|
nl_while_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove newline between 'scope (x)' and '{'.
|
|
nl_scope_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove newline between 'unittest' and '{'.
|
|
nl_unittest_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (D) Add or remove newline between 'version (x)' and '{'.
|
|
nl_version_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (C#) Add or remove newline between 'using' and '{'.
|
|
nl_using_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between two open or close braces. Due to general
|
|
# newline/brace handling, REMOVE may not work.
|
|
nl_brace_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'do' and '{'.
|
|
nl_do_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '}' and 'while' of 'do' statement.
|
|
nl_brace_while = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'switch' and '{'.
|
|
nl_switch_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'synchronized' and '{'.
|
|
nl_synchronized_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add a newline between ')' and '{' if the ')' is on a different line than the
|
|
# if/for/etc.
|
|
#
|
|
# Overrides nl_for_brace, nl_if_brace, nl_switch_brace, nl_while_switch and
|
|
# nl_catch_brace.
|
|
nl_multi_line_cond = false # true/false
|
|
|
|
# Add a newline after '(' if an if/for/while/switch condition spans multiple
|
|
# lines
|
|
nl_multi_line_sparen_open = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add a newline before ')' if an if/for/while/switch condition spans multiple
|
|
# lines. Overrides nl_before_if_closing_paren if both are specified.
|
|
nl_multi_line_sparen_close = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Force a newline in a define after the macro name for multi-line defines.
|
|
nl_multi_line_define = false # true/false
|
|
|
|
# Whether to add a newline before 'case', and a blank line before a 'case'
|
|
# statement that follows a ';' or '}'.
|
|
nl_before_case = false # true/false
|
|
|
|
# Whether to add a newline after a 'case' statement.
|
|
nl_after_case = true # true/false
|
|
|
|
# Add or remove newline between a case ':' and '{'.
|
|
#
|
|
# Overrides nl_after_case.
|
|
nl_case_colon_brace = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between ')' and 'throw'.
|
|
nl_before_throw = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'namespace' and '{'.
|
|
nl_namespace_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template class.
|
|
nl_template_class = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template class declaration.
|
|
#
|
|
# Overrides nl_template_class.
|
|
nl_template_class_decl = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<>' of a specialized class declaration.
|
|
#
|
|
# Overrides nl_template_class_decl.
|
|
nl_template_class_decl_special = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template class definition.
|
|
#
|
|
# Overrides nl_template_class.
|
|
nl_template_class_def = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<>' of a specialized class definition.
|
|
#
|
|
# Overrides nl_template_class_def.
|
|
nl_template_class_def_special = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template function.
|
|
nl_template_func = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template function
|
|
# declaration.
|
|
#
|
|
# Overrides nl_template_func.
|
|
nl_template_func_decl = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<>' of a specialized function
|
|
# declaration.
|
|
#
|
|
# Overrides nl_template_func_decl.
|
|
nl_template_func_decl_special = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template function
|
|
# definition.
|
|
#
|
|
# Overrides nl_template_func.
|
|
nl_template_func_def = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<>' of a specialized function
|
|
# definition.
|
|
#
|
|
# Overrides nl_template_func_def.
|
|
nl_template_func_def_special = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after 'template<...>' of a template variable.
|
|
nl_template_var = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'template<...>' and 'using' of a templated
|
|
# type alias.
|
|
nl_template_using = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'class' and '{'.
|
|
nl_class_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before or after (depending on pos_class_comma,
|
|
# may not be IGNORE) each',' in the base class list.
|
|
nl_class_init_args = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after each ',' in the constructor member
|
|
# initialization. Related to nl_constr_colon, pos_constr_colon and
|
|
# pos_constr_comma.
|
|
nl_constr_init_args = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before first element, after comma, and after last
|
|
# element, in 'enum'.
|
|
nl_enum_own_lines = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between return type and function name in a function
|
|
# definition.
|
|
# might be modified by nl_func_leave_one_liners
|
|
nl_func_type_name = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between return type and function name inside a class
|
|
# definition. If set to ignore, nl_func_type_name or nl_func_proto_type_name
|
|
# is used instead.
|
|
nl_func_type_name_class = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between class specification and '::'
|
|
# in 'void A::f() { }'. Only appears in separate member implementation (does
|
|
# not appear with in-line implementation).
|
|
nl_func_class_scope = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between function scope and name, as in
|
|
# 'void A :: <here> f() { }'.
|
|
nl_func_scope_name = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between return type and function name in a prototype.
|
|
nl_func_proto_type_name = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between a function name and the opening '(' in the
|
|
# declaration.
|
|
nl_func_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_paren for functions with no parameters.
|
|
nl_func_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between a function name and the opening '(' in the
|
|
# definition.
|
|
nl_func_def_paren = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_def_paren for functions with no parameters.
|
|
nl_func_def_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between a function name and the opening '(' in the
|
|
# call.
|
|
nl_func_call_paren = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_call_paren for functions with no parameters.
|
|
nl_func_call_paren_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after '(' in a function declaration.
|
|
nl_func_decl_start = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after '(' in a function definition.
|
|
nl_func_def_start = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_decl_start when there is only one parameter.
|
|
nl_func_decl_start_single = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_def_start when there is only one parameter.
|
|
nl_func_def_start_single = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after '(' in a function declaration if '(' and ')'
|
|
# are in different lines. If false, nl_func_decl_start is used instead.
|
|
nl_func_decl_start_multi_line = false # true/false
|
|
|
|
# Whether to add a newline after '(' in a function definition if '(' and ')'
|
|
# are in different lines. If false, nl_func_def_start is used instead.
|
|
nl_func_def_start_multi_line = false # true/false
|
|
|
|
# Add or remove newline after each ',' in a function declaration.
|
|
nl_func_decl_args = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after each ',' in a function definition.
|
|
nl_func_def_args = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline after each ',' in a function call.
|
|
nl_func_call_args = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after each ',' in a function declaration if '('
|
|
# and ')' are in different lines. If false, nl_func_decl_args is used instead.
|
|
nl_func_decl_args_multi_line = false # true/false
|
|
|
|
# Whether to add a newline after each ',' in a function definition if '('
|
|
# and ')' are in different lines. If false, nl_func_def_args is used instead.
|
|
nl_func_def_args_multi_line = false # true/false
|
|
|
|
# Add or remove newline before the ')' in a function declaration.
|
|
nl_func_decl_end = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline before the ')' in a function definition.
|
|
nl_func_def_end = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_decl_end when there is only one parameter.
|
|
nl_func_decl_end_single = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Overrides nl_func_def_end when there is only one parameter.
|
|
nl_func_def_end_single = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline before ')' in a function declaration if '(' and ')'
|
|
# are in different lines. If false, nl_func_decl_end is used instead.
|
|
nl_func_decl_end_multi_line = false # true/false
|
|
|
|
# Whether to add a newline before ')' in a function definition if '(' and ')'
|
|
# are in different lines. If false, nl_func_def_end is used instead.
|
|
nl_func_def_end_multi_line = false # true/false
|
|
|
|
# Add or remove newline between '()' in a function declaration.
|
|
nl_func_decl_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '()' in a function definition.
|
|
nl_func_def_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between '()' in a function call.
|
|
nl_func_call_empty = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after '(' in a function call,
|
|
# has preference over nl_func_call_start_multi_line.
|
|
nl_func_call_start = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline before ')' in a function call.
|
|
nl_func_call_end = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after '(' in a function call if '(' and ')' are in
|
|
# different lines.
|
|
nl_func_call_start_multi_line = false # true/false
|
|
|
|
# Whether to add a newline after each ',' in a function call if '(' and ')'
|
|
# are in different lines.
|
|
nl_func_call_args_multi_line = false # true/false
|
|
|
|
# Whether to add a newline before ')' in a function call if '(' and ')' are in
|
|
# different lines.
|
|
nl_func_call_end_multi_line = false # true/false
|
|
|
|
# Whether to respect nl_func_call_XXX option in case of closure args.
|
|
nl_func_call_args_multi_line_ignore_closures = false # true/false
|
|
|
|
# Whether to add a newline after '<' of a template parameter list.
|
|
nl_template_start = false # true/false
|
|
|
|
# Whether to add a newline after each ',' in a template parameter list.
|
|
nl_template_args = false # true/false
|
|
|
|
# Whether to add a newline before '>' of a template parameter list.
|
|
nl_template_end = false # true/false
|
|
|
|
# (OC) Whether to put each Objective-C message parameter on a separate line.
|
|
# See nl_oc_msg_leave_one_liner.
|
|
nl_oc_msg_args = false # true/false
|
|
|
|
# (OC) Minimum number of Objective-C message parameters before applying nl_oc_msg_args.
|
|
nl_oc_msg_args_min_params = 0 # unsigned number
|
|
|
|
# (OC) Max code width of Objective-C message before applying nl_oc_msg_args.
|
|
nl_oc_msg_args_max_code_width = 0 # unsigned number
|
|
|
|
# Add or remove newline between function signature and '{'.
|
|
nl_fdef_brace = force # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between function signature and '{',
|
|
# if signature ends with ')'. Overrides nl_fdef_brace.
|
|
nl_fdef_brace_cond = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between C++11 lambda signature and '{'.
|
|
nl_cpp_ldef_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'return' and the return expression.
|
|
nl_return_expr = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline between 'throw' and the throw expression.
|
|
nl_throw_expr = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after semicolons, except in 'for' statements.
|
|
nl_after_semicolon = false # true/false
|
|
|
|
# (Java) Add or remove newline between the ')' and '{{' of the double brace
|
|
# initializer.
|
|
nl_paren_dbrace_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after the type in an unnamed temporary
|
|
# direct-list-initialization, better:
|
|
# before a direct-list-initialization.
|
|
nl_type_brace_init_lst = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline after the open brace in an unnamed temporary
|
|
# direct-list-initialization.
|
|
nl_type_brace_init_lst_open = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline before the close brace in an unnamed temporary
|
|
# direct-list-initialization.
|
|
nl_type_brace_init_lst_close = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to add a newline before '{'.
|
|
nl_before_brace_open = false # true/false
|
|
|
|
# Whether to add a newline after '{'.
|
|
nl_after_brace_open = false # true/false
|
|
|
|
# Whether to add a newline between the open brace and a trailing single-line
|
|
# comment. Requires nl_after_brace_open=true.
|
|
nl_after_brace_open_cmt = false # true/false
|
|
|
|
# Whether to add a newline after a virtual brace open with a non-empty body.
|
|
# These occur in un-braced if/while/do/for statement bodies.
|
|
nl_after_vbrace_open = false # true/false
|
|
|
|
# Whether to add a newline after a virtual brace open with an empty body.
|
|
# These occur in un-braced if/while/do/for statement bodies.
|
|
nl_after_vbrace_open_empty = false # true/false
|
|
|
|
# Whether to add a newline after '}'. Does not apply if followed by a
|
|
# necessary ';'.
|
|
nl_after_brace_close = false # true/false
|
|
|
|
# Whether to add a newline after a virtual brace close,
|
|
# as in 'if (foo) a++; <here> return;'.
|
|
nl_after_vbrace_close = false # true/false
|
|
|
|
# Add or remove newline between the close brace and identifier,
|
|
# as in 'struct { int a; } <here> b;'. Affects enumerations, unions and
|
|
# structures. If set to ignore, uses nl_after_brace_close.
|
|
nl_brace_struct_var = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to alter newlines in '#define' macros.
|
|
nl_define_macro = false # true/false
|
|
|
|
# Whether to alter newlines between consecutive parenthesis closes. The number
|
|
# of closing parentheses in a line will depend on respective open parenthesis
|
|
# lines.
|
|
nl_squeeze_paren_close = true # true/false
|
|
|
|
# Whether to remove blanks after '#ifxx' and '#elxx', or before '#elxx' and
|
|
# '#endif'. Does not affect top-level #ifdefs.
|
|
nl_squeeze_ifdef = false # true/false
|
|
|
|
# Makes the nl_squeeze_ifdef option affect the top-level #ifdefs as well.
|
|
nl_squeeze_ifdef_top_level = false # true/false
|
|
|
|
# Add or remove blank line before 'if'.
|
|
nl_before_if = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'if' statement. Add/Force work only if the
|
|
# next token is not a closing brace.
|
|
nl_after_if = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line before 'for'.
|
|
nl_before_for = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'for' statement.
|
|
nl_after_for = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line before 'while'.
|
|
nl_before_while = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'while' statement.
|
|
nl_after_while = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line before 'switch'.
|
|
nl_before_switch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'switch' statement.
|
|
nl_after_switch = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line before 'synchronized'.
|
|
nl_before_synchronized = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'synchronized' statement.
|
|
nl_after_synchronized = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line before 'do'.
|
|
nl_before_do = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove blank line after 'do/while' statement.
|
|
nl_after_do = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Ignore nl_before_{if,for,switch,do,synchronized} if the control
|
|
# statement is immediately after a case statement.
|
|
# if nl_before_{if,for,switch,do} is set to remove, this option
|
|
# does nothing.
|
|
nl_before_ignore_after_case = false # true/false
|
|
|
|
# Whether to put a blank line before 'return' statements, unless after an open
|
|
# brace.
|
|
nl_before_return = false # true/false
|
|
|
|
# Whether to put a blank line after 'return' statements, unless followed by a
|
|
# close brace.
|
|
nl_after_return = false # true/false
|
|
|
|
# Whether to put a blank line before a member '.' or '->' operators.
|
|
nl_before_member = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (Java) Whether to put a blank line after a member '.' or '->' operators.
|
|
nl_after_member = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to double-space commented-entries in 'struct'/'union'/'enum'.
|
|
nl_ds_struct_enum_cmt = false # true/false
|
|
|
|
# Whether to force a newline before '}' of a 'struct'/'union'/'enum'.
|
|
# (Lower priority than eat_blanks_before_close_brace.)
|
|
nl_ds_struct_enum_close_brace = false # true/false
|
|
|
|
# Add or remove newline before or after (depending on pos_class_colon) a class
|
|
# colon, as in 'class Foo <here> : <or here> public Bar'.
|
|
nl_class_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove newline around a class constructor colon. The exact position
|
|
# depends on nl_constr_init_args, pos_constr_colon and pos_constr_comma.
|
|
nl_constr_colon = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to collapse a two-line namespace, like 'namespace foo\n{ decl; }'
|
|
# into a single line. If true, prevents other brace newline rules from turning
|
|
# such code into four lines. If true, it also preserves one-liner namespaces.
|
|
nl_namespace_two_to_one_liner = false # true/false
|
|
|
|
# Whether to remove a newline in simple unbraced if statements, turning them
|
|
# into one-liners, as in 'if(b)\n i++;' => 'if(b) i++;'.
|
|
nl_create_if_one_liner = false # true/false
|
|
|
|
# Whether to remove a newline in simple unbraced for statements, turning them
|
|
# into one-liners, as in 'for (...)\n stmt;' => 'for (...) stmt;'.
|
|
nl_create_for_one_liner = false # true/false
|
|
|
|
# Whether to remove a newline in simple unbraced while statements, turning
|
|
# them into one-liners, as in 'while (expr)\n stmt;' => 'while (expr) stmt;'.
|
|
nl_create_while_one_liner = false # true/false
|
|
|
|
# Whether to collapse a function definition whose body (not counting braces)
|
|
# is only one line so that the entire definition (prototype, braces, body) is
|
|
# a single line.
|
|
nl_create_func_def_one_liner = false # true/false
|
|
|
|
# Whether to split one-line simple list definitions into three lines by
|
|
# adding newlines, as in 'int a[12] = { <here> 0 <here> };'.
|
|
nl_create_list_one_liner = false # true/false
|
|
|
|
# Whether to split one-line simple unbraced if statements into two lines by
|
|
# adding a newline, as in 'if(b) <here> i++;'.
|
|
nl_split_if_one_liner = false # true/false
|
|
|
|
# Whether to split one-line simple unbraced for statements into two lines by
|
|
# adding a newline, as in 'for (...) <here> stmt;'.
|
|
nl_split_for_one_liner = false # true/false
|
|
|
|
# Whether to split one-line simple unbraced while statements into two lines by
|
|
# adding a newline, as in 'while (expr) <here> stmt;'.
|
|
nl_split_while_one_liner = false # true/false
|
|
|
|
# Don't add a newline before a cpp-comment in a parameter list of a function
|
|
# call.
|
|
donot_add_nl_before_cpp_comment = false # true/false
|
|
|
|
#
|
|
# Blank line options
|
|
#
|
|
|
|
# The maximum number of consecutive newlines (3 = 2 blank lines).
|
|
nl_max = 2 # unsigned number
|
|
|
|
# The maximum number of consecutive newlines in a function.
|
|
nl_max_blank_in_func = 0 # unsigned number
|
|
|
|
# The number of newlines inside an empty function body.
|
|
# This option overrides eat_blanks_after_open_brace and
|
|
# eat_blanks_before_close_brace, but is ignored when
|
|
# nl_collapse_empty_body_functions=true
|
|
nl_inside_empty_func = 0 # unsigned number
|
|
|
|
# The number of newlines before a function prototype.
|
|
nl_before_func_body_proto = 0 # unsigned number
|
|
|
|
# The number of newlines before a multi-line function definition. Where
|
|
# applicable, this option is overridden with eat_blanks_after_open_brace=true
|
|
nl_before_func_body_def = 0 # unsigned number
|
|
|
|
# The number of newlines before a class constructor/destructor prototype.
|
|
nl_before_func_class_proto = 0 # unsigned number
|
|
|
|
# The number of newlines before a class constructor/destructor definition.
|
|
nl_before_func_class_def = 0 # unsigned number
|
|
|
|
# The number of newlines after a function prototype.
|
|
nl_after_func_proto = 0 # unsigned number
|
|
|
|
# The number of newlines after a function prototype, if not followed by
|
|
# another function prototype.
|
|
nl_after_func_proto_group = 0 # unsigned number
|
|
|
|
# The number of newlines after a class constructor/destructor prototype.
|
|
nl_after_func_class_proto = 0 # unsigned number
|
|
|
|
# The number of newlines after a class constructor/destructor prototype,
|
|
# if not followed by another constructor/destructor prototype.
|
|
nl_after_func_class_proto_group = 0 # unsigned number
|
|
|
|
# Whether one-line method definitions inside a class body should be treated
|
|
# as if they were prototypes for the purposes of adding newlines.
|
|
#
|
|
# Requires nl_class_leave_one_liners=true. Overrides nl_before_func_body_def
|
|
# and nl_before_func_class_def for one-liners.
|
|
nl_class_leave_one_liner_groups = false # true/false
|
|
|
|
# The number of newlines after '}' of a multi-line function body.
|
|
#
|
|
# Overrides nl_min_after_func_body and nl_max_after_func_body.
|
|
nl_after_func_body = 0 # unsigned number
|
|
|
|
# The minimum number of newlines after '}' of a multi-line function body.
|
|
#
|
|
# Only works when nl_after_func_body is 0.
|
|
nl_min_after_func_body = 0 # unsigned number
|
|
|
|
# The maximum number of newlines after '}' of a multi-line function body.
|
|
#
|
|
# Only works when nl_after_func_body is 0.
|
|
# Takes precedence over nl_min_after_func_body.
|
|
nl_max_after_func_body = 0 # unsigned number
|
|
|
|
# The number of newlines after '}' of a multi-line function body in a class
|
|
# declaration. Also affects class constructors/destructors.
|
|
#
|
|
# Overrides nl_after_func_body.
|
|
nl_after_func_body_class = 0 # unsigned number
|
|
|
|
# The number of newlines after '}' of a single line function body. Also
|
|
# affects class constructors/destructors.
|
|
#
|
|
# Overrides nl_after_func_body and nl_after_func_body_class.
|
|
nl_after_func_body_one_liner = 0 # unsigned number
|
|
|
|
# The number of newlines before a block of typedefs. If nl_after_access_spec
|
|
# is non-zero, that option takes precedence.
|
|
#
|
|
# 0: No change (default).
|
|
nl_typedef_blk_start = 0 # unsigned number
|
|
|
|
# The number of newlines after a block of typedefs.
|
|
#
|
|
# 0: No change (default).
|
|
nl_typedef_blk_end = 0 # unsigned number
|
|
|
|
# The maximum number of consecutive newlines within a block of typedefs.
|
|
#
|
|
# 0: No change (default).
|
|
nl_typedef_blk_in = 0 # unsigned number
|
|
|
|
# The minimum number of blank lines after a block of variable definitions
|
|
# at the top of a function body. If any preprocessor directives appear
|
|
# between the opening brace of the function and the variable block, then
|
|
# it is considered as not at the top of the function.Newlines are added
|
|
# before trailing preprocessor directives, if any exist.
|
|
#
|
|
# 0: No change (default).
|
|
nl_var_def_blk_end_func_top = 0 # unsigned number
|
|
|
|
# The minimum number of empty newlines before a block of variable definitions
|
|
# not at the top of a function body. If nl_after_access_spec is non-zero,
|
|
# that option takes precedence. Newlines are not added at the top of the
|
|
# file or just after an opening brace. Newlines are added above any
|
|
# preprocessor directives before the block.
|
|
#
|
|
# 0: No change (default).
|
|
nl_var_def_blk_start = 0 # unsigned number
|
|
|
|
# The minimum number of empty newlines after a block of variable definitions
|
|
# not at the top of a function body. Newlines are not added if the block
|
|
# is at the bottom of the file or just before a preprocessor directive.
|
|
#
|
|
# 0: No change (default).
|
|
nl_var_def_blk_end = 0 # unsigned number
|
|
|
|
# The maximum number of consecutive newlines within a block of variable
|
|
# definitions.
|
|
#
|
|
# 0: No change (default).
|
|
nl_var_def_blk_in = 0 # unsigned number
|
|
|
|
# The minimum number of newlines before a multi-line comment.
|
|
# Doesn't apply if after a brace open or another multi-line comment.
|
|
nl_before_block_comment = 0 # unsigned number
|
|
|
|
# The minimum number of newlines before a single-line C comment.
|
|
# Doesn't apply if after a brace open or other single-line C comments.
|
|
nl_before_c_comment = 0 # unsigned number
|
|
|
|
# The minimum number of newlines before a CPP comment.
|
|
# Doesn't apply if after a brace open or other CPP comments.
|
|
nl_before_cpp_comment = 0 # unsigned number
|
|
|
|
# Whether to force a newline after a multi-line comment.
|
|
nl_after_multiline_comment = false # true/false
|
|
|
|
# Whether to force a newline after a label's colon.
|
|
nl_after_label_colon = false # true/false
|
|
|
|
# The number of newlines before a struct definition.
|
|
nl_before_struct = 0 # unsigned number
|
|
|
|
# The number of newlines after '}' or ';' of a struct/enum/union definition.
|
|
nl_after_struct = 0 # unsigned number
|
|
|
|
# The number of newlines before a class definition.
|
|
nl_before_class = 0 # unsigned number
|
|
|
|
# The number of newlines after '}' or ';' of a class definition.
|
|
nl_after_class = 0 # unsigned number
|
|
|
|
# The number of newlines before a namespace.
|
|
nl_before_namespace = 0 # unsigned number
|
|
|
|
# The number of newlines after '{' of a namespace. This also adds newlines
|
|
# before the matching '}'.
|
|
#
|
|
# 0: Apply eat_blanks_after_open_brace or eat_blanks_before_close_brace if
|
|
# applicable, otherwise no change.
|
|
#
|
|
# Overrides eat_blanks_after_open_brace and eat_blanks_before_close_brace.
|
|
nl_inside_namespace = 0 # unsigned number
|
|
|
|
# The number of newlines after '}' of a namespace.
|
|
nl_after_namespace = 0 # unsigned number
|
|
|
|
# The number of newlines before an access specifier label. This also includes
|
|
# the Qt-specific 'signals:' and 'slots:'. Will not change the newline count
|
|
# if after a brace open.
|
|
#
|
|
# 0: No change (default).
|
|
nl_before_access_spec = 0 # unsigned number
|
|
|
|
# The number of newlines after an access specifier label. This also includes
|
|
# the Qt-specific 'signals:' and 'slots:'. Will not change the newline count
|
|
# if after a brace open.
|
|
#
|
|
# 0: No change (default).
|
|
#
|
|
# Overrides nl_typedef_blk_start and nl_var_def_blk_start.
|
|
nl_after_access_spec = 0 # unsigned number
|
|
|
|
# The number of newlines between a function definition and the function
|
|
# comment, as in '// comment\n <here> void foo() {...}'.
|
|
#
|
|
# 0: No change (default).
|
|
nl_comment_func_def = 0 # unsigned number
|
|
|
|
# The number of newlines after a try-catch-finally block that isn't followed
|
|
# by a brace close.
|
|
#
|
|
# 0: No change (default).
|
|
nl_after_try_catch_finally = 0 # unsigned number
|
|
|
|
# (C#) The number of newlines before and after a property, indexer or event
|
|
# declaration.
|
|
#
|
|
# 0: No change (default).
|
|
nl_around_cs_property = 0 # unsigned number
|
|
|
|
# (C#) The number of newlines between the get/set/add/remove handlers.
|
|
#
|
|
# 0: No change (default).
|
|
nl_between_get_set = 0 # unsigned number
|
|
|
|
# (C#) Add or remove newline between property and the '{'.
|
|
nl_property_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to remove blank lines after '{'.
|
|
eat_blanks_after_open_brace = true # true/false
|
|
|
|
# Whether to remove blank lines before '}'.
|
|
eat_blanks_before_close_brace = true # true/false
|
|
|
|
# How aggressively to remove extra newlines not in preprocessor.
|
|
#
|
|
# 0: No change (default)
|
|
# 1: Remove most newlines not handled by other config
|
|
# 2: Remove all newlines and reformat completely by config
|
|
nl_remove_extra_newlines = 0 # unsigned number
|
|
|
|
# (Java) Add or remove newline after an annotation statement. Only affects
|
|
# annotations that are after a newline.
|
|
nl_after_annotation = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (Java) Add or remove newline between two annotations.
|
|
nl_between_annotation = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# The number of newlines before a whole-file #ifdef.
|
|
#
|
|
# 0: No change (default).
|
|
nl_before_whole_file_ifdef = 0 # unsigned number
|
|
|
|
# The number of newlines after a whole-file #ifdef.
|
|
#
|
|
# 0: No change (default).
|
|
nl_after_whole_file_ifdef = 0 # unsigned number
|
|
|
|
# The number of newlines before a whole-file #endif.
|
|
#
|
|
# 0: No change (default).
|
|
nl_before_whole_file_endif = 0 # unsigned number
|
|
|
|
# The number of newlines after a whole-file #endif.
|
|
#
|
|
# 0: No change (default).
|
|
nl_after_whole_file_endif = 0 # unsigned number
|
|
|
|
#
|
|
# Positioning options
|
|
#
|
|
|
|
# The position of arithmetic operators in wrapped expressions.
|
|
pos_arith = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of assignment in wrapped expressions. Do not affect '='
|
|
# followed by '{'.
|
|
pos_assign = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of Boolean operators in wrapped expressions.
|
|
pos_bool = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of comparison operators in wrapped expressions.
|
|
pos_compare = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of conditional operators, as in the '?' and ':' of
|
|
# 'expr ? stmt : stmt', in wrapped expressions.
|
|
pos_conditional = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of the comma in wrapped expressions.
|
|
pos_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of the comma in enum entries.
|
|
pos_enum_comma = trail # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of the comma in the base class list if there is more than one
|
|
# line. Affects nl_class_init_args.
|
|
pos_class_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of the comma in the constructor initialization list.
|
|
# Related to nl_constr_colon, nl_constr_init_args and pos_constr_colon.
|
|
pos_constr_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of trailing/leading class colon, between class and base class
|
|
# list. Affects nl_class_colon.
|
|
pos_class_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of colons between constructor and member initialization.
|
|
# Related to nl_constr_colon, nl_constr_init_args and pos_constr_comma.
|
|
pos_constr_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
# The position of shift operators in wrapped expressions.
|
|
pos_shift = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
|
|
|
|
#
|
|
# Line splitting options
|
|
#
|
|
|
|
# Try to limit code width to N columns.
|
|
code_width = 100 # unsigned number
|
|
|
|
# Whether to fully split long 'for' statements at semi-colons.
|
|
ls_for_split_full = false # true/false
|
|
|
|
# Whether to fully split long function prototypes/calls at commas.
|
|
# The option ls_code_width has priority over the option ls_func_split_full.
|
|
ls_func_split_full = false # true/false
|
|
|
|
# Whether to split lines as close to code_width as possible and ignore some
|
|
# groupings.
|
|
# The option ls_code_width has priority over the option ls_func_split_full.
|
|
ls_code_width = false # true/false
|
|
|
|
#
|
|
# Code alignment options (not left column spaces/tabs)
|
|
#
|
|
|
|
# Whether to keep non-indenting tabs.
|
|
align_keep_tabs = false # true/false
|
|
|
|
# Whether to use tabs for aligning.
|
|
align_with_tabs = false # true/false
|
|
|
|
# Whether to bump out to the next tab when aligning.
|
|
align_on_tabstop = false # true/false
|
|
|
|
# Whether to right-align numbers.
|
|
align_number_right = false # true/false
|
|
|
|
# Whether to keep whitespace not required for alignment.
|
|
align_keep_extra_space = false # true/false
|
|
|
|
# Whether to align variable definitions in prototypes and functions.
|
|
align_func_params = false # true/false
|
|
|
|
# The span for aligning parameter definitions in function on parameter name.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_func_params_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning function parameter definitions.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_func_params_thresh = 0 # number
|
|
|
|
# The gap for aligning function parameter definitions.
|
|
align_func_params_gap = 0 # unsigned number
|
|
|
|
# The span for aligning constructor value.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_constr_value_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning constructor value.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_constr_value_thresh = 0 # number
|
|
|
|
# The gap for aligning constructor value.
|
|
align_constr_value_gap = 0 # unsigned number
|
|
|
|
# Whether to align parameters in single-line functions that have the same
|
|
# name. The function names must already be aligned with each other.
|
|
align_same_func_call_params = false # true/false
|
|
|
|
# The span for aligning function-call parameters for single line functions.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_same_func_call_params_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning function-call parameters for single line
|
|
# functions.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_same_func_call_params_thresh = 0 # number
|
|
|
|
# The span for aligning variable definitions.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_var_def_span = 0 # unsigned number
|
|
|
|
# How to consider (or treat) the '*' in the alignment of variable definitions.
|
|
#
|
|
# 0: Part of the type 'void * foo;' (default)
|
|
# 1: Part of the variable 'void *foo;'
|
|
# 2: Dangling 'void *foo;'
|
|
# Dangling: the '*' will not be taken into account when aligning.
|
|
align_var_def_star_style = 0 # unsigned number
|
|
|
|
# How to consider (or treat) the '&' in the alignment of variable definitions.
|
|
#
|
|
# 0: Part of the type 'long & foo;' (default)
|
|
# 1: Part of the variable 'long &foo;'
|
|
# 2: Dangling 'long &foo;'
|
|
# Dangling: the '&' will not be taken into account when aligning.
|
|
align_var_def_amp_style = 0 # unsigned number
|
|
|
|
# The threshold for aligning variable definitions.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_var_def_thresh = 0 # number
|
|
|
|
# The gap for aligning variable definitions.
|
|
align_var_def_gap = 0 # unsigned number
|
|
|
|
# Whether to align the colon in struct bit fields.
|
|
align_var_def_colon = false # true/false
|
|
|
|
# The gap for aligning the colon in struct bit fields.
|
|
align_var_def_colon_gap = 0 # unsigned number
|
|
|
|
# Whether to align any attribute after the variable name.
|
|
align_var_def_attribute = false # true/false
|
|
|
|
# Whether to align inline struct/enum/union variable definitions.
|
|
align_var_def_inline = false # true/false
|
|
|
|
# The span for aligning on '=' in assignments.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_assign_span = 0 # unsigned number
|
|
|
|
# The span for aligning on '=' in function prototype modifier.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_assign_func_proto_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning on '=' in assignments.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_assign_thresh = 0 # number
|
|
|
|
# Whether to align on the left most assignment when multiple
|
|
# definitions are found on the same line.
|
|
# Depends on 'align_assign_span' and 'align_assign_thresh' settings.
|
|
align_assign_on_multi_var_defs = false # true/false
|
|
|
|
# The span for aligning on '{' in braced init list.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_braced_init_list_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning on '{' in braced init list.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_braced_init_list_thresh = 0 # number
|
|
|
|
# How to apply align_assign_span to function declaration "assignments", i.e.
|
|
# 'virtual void foo() = 0' or '~foo() = {default|delete}'.
|
|
#
|
|
# 0: Align with other assignments (default)
|
|
# 1: Align with each other, ignoring regular assignments
|
|
# 2: Don't align
|
|
align_assign_decl_func = 0 # unsigned number
|
|
|
|
# The span for aligning on '=' in enums.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_enum_equ_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning on '=' in enums.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: no limit (default).
|
|
align_enum_equ_thresh = 0 # number
|
|
|
|
# The span for aligning class member definitions.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_var_class_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning class member definitions.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_var_class_thresh = 0 # number
|
|
|
|
# The gap for aligning class member definitions.
|
|
align_var_class_gap = 0 # unsigned number
|
|
|
|
# The span for aligning struct/union member definitions.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_var_struct_span = 0 # unsigned number
|
|
|
|
# The threshold for aligning struct/union member definitions.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_var_struct_thresh = 0 # number
|
|
|
|
# The gap for aligning struct/union member definitions.
|
|
align_var_struct_gap = 0 # unsigned number
|
|
|
|
# The span for aligning struct initializer values.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_struct_init_span = 0 # unsigned number
|
|
|
|
# The span for aligning single-line typedefs.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_typedef_span = 0 # unsigned number
|
|
|
|
# The minimum space between the type and the synonym of a typedef.
|
|
align_typedef_gap = 0 # unsigned number
|
|
|
|
# How to align typedef'd functions with other typedefs.
|
|
#
|
|
# 0: Don't mix them at all (default)
|
|
# 1: Align the open parenthesis with the types
|
|
# 2: Align the function type name with the other type names
|
|
align_typedef_func = 0 # unsigned number
|
|
|
|
# How to consider (or treat) the '*' in the alignment of typedefs.
|
|
#
|
|
# 0: Part of the typedef type, 'typedef int * pint;' (default)
|
|
# 1: Part of type name: 'typedef int *pint;'
|
|
# 2: Dangling: 'typedef int *pint;'
|
|
# Dangling: the '*' will not be taken into account when aligning.
|
|
align_typedef_star_style = 0 # unsigned number
|
|
|
|
# How to consider (or treat) the '&' in the alignment of typedefs.
|
|
#
|
|
# 0: Part of the typedef type, 'typedef int & intref;' (default)
|
|
# 1: Part of type name: 'typedef int &intref;'
|
|
# 2: Dangling: 'typedef int &intref;'
|
|
# Dangling: the '&' will not be taken into account when aligning.
|
|
align_typedef_amp_style = 0 # unsigned number
|
|
|
|
# The span for aligning comments that end lines.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_right_cmt_span = 0 # unsigned number
|
|
|
|
# Minimum number of columns between preceding text and a trailing comment in
|
|
# order for the comment to qualify for being aligned. Must be non-zero to have
|
|
# an effect.
|
|
align_right_cmt_gap = 0 # unsigned number
|
|
|
|
# If aligning comments, whether to mix with comments after '}' and #endif with
|
|
# less than three spaces before the comment.
|
|
align_right_cmt_mix = false # true/false
|
|
|
|
# Whether to only align trailing comments that are at the same brace level.
|
|
align_right_cmt_same_level = false # true/false
|
|
|
|
# Minimum column at which to align trailing comments. Comments which are
|
|
# aligned beyond this column, but which can be aligned in a lesser column,
|
|
# may be "pulled in".
|
|
#
|
|
# 0: Ignore (default).
|
|
align_right_cmt_at_col = 0 # unsigned number
|
|
|
|
# The span for aligning function prototypes.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_func_proto_span = 0 # unsigned number
|
|
|
|
# Whether to ignore continuation lines when evaluating the number of
|
|
# new lines for the function prototype alignment's span.
|
|
#
|
|
# false: continuation lines are part of the newlines count
|
|
# true: continuation lines are not counted
|
|
align_func_proto_span_ignore_cont_lines = false # true/false
|
|
|
|
# How to consider (or treat) the '*' in the alignment of function prototypes.
|
|
#
|
|
# 0: Part of the type 'void * foo();' (default)
|
|
# 1: Part of the function 'void *foo();'
|
|
# 2: Dangling 'void *foo();'
|
|
# Dangling: the '*' will not be taken into account when aligning.
|
|
align_func_proto_star_style = 0 # unsigned number
|
|
|
|
# How to consider (or treat) the '&' in the alignment of function prototypes.
|
|
#
|
|
# 0: Part of the type 'long & foo();' (default)
|
|
# 1: Part of the function 'long &foo();'
|
|
# 2: Dangling 'long &foo();'
|
|
# Dangling: the '&' will not be taken into account when aligning.
|
|
align_func_proto_amp_style = 0 # unsigned number
|
|
|
|
# The threshold for aligning function prototypes.
|
|
# Use a negative number for absolute thresholds.
|
|
#
|
|
# 0: No limit (default).
|
|
align_func_proto_thresh = 0 # number
|
|
|
|
# Minimum gap between the return type and the function name.
|
|
align_func_proto_gap = 0 # unsigned number
|
|
|
|
# Whether to align function prototypes on the 'operator' keyword instead of
|
|
# what follows.
|
|
align_on_operator = false # true/false
|
|
|
|
# Whether to mix aligning prototype and variable declarations. If true,
|
|
# align_var_def_XXX options are used instead of align_func_proto_XXX options.
|
|
align_mix_var_proto = false # true/false
|
|
|
|
# Whether to align single-line functions with function prototypes.
|
|
# Uses align_func_proto_span.
|
|
align_single_line_func = false # true/false
|
|
|
|
# Whether to align the open brace of single-line functions.
|
|
# Requires align_single_line_func=true. Uses align_func_proto_span.
|
|
align_single_line_brace = false # true/false
|
|
|
|
# Gap for align_single_line_brace.
|
|
align_single_line_brace_gap = 0 # unsigned number
|
|
|
|
# (OC) The span for aligning Objective-C message specifications.
|
|
#
|
|
# 0: Don't align (default).
|
|
align_oc_msg_spec_span = 0 # unsigned number
|
|
|
|
# Whether and how to align backslashes that split a macro onto multiple lines.
|
|
# This will not work right if the macro contains a multi-line comment.
|
|
#
|
|
# 0: Do nothing (default)
|
|
# 1: Align the backslashes in the column at the end of the longest line
|
|
# 2: Align with the backslash that is farthest to the left, or, if that
|
|
# backslash is farther left than the end of the longest line, at the end of
|
|
# the longest line
|
|
# 3: Align with the backslash that is farthest to the right
|
|
align_nl_cont = 0 # unsigned number
|
|
|
|
# The minimum number of spaces between the end of a line and its continuation
|
|
# backslash. Requires align_nl_cont.
|
|
#
|
|
# Default: 1
|
|
align_nl_cont_spaces = 1 # unsigned number
|
|
|
|
# Whether to align macro functions and variables together.
|
|
align_pp_define_together = false # true/false
|
|
|
|
# The span for aligning on '#define' bodies.
|
|
#
|
|
# =0: Don't align (default)
|
|
# >0: Number of lines (including comments) between blocks
|
|
align_pp_define_span = 0 # unsigned number
|
|
|
|
# The minimum space between label and value of a preprocessor define.
|
|
align_pp_define_gap = 0 # unsigned number
|
|
|
|
# Whether to align lines that start with '<<' with previous '<<'.
|
|
#
|
|
# Default: true
|
|
align_left_shift = true # true/false
|
|
|
|
# Whether to align comma-separated statements following '<<' (as used to
|
|
# initialize Eigen matrices).
|
|
align_eigen_comma_init = false # true/false
|
|
|
|
# Whether to align text after 'asm volatile ()' colons.
|
|
align_asm_colon = false # true/false
|
|
|
|
# (OC) Span for aligning parameters in an Objective-C message call
|
|
# on the ':'.
|
|
#
|
|
# 0: Don't align.
|
|
align_oc_msg_colon_span = 0 # unsigned number
|
|
|
|
# (OC) Whether to always align with the first parameter, even if it is too
|
|
# short.
|
|
align_oc_msg_colon_first = false # true/false
|
|
|
|
# (OC) Whether to align parameters in an Objective-C '+' or '-' declaration
|
|
# on the ':'.
|
|
align_oc_decl_colon = false # true/false
|
|
|
|
# (OC) Whether to not align parameters in an Objectve-C message call if first
|
|
# colon is not on next line of the message call (the same way Xcode does
|
|
# alignment)
|
|
align_oc_msg_colon_xcode_like = false # true/false
|
|
|
|
#
|
|
# Comment modification options
|
|
#
|
|
|
|
# Try to wrap comments at N columns.
|
|
cmt_width = 0 # unsigned number
|
|
|
|
# How to reflow comments.
|
|
#
|
|
# 0: No reflowing (apart from the line wrapping due to cmt_width) (default)
|
|
# 1: No touching at all
|
|
# 2: Full reflow (enable cmt_indent_multi for indent with line wrapping due to cmt_width)
|
|
cmt_reflow_mode = 0 # unsigned number
|
|
|
|
# Path to a file that contains regular expressions describing patterns for
|
|
# which the end of one line and the beginning of the next will be folded into
|
|
# the same sentence or paragraph during full comment reflow. The regular
|
|
# expressions are described using ECMAScript syntax. The syntax for this
|
|
# specification is as follows, where "..." indicates the custom regular
|
|
# expression and "n" indicates the nth end_of_prev_line_regex and
|
|
# beg_of_next_line_regex regular expression pair:
|
|
#
|
|
# end_of_prev_line_regex[1] = "...$"
|
|
# beg_of_next_line_regex[1] = "^..."
|
|
# end_of_prev_line_regex[2] = "...$"
|
|
# beg_of_next_line_regex[2] = "^..."
|
|
# .
|
|
# .
|
|
# .
|
|
# end_of_prev_line_regex[n] = "...$"
|
|
# beg_of_next_line_regex[n] = "^..."
|
|
#
|
|
# Note that use of this option overrides the default reflow fold regular
|
|
# expressions, which are internally defined as follows:
|
|
#
|
|
# end_of_prev_line_regex[1] = "[\w,\]\)]$"
|
|
# beg_of_next_line_regex[1] = "^[\w,\[\(]"
|
|
# end_of_prev_line_regex[2] = "\.$"
|
|
# beg_of_next_line_regex[2] = "^[A-Z]"
|
|
cmt_reflow_fold_regex_file = "" # string
|
|
|
|
# Whether to indent wrapped lines to the start of the encompassing paragraph
|
|
# during full comment reflow (cmt_reflow_mode = 2). Overrides the value
|
|
# specified by cmt_sp_after_star_cont.
|
|
#
|
|
# Note that cmt_align_doxygen_javadoc_tags overrides this option for
|
|
# paragraphs associated with javadoc tags
|
|
cmt_reflow_indent_to_paragraph_start = false # true/false
|
|
|
|
# Whether to convert all tabs to spaces in comments. If false, tabs in
|
|
# comments are left alone, unless used for indenting.
|
|
cmt_convert_tab_to_spaces = true # true/false
|
|
|
|
# Whether to apply changes to multi-line comments, including cmt_width,
|
|
# keyword substitution and leading chars.
|
|
#
|
|
# Default: true
|
|
cmt_indent_multi = true # true/false
|
|
|
|
# Whether to align doxygen javadoc-style tags ('@param', '@return', etc.)
|
|
# and corresponding fields such that groups of consecutive block tags,
|
|
# parameter names, and descriptions align with one another. Overrides that
|
|
# which is specified by the cmt_sp_after_star_cont. If cmt_width > 0, it may
|
|
# be necessary to enable cmt_indent_multi and set cmt_reflow_mode = 2
|
|
# in order to achieve the desired alignment for line-wrapping.
|
|
cmt_align_doxygen_javadoc_tags = false # true/false
|
|
|
|
# The number of spaces to insert after the star and before doxygen
|
|
# javadoc-style tags (@param, @return, etc). Requires enabling
|
|
# cmt_align_doxygen_javadoc_tags. Overrides that which is specified by the
|
|
# cmt_sp_after_star_cont.
|
|
#
|
|
# Default: 1
|
|
cmt_sp_before_doxygen_javadoc_tags = 1 # unsigned number
|
|
|
|
# Whether to change trailing, single-line c-comments into cpp-comments.
|
|
cmt_trailing_single_line_c_to_cpp = true # true/false
|
|
|
|
# Whether to group c-comments that look like they are in a block.
|
|
cmt_c_group = false # true/false
|
|
|
|
# Whether to put an empty '/*' on the first line of the combined c-comment.
|
|
cmt_c_nl_start = false # true/false
|
|
|
|
# Whether to add a newline before the closing '*/' of the combined c-comment.
|
|
cmt_c_nl_end = false # true/false
|
|
|
|
# Whether to change cpp-comments into c-comments.
|
|
cmt_cpp_to_c = false # true/false
|
|
|
|
# Whether to group cpp-comments that look like they are in a block. Only
|
|
# meaningful if cmt_cpp_to_c=true.
|
|
cmt_cpp_group = false # true/false
|
|
|
|
# Whether to put an empty '/*' on the first line of the combined cpp-comment
|
|
# when converting to a c-comment.
|
|
#
|
|
# Requires cmt_cpp_to_c=true and cmt_cpp_group=true.
|
|
cmt_cpp_nl_start = false # true/false
|
|
|
|
# Whether to add a newline before the closing '*/' of the combined cpp-comment
|
|
# when converting to a c-comment.
|
|
#
|
|
# Requires cmt_cpp_to_c=true and cmt_cpp_group=true.
|
|
cmt_cpp_nl_end = false # true/false
|
|
|
|
# Whether to put a star on subsequent comment lines.
|
|
cmt_star_cont = false # true/false
|
|
|
|
# The number of spaces to insert at the start of subsequent comment lines.
|
|
cmt_sp_before_star_cont = 0 # unsigned number
|
|
|
|
# The number of spaces to insert after the star on subsequent comment lines.
|
|
cmt_sp_after_star_cont = 0 # unsigned number
|
|
|
|
# For multi-line comments with a '*' lead, remove leading spaces if the first
|
|
# and last lines of the comment are the same length.
|
|
#
|
|
# Default: true
|
|
cmt_multi_check_last = true # true/false
|
|
|
|
# For multi-line comments with a '*' lead, remove leading spaces if the first
|
|
# and last lines of the comment are the same length AND if the length is
|
|
# bigger as the first_len minimum.
|
|
#
|
|
# Default: 4
|
|
cmt_multi_first_len_minimum = 4 # unsigned number
|
|
|
|
# Path to a file that contains text to insert at the beginning of a file if
|
|
# the file doesn't start with a C/C++ comment. If the inserted text contains
|
|
# '$(filename)', that will be replaced with the current file's name.
|
|
cmt_insert_file_header = "" # string
|
|
|
|
# Path to a file that contains text to insert at the end of a file if the
|
|
# file doesn't end with a C/C++ comment. If the inserted text contains
|
|
# '$(filename)', that will be replaced with the current file's name.
|
|
cmt_insert_file_footer = "" # string
|
|
|
|
# Path to a file that contains text to insert before a function definition if
|
|
# the function isn't preceded by a C/C++ comment. If the inserted text
|
|
# contains '$(function)', '$(javaparam)' or '$(fclass)', these will be
|
|
# replaced with, respectively, the name of the function, the javadoc '@param'
|
|
# and '@return' stuff, or the name of the class to which the member function
|
|
# belongs.
|
|
cmt_insert_func_header = "" # string
|
|
|
|
# Path to a file that contains text to insert before a class if the class
|
|
# isn't preceded by a C/C++ comment. If the inserted text contains '$(class)',
|
|
# that will be replaced with the class name.
|
|
cmt_insert_class_header = "" # string
|
|
|
|
# Path to a file that contains text to insert before an Objective-C message
|
|
# specification, if the method isn't preceded by a C/C++ comment. If the
|
|
# inserted text contains '$(message)' or '$(javaparam)', these will be
|
|
# replaced with, respectively, the name of the function, or the javadoc
|
|
# '@param' and '@return' stuff.
|
|
cmt_insert_oc_msg_header = "" # string
|
|
|
|
# Whether a comment should be inserted if a preprocessor is encountered when
|
|
# stepping backwards from a function name.
|
|
#
|
|
# Applies to cmt_insert_oc_msg_header, cmt_insert_func_header and
|
|
# cmt_insert_class_header.
|
|
cmt_insert_before_preproc = false # true/false
|
|
|
|
# Whether a comment should be inserted if a function is declared inline to a
|
|
# class definition.
|
|
#
|
|
# Applies to cmt_insert_func_header.
|
|
#
|
|
# Default: true
|
|
cmt_insert_before_inlines = true # true/false
|
|
|
|
# Whether a comment should be inserted if the function is a class constructor
|
|
# or destructor.
|
|
#
|
|
# Applies to cmt_insert_func_header.
|
|
cmt_insert_before_ctor_dtor = false # true/false
|
|
|
|
#
|
|
# Code modifying options (non-whitespace)
|
|
#
|
|
|
|
# Add or remove braces on a single-line 'do' statement.
|
|
mod_full_brace_do = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove braces on a single-line 'for' statement.
|
|
mod_full_brace_for = add # ignore/add/remove/force/not_defined
|
|
|
|
# (Pawn) Add or remove braces on a single-line function definition.
|
|
mod_full_brace_function = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove braces on a single-line 'if' statement. Braces will not be
|
|
# removed if the braced statement contains an 'else'.
|
|
mod_full_brace_if = add # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to enforce that all blocks of an 'if'/'else if'/'else' chain either
|
|
# have, or do not have, braces. Overrides mod_full_brace_if.
|
|
#
|
|
# 0: Don't override mod_full_brace_if
|
|
# 1: Add braces to all blocks if any block needs braces and remove braces if
|
|
# they can be removed from all blocks
|
|
# 2: Add braces to all blocks if any block already has braces, regardless of
|
|
# whether it needs them
|
|
# 3: Add braces to all blocks if any block needs braces and remove braces if
|
|
# they can be removed from all blocks, except if all blocks have braces
|
|
# despite none needing them
|
|
mod_full_brace_if_chain = 0 # unsigned number
|
|
|
|
# Whether to add braces to all blocks of an 'if'/'else if'/'else' chain.
|
|
# If true, mod_full_brace_if_chain will only remove braces from an 'if' that
|
|
# does not have an 'else if' or 'else'.
|
|
mod_full_brace_if_chain_only = false # true/false
|
|
|
|
# Add or remove braces on single-line 'while' statement.
|
|
mod_full_brace_while = add # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove braces on single-line 'using ()' statement.
|
|
mod_full_brace_using = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Don't remove braces around statements that span N newlines
|
|
mod_full_brace_nl = 0 # unsigned number
|
|
|
|
# Whether to prevent removal of braces from 'if'/'for'/'while'/etc. blocks
|
|
# which span multiple lines.
|
|
#
|
|
# Affects:
|
|
# mod_full_brace_for
|
|
# mod_full_brace_if
|
|
# mod_full_brace_if_chain
|
|
# mod_full_brace_if_chain_only
|
|
# mod_full_brace_while
|
|
# mod_full_brace_using
|
|
#
|
|
# Does not affect:
|
|
# mod_full_brace_do
|
|
# mod_full_brace_function
|
|
mod_full_brace_nl_block_rem_mlcond = false # true/false
|
|
|
|
# Add or remove unnecessary parentheses on 'return' statement.
|
|
mod_paren_on_return = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove unnecessary parentheses on 'throw' statement.
|
|
mod_paren_on_throw = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# (Pawn) Whether to change optional semicolons to real semicolons.
|
|
mod_pawn_semicolon = false # true/false
|
|
|
|
# Whether to fully parenthesize Boolean expressions in 'while' and 'if'
|
|
# statement, as in 'if (a && b > c)' => 'if (a && (b > c))'.
|
|
mod_full_paren_if_bool = false # true/false
|
|
|
|
# Whether to fully parenthesize Boolean expressions after '='
|
|
# statement, as in 'x = a && b > c;' => 'x = (a && (b > c));'.
|
|
mod_full_paren_assign_bool = false # true/false
|
|
|
|
# Whether to fully parenthesize Boolean expressions after '='
|
|
# statement, as in 'return a && b > c;' => 'return (a && (b > c));'.
|
|
mod_full_paren_return_bool = false # true/false
|
|
|
|
# Whether to remove superfluous semicolons.
|
|
mod_remove_extra_semicolon = true # true/false
|
|
|
|
# Whether to remove duplicate include.
|
|
mod_remove_duplicate_include = true # true/false
|
|
|
|
# the following options (mod_XX_closebrace_comment) use different comment,
|
|
# depending of the setting of the next option.
|
|
# false: Use the c comment (default)
|
|
# true : Use the cpp comment
|
|
mod_add_force_c_closebrace_comment = false # true/false
|
|
|
|
# If a function body exceeds the specified number of newlines and doesn't have
|
|
# a comment after the close brace, a comment will be added.
|
|
mod_add_long_function_closebrace_comment = 0 # unsigned number
|
|
|
|
# If a namespace body exceeds the specified number of newlines and doesn't
|
|
# have a comment after the close brace, a comment will be added.
|
|
mod_add_long_namespace_closebrace_comment = 0 # unsigned number
|
|
|
|
# If a class body exceeds the specified number of newlines and doesn't have a
|
|
# comment after the close brace, a comment will be added.
|
|
mod_add_long_class_closebrace_comment = 0 # unsigned number
|
|
|
|
# If a switch body exceeds the specified number of newlines and doesn't have a
|
|
# comment after the close brace, a comment will be added.
|
|
mod_add_long_switch_closebrace_comment = 0 # unsigned number
|
|
|
|
# If an #ifdef body exceeds the specified number of newlines and doesn't have
|
|
# a comment after the #endif, a comment will be added.
|
|
mod_add_long_ifdef_endif_comment = 0 # unsigned number
|
|
|
|
# If an #ifdef or #else body exceeds the specified number of newlines and
|
|
# doesn't have a comment after the #else, a comment will be added.
|
|
mod_add_long_ifdef_else_comment = 0 # unsigned number
|
|
|
|
# Whether to take care of the case by the mod_sort_xx options.
|
|
mod_sort_case_sensitive = false # true/false
|
|
|
|
# Whether to sort consecutive single-line 'import' statements.
|
|
mod_sort_import = false # true/false
|
|
|
|
# (C#) Whether to sort consecutive single-line 'using' statements.
|
|
mod_sort_using = false # true/false
|
|
|
|
# Whether to sort consecutive single-line '#include' statements (C/C++) and
|
|
# '#import' statements (Objective-C). Be aware that this has the potential to
|
|
# break your code if your includes/imports have ordering dependencies.
|
|
mod_sort_include = true # true/false
|
|
|
|
# Whether to prioritize '#include' and '#import' statements that contain
|
|
# filename without extension when sorting is enabled.
|
|
mod_sort_incl_import_prioritize_filename = false # true/false
|
|
|
|
# Whether to prioritize '#include' and '#import' statements that does not
|
|
# contain extensions when sorting is enabled.
|
|
mod_sort_incl_import_prioritize_extensionless = false # true/false
|
|
|
|
# Whether to prioritize '#include' and '#import' statements that contain
|
|
# angle over quotes when sorting is enabled.
|
|
mod_sort_incl_import_prioritize_angle_over_quotes = true # true/false
|
|
|
|
# Whether to ignore file extension in '#include' and '#import' statements
|
|
# for sorting comparison.
|
|
mod_sort_incl_import_ignore_extension = false # true/false
|
|
|
|
# Whether to group '#include' and '#import' statements when sorting is enabled.
|
|
mod_sort_incl_import_grouping_enabled = true # true/false
|
|
|
|
# Whether to move a 'break' that appears after a fully braced 'case' before
|
|
# the close brace, as in 'case X: { ... } break;' => 'case X: { ... break; }'.
|
|
mod_move_case_break = false # true/false
|
|
|
|
# Whether to move a 'return' that appears after a fully braced 'case' before
|
|
# the close brace, as in 'case X: { ... } return;' => 'case X: { ... return; }'.
|
|
mod_move_case_return = false # true/false
|
|
|
|
# Add or remove braces around a fully braced case statement. Will only remove
|
|
# braces if there are no variable declarations in the block.
|
|
mod_case_brace = ignore # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to remove a void 'return;' that appears as the last statement in a
|
|
# function.
|
|
mod_remove_empty_return = false # true/false
|
|
|
|
# Add or remove the comma after the last value of an enumeration.
|
|
mod_enum_last_comma = add # ignore/add/remove/force/not_defined
|
|
|
|
# Syntax to use for infinite loops.
|
|
#
|
|
# 0: Leave syntax alone (default)
|
|
# 1: Rewrite as `for(;;)`
|
|
# 2: Rewrite as `while(true)`
|
|
# 3: Rewrite as `do`...`while(true);`
|
|
# 4: Rewrite as `while(1)`
|
|
# 5: Rewrite as `do`...`while(1);`
|
|
#
|
|
# Infinite loops that do not already match one of these syntaxes are ignored.
|
|
# Other options that affect loop formatting will be applied after transforming
|
|
# the syntax.
|
|
mod_infinite_loop = 2 # unsigned number
|
|
|
|
# Add or remove the 'int' keyword in 'int short'.
|
|
mod_int_short = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'short int'.
|
|
mod_short_int = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'int long'.
|
|
mod_int_long = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'long int'.
|
|
mod_long_int = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'int signed'.
|
|
mod_int_signed = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'signed int'.
|
|
mod_signed_int = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'int unsigned'.
|
|
mod_int_unsigned = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Add or remove the 'int' keyword in 'unsigned int'.
|
|
mod_unsigned_int = remove # ignore/add/remove/force/not_defined
|
|
|
|
# If there is a situation where mod_int_* and mod_*_int would result in
|
|
# multiple int keywords, whether to keep the rightmost int (the default) or the
|
|
# leftmost int.
|
|
mod_int_prefer_int_on_left = false # true/false
|
|
|
|
# (OC) Whether to organize the properties. If true, properties will be
|
|
# rearranged according to the mod_sort_oc_property_*_weight factors.
|
|
mod_sort_oc_properties = false # true/false
|
|
|
|
# (OC) Weight of a class property modifier.
|
|
mod_sort_oc_property_class_weight = 0 # number
|
|
|
|
# (OC) Weight of 'atomic' and 'nonatomic'.
|
|
mod_sort_oc_property_thread_safe_weight = 0 # number
|
|
|
|
# (OC) Weight of 'readwrite' when organizing properties.
|
|
mod_sort_oc_property_readwrite_weight = 0 # number
|
|
|
|
# (OC) Weight of a reference type specifier ('retain', 'copy', 'assign',
|
|
# 'weak', 'strong') when organizing properties.
|
|
mod_sort_oc_property_reference_weight = 0 # number
|
|
|
|
# (OC) Weight of getter type ('getter=') when organizing properties.
|
|
mod_sort_oc_property_getter_weight = 0 # number
|
|
|
|
# (OC) Weight of setter type ('setter=') when organizing properties.
|
|
mod_sort_oc_property_setter_weight = 0 # number
|
|
|
|
# (OC) Weight of nullability type ('nullable', 'nonnull', 'null_unspecified',
|
|
# 'null_resettable') when organizing properties.
|
|
mod_sort_oc_property_nullability_weight = 0 # number
|
|
|
|
#
|
|
# Preprocessor options
|
|
#
|
|
|
|
# How to use tabs when indenting preprocessor code.
|
|
#
|
|
# -1: Use 'indent_with_tabs' setting (default)
|
|
# 0: Spaces only
|
|
# 1: Indent with tabs to brace level, align with spaces
|
|
# 2: Indent and align with tabs, using spaces when not on a tabstop
|
|
#
|
|
# Default: -1
|
|
pp_indent_with_tabs = -1 # number
|
|
|
|
# Add or remove indentation of preprocessor directives inside #if blocks
|
|
# at brace level 0 (file-level).
|
|
pp_indent = remove # ignore/add/remove/force/not_defined
|
|
|
|
# Whether to indent #if/#else/#endif at the brace level. If false, these are
|
|
# indented from column 1.
|
|
pp_indent_at_level = false # true/false
|
|
|
|
# Whether to indent #if/#else/#endif at the parenthesis level if the brace
|
|
# level is 0. If false, these are indented from column 1.
|
|
pp_indent_at_level0 = false # true/false
|
|
|
|
# Specifies the number of columns to indent preprocessors per level
|
|
# at brace level 0 (file-level). If pp_indent_at_level=false, also specifies
|
|
# the number of columns to indent preprocessors per level
|
|
# at brace level > 0 (function-level).
|
|
#
|
|
# Default: 1
|
|
pp_indent_count = 1 # unsigned number
|
|
|
|
# Add or remove space after # based on pp level of #if blocks.
|
|
pp_space_after = force # ignore/add/remove/force/not_defined
|
|
|
|
# Sets the number of spaces per level added with pp_space_after.
|
|
pp_space_count = 1 # unsigned number
|
|
|
|
# The indent for '#region' and '#endregion' in C# and '#pragma region' in
|
|
# C/C++. Negative values decrease indent down to the first column.
|
|
pp_indent_region = 0 # number
|
|
|
|
# Whether to indent the code between #region and #endregion.
|
|
pp_region_indent_code = false # true/false
|
|
|
|
# If pp_indent_at_level=true, sets the indent for #if, #else and #endif when
|
|
# not at file-level. Negative values decrease indent down to the first column.
|
|
#
|
|
# =0: Indent preprocessors using output_tab_size
|
|
# >0: Column at which all preprocessors will be indented
|
|
pp_indent_if = 0 # number
|
|
|
|
# Whether to indent the code between #if, #else and #endif.
|
|
pp_if_indent_code = false # true/false
|
|
|
|
# Whether to indent the body of an #if that encompasses all the code in the file.
|
|
pp_indent_in_guard = false # true/false
|
|
|
|
# Whether to indent '#define' at the brace level. If false, these are
|
|
# indented from column 1.
|
|
pp_define_at_level = false # true/false
|
|
|
|
# Whether to indent '#include' at the brace level.
|
|
pp_include_at_level = false # true/false
|
|
|
|
# Whether to ignore the '#define' body while formatting.
|
|
pp_ignore_define_body = false # true/false
|
|
|
|
# An offset value that controls the indentation of the body of a multiline #define.
|
|
# 'body' refers to all the lines of a multiline #define except the first line.
|
|
# Requires 'pp_ignore_define_body = false'.
|
|
#
|
|
# <0: Absolute column: the body indentation starts off at the specified column
|
|
# (ex. -3 ==> the body is indented starting from column 3)
|
|
# >=0: Relative to the column of the '#' of '#define'
|
|
# (ex. 3 ==> the body is indented starting 3 columns at the right of '#')
|
|
#
|
|
# Default: 8
|
|
pp_multiline_define_body_indent = 2 # number
|
|
|
|
# Whether to indent case statements between #if, #else, and #endif.
|
|
# Only applies to the indent of the preprocessor that the case statements
|
|
# directly inside of.
|
|
#
|
|
# Default: true
|
|
pp_indent_case = true # true/false
|
|
|
|
# Whether to indent whole function definitions between #if, #else, and #endif.
|
|
# Only applies to the indent of the preprocessor that the function definition
|
|
# is directly inside of.
|
|
#
|
|
# Default: true
|
|
pp_indent_func_def = true # true/false
|
|
|
|
# Whether to indent extern C blocks between #if, #else, and #endif.
|
|
# Only applies to the indent of the preprocessor that the extern block is
|
|
# directly inside of.
|
|
#
|
|
# Default: true
|
|
pp_indent_extern = true # true/false
|
|
|
|
# How to indent braces directly inside #if, #else, and #endif.
|
|
# Requires pp_if_indent_code=true and only applies to the indent of the
|
|
# preprocessor that the braces are directly inside of.
|
|
# 0: No extra indent
|
|
# 1: Indent by one level
|
|
# -1: Preserve original indentation
|
|
#
|
|
# Default: 1
|
|
pp_indent_brace = 1 # number
|
|
|
|
# Whether to print warning messages for unbalanced #if and #else blocks.
|
|
# This will print a message in the following cases:
|
|
# - if an #ifdef block ends on a different indent level than
|
|
# where it started from. Example:
|
|
#
|
|
# #ifdef TEST
|
|
# int i;
|
|
# {
|
|
# int j;
|
|
# #endif
|
|
#
|
|
# - an #elif/#else block ends on a different indent level than
|
|
# the corresponding #ifdef block. Example:
|
|
#
|
|
# #ifdef TEST
|
|
# int i;
|
|
# #else
|
|
# }
|
|
# int j;
|
|
# #endif
|
|
pp_warn_unbalanced_if = false # true/false
|
|
|
|
#
|
|
# Sort includes options
|
|
#
|
|
|
|
# The regex for include category with priority 0.
|
|
include_category_0 = "" # string
|
|
|
|
# The regex for include category with priority 1.
|
|
include_category_1 = "" # string
|
|
|
|
# The regex for include category with priority 2.
|
|
include_category_2 = "" # string
|
|
|
|
#
|
|
# Use or Do not Use options
|
|
#
|
|
|
|
# true: indent_func_call_param will be used (default)
|
|
# false: indent_func_call_param will NOT be used
|
|
#
|
|
# Default: true
|
|
use_indent_func_call_param = true # true/false
|
|
|
|
# The value of the indentation for a continuation line is calculated
|
|
# differently if the statement is:
|
|
# - a declaration: your case with QString fileName ...
|
|
# - an assignment: your case with pSettings = new QSettings( ...
|
|
#
|
|
# At the second case the indentation value might be used twice:
|
|
# - at the assignment
|
|
# - at the function call (if present)
|
|
#
|
|
# To prevent the double use of the indentation value, use this option with the
|
|
# value 'true'.
|
|
#
|
|
# true: indent_continue will be used only once
|
|
# false: indent_continue will be used every time (default)
|
|
#
|
|
# Requires indent_ignore_first_continue=false.
|
|
use_indent_continue_only_once = false # true/false
|
|
|
|
# The indentation can be:
|
|
# - after the assignment, at the '[' character
|
|
# - at the beginning of the lambda body
|
|
#
|
|
# true: indentation will be at the beginning of the lambda body
|
|
# false: indentation will be after the assignment (default)
|
|
indent_cpp_lambda_only_once = false # true/false
|
|
|
|
# Whether sp_after_angle takes precedence over sp_inside_fparen. This was the
|
|
# historic behavior, but is probably not the desired behavior, so this is off
|
|
# by default.
|
|
use_sp_after_angle_always = false # true/false
|
|
|
|
# Whether to apply special formatting for Qt SIGNAL/SLOT macros. Essentially,
|
|
# this tries to format these so that they match Qt's normalized form (i.e. the
|
|
# result of QMetaObject::normalizedSignature), which can slightly improve the
|
|
# performance of the QObject::connect call, rather than how they would
|
|
# otherwise be formatted.
|
|
#
|
|
# See options_for_QT.cpp for details.
|
|
#
|
|
# Default: true
|
|
use_options_overriding_for_qt_macros = true # true/false
|
|
|
|
# If true: the form feed character is removed from the list of whitespace
|
|
# characters. See https://en.cppreference.com/w/cpp/string/byte/isspace.
|
|
use_form_feed_no_more_as_whitespace_character = false # true/false
|
|
|
|
#
|
|
# Warn levels - 1: error, 2: warning (default), 3: note
|
|
#
|
|
|
|
# (C#) Warning is given if doing tab-to-\t replacement and we have found one
|
|
# in a C# verbatim string literal.
|
|
#
|
|
# Default: 2
|
|
warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number
|
|
|
|
# Limit the number of loops.
|
|
# Used by uncrustify.cpp to exit from infinite loop.
|
|
# 0: no limit.
|
|
debug_max_number_of_loops = 0 # number
|
|
|
|
# Set the number of the line to protocol;
|
|
# Used in the function prot_the_line if the 2. parameter is zero.
|
|
# 0: nothing protocol.
|
|
debug_line_number_to_protocol = 0 # number
|
|
|
|
# Set the number of second(s) before terminating formatting the current file,
|
|
# 0: no timeout.
|
|
# only for linux
|
|
debug_timeout = 0 # number
|
|
|
|
# Set the number of characters to be printed if the text is too long,
|
|
# 0: do not truncate.
|
|
debug_truncate = 0 # unsigned number
|
|
|
|
# sort (or not) the tracking info.
|
|
#
|
|
# Default: true
|
|
debug_sort_the_tracks = true # true/false
|
|
|
|
# decode (or not) the flags as a new line.
|
|
# only if the -p option is set.
|
|
debug_decode_the_flags = false # true/false
|
|
|
|
# use (or not) the exit(EX_SOFTWARE) function.
|
|
#
|
|
# Default: true
|
|
debug_use_the_exit_function_pop = true # true/false
|
|
|
|
# insert the number of the line at the beginning of each line
|
|
set_numbering_for_html_output = false # true/false
|
|
|
|
# Meaning of the settings:
|
|
# Ignore - do not do any changes
|
|
# Add - makes sure there is 1 or more space/brace/newline/etc
|
|
# Force - makes sure there is exactly 1 space/brace/newline/etc,
|
|
# behaves like Add in some contexts
|
|
# Remove - removes space/brace/newline/etc
|
|
#
|
|
#
|
|
# - Token(s) can be treated as specific type(s) with the 'set' option:
|
|
# `set tokenType tokenString [tokenString...]`
|
|
#
|
|
# Example:
|
|
# `set BOOL __AND__ __OR__`
|
|
#
|
|
# tokenTypes are defined in src/token_enum.h, use them without the
|
|
# 'CT_' prefix: 'CT_BOOL' => 'BOOL'
|
|
#
|
|
#
|
|
# - Token(s) can be treated as type(s) with the 'type' option.
|
|
# `type tokenString [tokenString...]`
|
|
#
|
|
# Example:
|
|
# `type int c_uint_8 Rectangle`
|
|
#
|
|
# This can also be achieved with `set TYPE int c_uint_8 Rectangle`
|
|
#
|
|
#
|
|
# To embed whitespace in tokenStrings use the '\' escape character, or quote
|
|
# the tokenStrings. These quotes are supported: "'`
|
|
#
|
|
#
|
|
# - Support for the auto detection of languages through the file ending can be
|
|
# added using the 'file_ext' command.
|
|
# `file_ext langType langString [langString..]`
|
|
#
|
|
# Example:
|
|
# `file_ext CPP .ch .cxx .cpp.in`
|
|
#
|
|
# langTypes are defined in uncrusify_types.h in the lang_flag_e enum, use
|
|
# them without the 'LANG_' prefix: 'LANG_CPP' => 'CPP'
|
|
#
|
|
#
|
|
# - Custom macro-based indentation can be set up using 'macro-open',
|
|
# 'macro-else' and 'macro-close'.
|
|
# `(macro-open | macro-else | macro-close) tokenString`
|
|
#
|
|
# Example:
|
|
# `macro-open BEGIN_TEMPLATE_MESSAGE_MAP`
|
|
# `macro-open BEGIN_MESSAGE_MAP`
|
|
# `macro-close END_MESSAGE_MAP`
|
|
#
|
|
#
|
|
set CLASS_COLON FUNC_API_DEPRECATED_SINCE
|
|
set CLASS_COLON FUNC_API_FAST
|
|
set CLASS_COLON FUNC_API_LUA_ONLY
|
|
set CLASS_COLON FUNC_API_NOEXPORT
|
|
set CLASS_COLON FUNC_API_REMOTE_ONLY
|
|
set CLASS_COLON FUNC_API_SINCE
|
|
set CLASS_COLON FUNC_API_TEXTLOCK
|
|
set CLASS_COLON FUNC_API_TEXTLOCK_ALLOW_CMDWIN
|
|
set CLASS_COLON FUNC_ATTR_ALWAYS_INLINE
|
|
set CLASS_COLON FUNC_ATTR_CONST
|
|
set CLASS_COLON FUNC_ATTR_MALLOC
|
|
set CLASS_COLON FUNC_ATTR_NONNULL_ALL
|
|
set CLASS_COLON FUNC_ATTR_NONNULL_ARG
|
|
set CLASS_COLON FUNC_ATTR_NONNULL_RET
|
|
set CLASS_COLON FUNC_ATTR_NORETURN
|
|
set CLASS_COLON FUNC_ATTR_NO_SANITIZE_ADDRESS
|
|
set CLASS_COLON FUNC_ATTR_NO_SANITIZE_UNDEFINED
|
|
set CLASS_COLON FUNC_ATTR_PRINTF
|
|
set CLASS_COLON FUNC_ATTR_PURE
|
|
set CLASS_COLON FUNC_ATTR_WARN_UNUSED_RESULT
|
|
set PP_PRAGMA PRAGMA_DIAG_PUSH_IGNORE_IMPLICIT_FALLTHROUGH
|
|
set PP_PRAGMA PRAGMA_DIAG_PUSH_IGNORE_MISSING_PROTOTYPES
|
|
set CLASS_COLON REAL_FATTR_ALWAYS_INLINE
|
|
set CLASS_COLON REAL_FATTR_CONST
|
|
set CLASS_COLON REAL_FATTR_NONNULL_ALL
|
|
set CLASS_COLON REAL_FATTR_PURE
|
|
set CLASS_COLON REAL_FATTR_WARN_UNUSED_RESULT
|
|
# option(s) with 'not default' value: 135
|
|
#
|