diff --git a/scripts/uncrustify.cfg b/scripts/uncrustify.cfg index 395548d2b..4d5cfdb38 100644 --- a/scripts/uncrustify.cfg +++ b/scripts/uncrustify.cfg @@ -1,4 +1,4 @@ -# Uncrustify-0.68_f +# Uncrustify-0.72.0_f # # General options @@ -37,13 +37,18 @@ string_replace_tab_chars = false # true/false # 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. multiline macros) +disable_processing_nl_cont = false # true/false + # Specify the marker used in comments to disable processing of part of the # file. +# The comment should be used alone in one line. # # Default: *INDENT-OFF* disable_processing_cmt = " *INDENT-OFF*" # string # Specify the marker used in comments to (re)enable processing in a file. +# The comment should be used alone in one line. # # Default: *INDENT-ON* enable_processing_cmt = " *INDENT-ON*" # string @@ -61,6 +66,15 @@ utf8_byte = false # true/false # Force the output encoding to UTF-8. utf8_force = true # true/false +# Add or remove space between 'do' and '{'. +sp_do_brace_open = force # ignore/add/remove/force + +# Add or remove space between '}' and 'while'. +sp_brace_close_while = force # ignore/add/remove/force + +# Add or remove space between 'while' and '('. +sp_while_paren_open = force # ignore/add/remove/force + # # Spacing options # @@ -82,10 +96,25 @@ sp_assign = force # ignore/add/remove/force # Overrides sp_assign. sp_cpp_lambda_assign = remove # ignore/add/remove/force -# Add or remove space after the capture specification in C++11 lambda. -sp_cpp_lambda_paren = remove # ignore/add/remove/force +# Add or remove space after the capture specification of a C++11 lambda when +# an argument list is present, as in '[] (int x){ ... }'. +sp_cpp_lambda_square_paren = remove # ignore/add/remove/force + +# Add or remove space after the capture specification of a C++11 lambda with +# no argument list is present, as in '[] { ... }'. +sp_cpp_lambda_square_brace = ignore # ignore/add/remove/force + +# Add or remove space after the argument list of a C++11 lambda, as in +# '[](int x) { ... }'. +sp_cpp_lambda_paren_brace = ignore # ignore/add/remove/force + +# Add or remove space between a lambda body and its call operator of an +# immediately invoked lambda, as in '[]( ... ){ ... } ( ... )'. +sp_cpp_lambda_fparen = ignore # ignore/add/remove/force # Add or remove space around assignment operator '=' in a prototype. +# +# If set to ignore, use sp_assign. sp_assign_default = force # ignore/add/remove/force # Add or remove space before assignment operator '=', '+=', etc. @@ -158,13 +187,15 @@ sp_brace_brace = ignore # ignore/add/remove/force sp_before_ptr_star = force # ignore/add/remove/force # 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. +# variable name. If set to ignore, sp_before_ptr_star is used instead. sp_before_unnamed_ptr_star = force # ignore/add/remove/force # Add or remove space between pointer stars '*'. sp_between_ptr_star = remove # ignore/add/remove/force # 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 # Add or remove space after pointer caret '^', if followed by a word. @@ -175,6 +206,8 @@ sp_after_ptr_star_qualifier = ignore # ignore/add/remove/force # 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 # Add or remove space after a pointer star '*', if followed by an open @@ -189,26 +222,40 @@ sp_before_ptr_star_func = force # ignore/add/remove/force sp_before_byref = force # ignore/add/remove/force # 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. +# variable name. If set to ignore, sp_before_byref is used instead. sp_before_unnamed_byref = force # ignore/add/remove/force # Add or remove space after reference sign '&', if followed by a word. -sp_after_byref = remove # ignore/add/remove/force +# +# Overrides sp_type_func. +sp_after_byref = remove # ignore/add/remove/force # 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 = remove # ignore/add/remove/force # Add or remove space before a reference sign '&', if followed by a function # prototype or function definition. sp_before_byref_func = force # ignore/add/remove/force -# Add or remove space between type and word. +# 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 # Add or remove space between 'decltype(...)' and word. +# +# Overrides sp_after_type. sp_after_decltype = force # ignore/add/remove/force # (D) Add or remove space before the parenthesis in the D constructs @@ -225,10 +272,13 @@ sp_before_angle = ignore # ignore/add/remove/force # Add or remove space inside '<' and '>'. sp_inside_angle = ignore # ignore/add/remove/force +# Add or remove space inside '<>'. +sp_inside_angle_empty = remove # ignore/add/remove/force + # Add or remove space between '>' and ':'. sp_angle_colon = ignore # ignore/add/remove/force -# Add or remove space after '<>'. +# Add or remove space after '>'. sp_after_angle = ignore # ignore/add/remove/force # Add or remove space between '>' and '(' as found in 'new List(foo);'. @@ -310,15 +360,26 @@ sp_after_semi_for_empty = remove # ignore/add/remove/force # Add or remove space before '[' (except '[]'). sp_before_square = remove # ignore/add/remove/force +# Add or remove space before '[' for a variable definition. +# +# Default: remove +sp_before_vardef_square = remove # ignore/add/remove/force + +# Add or remove space before '[' for asm block. +sp_before_square_asm_block = ignore # ignore/add/remove/force + # Add or remove space before '[]'. sp_before_squares = remove # ignore/add/remove/force # Add or remove space before C++17 structured bindings. -sp_cpp_before_struct_binding = force # ignore/add/remove/force +sp_cpp_before_struct_binding = ignore # ignore/add/remove/force # Add or remove space inside a non-empty '[' and ']'. sp_inside_square = remove # ignore/add/remove/force +# Add or remove space inside '[]'. +sp_inside_square_empty = remove # ignore/add/remove/force + # (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 @@ -356,9 +417,18 @@ sp_before_ellipsis = ignore # ignore/add/remove/force # Add or remove space between a type and '...'. sp_type_ellipsis = ignore # ignore/add/remove/force +# (D) Add or remove space between a type and '?'. +sp_type_question = ignore # ignore/add/remove/force + # Add or remove space between ')' and '...'. sp_paren_ellipsis = ignore # ignore/add/remove/force +# Add or remove space between ')' and a qualifier such as 'const'. +sp_paren_qualifier = force # ignore/add/remove/force + +# Add or remove space between ')' and 'noexcept'. +sp_paren_noexcept = force # ignore/add/remove/force + # Add or remove space after class ':'. sp_after_class_colon = force # ignore/add/remove/force @@ -439,6 +509,9 @@ sp_inside_braces = ignore # ignore/add/remove/force # Add or remove space inside '{}'. sp_inside_braces_empty = remove # ignore/add/remove/force +# Add or remove space around trailing return operator '->'. +sp_trailing_return = force # ignore/add/remove/force + # 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 @@ -454,7 +527,10 @@ sp_func_proto_paren = remove # ignore/add/remove/force # without parameters. sp_func_proto_paren_empty = remove # ignore/add/remove/force -# Add or remove space between function name and '(' on function definition. +# Add or remove space between function name and '(' with a typedef specifier. +sp_func_type_paren = ignore # ignore/add/remove/force + +# Add or remove space between alias name and '(' of a non-pointer function type typedef. sp_func_def_paren = remove # ignore/add/remove/force # Add or remove space between function name and '()' on function definition @@ -462,6 +538,7 @@ sp_func_def_paren = remove # ignore/add/remove/force sp_func_def_paren_empty = remove # ignore/add/remove/force # 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 # Add or remove space inside function '(' and ')'. @@ -481,7 +558,7 @@ sp_square_fparen = remove # ignore/add/remove/force # Add or remove space between ')' and '{' of function. sp_fparen_brace = force # ignore/add/remove/force -# Add or remove space between ')' and '{' of s function call in object +# Add or remove space between ')' and '{' of a function call in object # initialization. # # Overrides sp_fparen_brace. @@ -494,7 +571,7 @@ sp_fparen_dbrace = ignore # ignore/add/remove/force sp_func_call_paren = remove # ignore/add/remove/force # 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. +# parameters. If set to ignore (the default), sp_func_call_paren is used. sp_func_call_paren_empty = ignore # ignore/add/remove/force # Add or remove space between the user function name and '(' on function @@ -545,6 +622,14 @@ sp_catch_paren = force # ignore/add/remove/force # in '@catch (something) { }'. If set to ignore, sp_catch_paren is used. sp_oc_catch_paren = ignore # ignore/add/remove/force +# (OC) Add or remove space before Objective-C protocol list +# as in '@protocol Protocol' or '@interface MyClass : NSObject'. +sp_before_oc_proto_list = ignore # ignore/add/remove/force + +# (OC) Add or remove space between class name and '(' +# in '@interface className(categoryName):BaseClass' +sp_oc_classname_paren = ignore # ignore/add/remove/force + # (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 @@ -608,9 +693,7 @@ sp_getset_brace = ignore # ignore/add/remove/force # Add or remove space between a variable and '{' for C++ uniform # initialization. -# -# Default: add -sp_word_brace = add # ignore/add/remove/force +sp_word_brace_init_lst = force # ignore/add/remove/force # Add or remove space between a variable and '{' for a namespace. # @@ -794,7 +877,7 @@ sp_cmt_cpp_start = ignore # ignore/add/remove/force # If true, space is added with sp_cmt_cpp_start will be added after doxygen # sequences like '///', '///<', '//!' and '//!<'. -sp_cmt_cpp_doxygen = true # true/false +sp_cmt_cpp_doxygen = true # true/false # If true, space is added with sp_cmt_cpp_start will be added after Qt # translator or meta-data comments like '//:', '//=', and '//~'. @@ -843,6 +926,9 @@ sp_skip_vbrace_tokens = false # true/false # Add or remove space after 'noexcept'. sp_after_noexcept = remove # ignore/add/remove/force +# Add or remove space after '_'. +sp_vala_after_translation = ignore # ignore/add/remove/force + # If true, a is inserted after #define. force_tab_after_define = false # true/false @@ -855,9 +941,9 @@ force_tab_after_define = false # true/false # Default: 8 indent_columns = 2 # unsigned number -# 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 '(' level. +# 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. indent_continue = 0 # number @@ -910,7 +996,7 @@ indent_braces_no_class = false # true/false 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. +# 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 @@ -932,6 +1018,7 @@ indent_namespace = true # true/false 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 @@ -969,8 +1056,8 @@ indent_else_if = true # true/false # Amount to indent variable declarations after a open brace. # -# <0: Relative -# ≥0: Absolute +# <0: Relative +# >=0: Absolute indent_var_def_blk = 0 # number # Whether to indent continued variable declarations instead of aligning. @@ -987,19 +1074,30 @@ indent_func_def_force_col1 = false # true/false # rather than aligning parameters under the open parenthesis. indent_func_call_param = false # true/false -# Same as indent_func_call_param, but for function definitions. +# 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 -# Same as indent_func_call_param, but for function prototypes. +# 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 -# Same as indent_func_call_param, but for class declarations. +# 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 -# Same as indent_func_call_param, but for class variable constructors. +# 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 -# Same as indent_func_call_param, but for template parameter lists. +# 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. @@ -1014,17 +1112,31 @@ indent_func_const = 0 # unsigned number # 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 = true # 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 = true # true/false +indent_member_single = true # true/false # Spaces to indent single line ('//') comments on lines before code. indent_sing_line_comments = 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 @@ -1032,6 +1144,9 @@ indent_relative_single_line_comments = true # true/false # Spaces to indent 'case' from 'switch'. Usually 0 or indent_columns. indent_switch_case = 0 # unsigned 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 @@ -1048,17 +1163,23 @@ indent_case_brace = 2 # number # 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 + # How to indent goto labels. # -# >0: Absolute column where 1 is the leftmost column -# ≤0: Subtract from brace indent +# >0: Absolute column where 1 is the leftmost column +# <=0: Subtract from brace indent # # Default: 1 indent_label = -2 # number -# Same as indent_label, but for access specifiers that are followed by a +# 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 = -2 # number @@ -1122,12 +1243,19 @@ indent_preserve_sql = false # true/false # Default: true indent_align_assign = true # true/false -# Whether to align continued statements at the '('. If false or the '(' is not +# 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 @@ -1174,7 +1302,7 @@ indent_oc_block_msg_from_brace = false # true/false indent_min_vbrace_open = 0 # unsigned number # Whether to add further spaces after regular indent to reach next tabstop -# when identing after virtual brace open and newline. +# 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). @@ -1187,6 +1315,15 @@ indent_token_after_brace = true # true/false # Whether to indent the body of a C++11 lambda. indent_cpp_lambda_body = true # true/false +# How to indent compound literals that are being returned. +# true: add both the indent from return & the compound literal open brace (ie: +# 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 = true # true/false + # (C#) Whether to indent a 'using' block if no braces are used. # # Default: true @@ -1199,6 +1336,12 @@ indent_using_block = true # true/false # 2: When the `:` is a continuation, indent it under `?` indent_ternary_operator = 0 # unsigned number +# Whether to indent the statments 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 @@ -1209,11 +1352,16 @@ indent_single_after_return = false # true/false # 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 '}'. +# If true, overrides nl_inside_empty_func nl_collapse_empty_body = false # true/false # Don't split one-line braced assignments, as in 'foo_t f = { 1, 2 };'. @@ -1232,6 +1380,7 @@ nl_getset_leave_one_liners = false # true/false 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; }'. @@ -1255,6 +1404,15 @@ nl_oc_mdef_brace = ignore # ignore/add/remove/force # (OC) Add or remove newline between Objective-C block signature and '{'. nl_oc_block_brace = ignore # ignore/add/remove/force +# (OC) Add or remove blank line before '@interface' statement. +nl_oc_before_interface = ignore # ignore/add/remove/force + +# (OC) Add or remove blank line before '@implementation' statement. +nl_oc_before_implementation = ignore # ignore/add/remove/force + +# (OC) Add or remove blank line before '@end' statement. +nl_oc_before_end = ignore # ignore/add/remove/force + # (OC) Add or remove newline between '@interface' and '{'. nl_oc_interface_brace = ignore # ignore/add/remove/force @@ -1288,47 +1446,6 @@ nl_tsquare_brace = ignore # ignore/add/remove/force # the ']'. nl_after_square_assign = ignore # ignore/add/remove/force -# The number of blank lines after a block of variable definitions at the top -# of a function body. -# -# 0 = No change (default). -nl_func_var_def_blk = 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 number of 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. -# -# 0 = No change (default). -nl_var_def_blk_start = 0 # unsigned number - -# The number of newlines after a block of variable definitions not at the top -# of a function body. -# -# 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 - # 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 @@ -1370,6 +1487,9 @@ nl_else_brace = force # ignore/add/remove/force # Add or remove newline between 'else' and 'if'. nl_else_if = remove # ignore/add/remove/force +# Add or remove newline before '{' opening brace +nl_before_opening_brace_func_class_def = force # ignore/add/remove/force + # Add or remove newline before 'if'/'else if' closing parenthesis. nl_before_if_closing_paren = ignore # ignore/add/remove/force @@ -1447,6 +1567,14 @@ nl_synchronized_brace = ignore # ignore/add/remove/force # 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 = ignore # ignore/add/remove/force + +# 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 = ignore # ignore/add/remove/force + # Force a newline in a define after the macro name for multi-line defines. nl_multi_line_define = false # true/false @@ -1468,14 +1596,68 @@ nl_before_throw = ignore # ignore/add/remove/force # Add or remove newline between 'namespace' and '{'. nl_namespace_brace = force # ignore/add/remove/force -# Add or remove newline between 'template<>' and whatever follows. +# Add or remove newline after 'template<...>' of a template class. nl_template_class = force # ignore/add/remove/force +# Add or remove newline after 'template<...>' of a template class declaration. +# +# Overrides nl_template_class. +nl_template_class_decl = force # ignore/add/remove/force + +# Add or remove newline after 'template<>' of a specialized class declaration. +# +# Overrides nl_template_class_decl. +nl_template_class_decl_special = force # ignore/add/remove/force + +# Add or remove newline after 'template<...>' of a template class definition. +# +# Overrides nl_template_class. +nl_template_class_def = force # ignore/add/remove/force + +# Add or remove newline after 'template<>' of a specialized class definition. +# +# Overrides nl_template_class_def. +nl_template_class_def_special = force # ignore/add/remove/force + +# Add or remove newline after 'template<...>' of a template function. +nl_template_func = force # ignore/add/remove/force + +# Add or remove newline after 'template<...>' of a template function +# declaration. +# +# Overrides nl_template_func. +nl_template_func_decl = force # ignore/add/remove/force + +# Add or remove newline after 'template<>' of a specialized function +# declaration. +# +# Overrides nl_template_func_decl. +nl_template_func_decl_special = force # ignore/add/remove/force + +# Add or remove newline after 'template<...>' of a template function +# definition. +# +# Overrides nl_template_func. +nl_template_func_def = force # ignore/add/remove/force + +# Add or remove newline after 'template<>' of a specialized function +# definition. +# +# Overrides nl_template_func_def. +nl_template_func_def_special = force # ignore/add/remove/force + +# Add or remove newline after 'template<...>' of a template variable. +nl_template_var = force # ignore/add/remove/force + +# Add or remove newline between 'template<...>' and 'using' of a templated +# type alias. +nl_template_using = force # ignore/add/remove/force + # Add or remove newline between 'class' and '{'. nl_class_brace = force # ignore/add/remove/force -# Add or remove newline before or after (depending on pos_class_comma) each -# ',' in the base class list. +# 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 # Add or remove newline after each ',' in the constructor member @@ -1489,6 +1671,7 @@ nl_enum_own_lines = ignore # ignore/add/remove/force # 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 = force # ignore/add/remove/force # Add or remove newline between return type and function name inside a class @@ -1555,6 +1738,9 @@ nl_func_decl_args = ignore # ignore/add/remove/force # Add or remove newline after each ',' in a function definition. nl_func_def_args = ignore # ignore/add/remove/force +# Add or remove newline after each ',' in a function call. +nl_func_call_args = ignore # ignore/add/remove/force + # 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 @@ -1592,6 +1778,13 @@ nl_func_def_empty = ignore # ignore/add/remove/force # Add or remove newline between '()' in a function call. nl_func_call_empty = ignore # ignore/add/remove/force +# Whether to add a newline after '(' in a function call, +# has preference over nl_func_call_start_multi_line. +nl_func_call_start = ignore # ignore/add/remove/force + +# Whether to add a newline before ')' in a function call. +nl_func_call_end = ignore # ignore/add/remove/force + # 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 @@ -1604,6 +1797,18 @@ nl_func_call_args_multi_line = false # true/false # different lines. nl_func_call_end_multi_line = false # true/false +# Whether to respect nl_func_call_XXX option incase 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 @@ -1611,8 +1816,12 @@ nl_oc_msg_args = false # true/false # Add or remove newline between function signature and '{'. nl_fdef_brace = force # ignore/add/remove/force +# 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 + # Add or remove newline between C++11 lambda signature and '{'. -nl_cpp_ldef_brace = ignore # ignore/add/remove/force +nl_cpp_ldef_brace = force # ignore/add/remove/force # Add or remove newline between 'return' and the return expression. nl_return_expr = remove # ignore/add/remove/force @@ -1717,6 +1926,20 @@ nl_before_do = ignore # ignore/add/remove/force # Add or remove blank line after 'do/while' statement. nl_after_do = ignore # ignore/add/remove/force +# 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 + +# (Java) Whether to put a blank line after a member '.' or '->' operators. +nl_after_member = ignore # ignore/add/remove/force + # Whether to double-space commented-entries in 'struct'/'union'/'enum'. nl_ds_struct_enum_cmt = false # true/false @@ -1738,15 +1961,15 @@ nl_constr_colon = ignore # ignore/add/remove/force 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++;'. +# 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;'. +# 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;'. +# 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) @@ -1754,6 +1977,11 @@ nl_create_while_one_liner = false # true/false # a single line. nl_create_func_def_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_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) i++;'. nl_split_if_one_liner = false # true/false @@ -1766,6 +1994,10 @@ nl_split_for_one_liner = false # true/false # adding a newline, as in 'while (expr) 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 # @@ -1776,6 +2008,10 @@ 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 is overridden by nl_collapse_empty_body=true +nl_inside_empty_func = 0 # unsigned number + # The number of newlines before a function prototype. nl_before_func_body_proto = 0 # unsigned number @@ -1824,6 +2060,47 @@ nl_after_func_body_class = 0 # unsigned number # Overrides nl_after_func_body and nl_after_func_body_class. nl_after_func_body_one_liner = 0 # unsigned number +# The number of blank lines after a block of variable definitions at the top +# of a function body. +# +# 0: No change (default). +nl_func_var_def_blk = 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 number of 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. +# +# 0: No change (default). +nl_var_def_blk_start = 0 # unsigned number + +# The number of newlines after a block of variable definitions not at the top +# of a function body. +# +# 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 @@ -1851,18 +2128,33 @@ 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). +# 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). +# 0: No change (default). # # Overrides nl_typedef_blk_start and nl_var_def_blk_start. nl_after_access_spec = 0 # unsigned number @@ -1870,38 +2162,29 @@ nl_after_access_spec = 0 # unsigned number # The number of newlines between a function definition and the function # comment, as in '// comment\n void foo() {...}'. # -# 0 = No change (default). +# 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). +# 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). +# 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). +# 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 -# 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 - # Whether to remove blank lines after '{'. eat_blanks_after_open_brace = false # true/false @@ -1915,14 +2198,6 @@ eat_blanks_before_close_brace = false # true/false # 2: Remove all newlines and reformat completely by config nl_remove_extra_newlines = 0 # unsigned number -# 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 - # (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 @@ -1930,6 +2205,26 @@ nl_after_annotation = ignore # ignore/add/remove/force # (Java) Add or remove newline between two annotations. nl_between_annotation = ignore # ignore/add/remove/force +# 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 # @@ -1973,6 +2268,9 @@ pos_class_colon = trail # ignore/break/force/lead/trail/join/ # 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 # @@ -1984,10 +2282,12 @@ code_width = 0 # unsigned number 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 # @@ -2014,55 +2314,74 @@ align_func_params = false # true/false # The span for aligning parameter definitions in function on parameter name. # -# 0 = Don't align (default). +# 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 # unsigned number +# 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). +# 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 # unsigned number +# 0: No limit (default). +align_same_func_call_params_thresh = 0 # number # The span for aligning variable definitions. # -# 0 = Don't align (default). +# 0: Don't align (default). align_var_def_span = 0 # unsigned number -# How to align the '*' in variable definitions. +# 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 align the '&' in variable definitions. +# 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 # unsigned number +# 0: No limit (default). +align_var_def_thresh = 0 # number # The gap for aligning variable definitions. align_var_def_gap = 0 # unsigned number @@ -2081,13 +2400,19 @@ align_var_def_inline = false # true/false # The span for aligning on '=' in assignments. # -# 0 = Don't align (default). +# 0: Don't align (default). align_assign_span = 0 # unsigned number -# The threshold for aligning on '=' in assignments. +# The span for aligning on '=' in function prototype modifier. # -# 0 = No limit (default). -align_assign_thresh = 0 # unsigned number +# 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 # How to apply align_assign_span to function declaration "assignments", i.e. # 'virtual void foo() = 0' or '~foo() = {default|delete}'. @@ -2099,53 +2424,56 @@ align_assign_decl_func = 0 # unsigned number # The span for aligning on '=' in enums. # -# 0 = Don't align (default). +# 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 # unsigned number +# 0: no limit (default). +align_enum_equ_thresh = 0 # number # The span for aligning class member definitions. # -# 0 = Don't align (default). +# 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 # unsigned number +# 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). +# 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 # unsigned number +# 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). +# 0: Don't align (default). align_struct_init_span = 0 # unsigned number -# The minimum space between the type and the synonym of a typedef. -align_typedef_gap = 0 # unsigned number - # The span for aligning single-line typedefs. # -# 0 = Don't align (default). +# 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) @@ -2153,25 +2481,32 @@ align_typedef_span = 0 # unsigned number # 2: Align the function type name with the other type names align_typedef_func = 0 # unsigned number -# How to align the '*' in typedefs. +# How to consider (or treat) the '*' in the alignment of typedefs. # -# 0: Align on typedef type, ignore '*' (default) -# 1: The '*' is part of type name: 'typedef int *pint;' -# 2: The '*' is part of the type, but dangling: 'typedef int *pint;' +# 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 align the '&' in typedefs. +# How to consider (or treat) the '&' in the alignment of typedefs. # -# 0: Align on typedef type, ignore '&' (default) -# 1: The '&' is part of type name: 'typedef int &pint;' -# 2: The '&' is part of the type, but dangling: 'typedef int &pint;' +# 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). +# 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 @@ -2179,23 +2514,24 @@ 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 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 - # 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). +# 0: Ignore (default). align_right_cmt_at_col = 0 # unsigned number # The span for aligning function prototypes. # -# 0 = Don't align (default). +# 0: Don't align (default). align_func_proto_span = 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 @@ -2220,7 +2556,7 @@ align_single_line_brace_gap = 0 # unsigned number # (OC) The span for aligning Objective-C message specifications. # -# 0 = Don't align (default). +# 0: Don't align (default). align_oc_msg_spec_span = 0 # unsigned number # Whether to align macros wrapped with a backslash and a newline. This will @@ -2230,27 +2566,31 @@ align_nl_cont = false # true/false # Whether to align macro functions and variables together. align_pp_define_together = false # true/false -# The minimum space between label and value of a preprocessor define. -align_pp_define_gap = 0 # unsigned number - # 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. +# 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 @@ -2261,6 +2601,11 @@ align_oc_msg_colon_first = false # true/false # 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 +# aligment) +align_oc_msg_colon_xcode_like = false # true/false + # # Comment modification options # @@ -2448,7 +2793,7 @@ mod_paren_on_return = ignore # ignore/add/remove/force 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))'. +# statement, as in 'if (a && b > c)' => 'if (a && (b > c))'. mod_full_paren_if_bool = false # true/false # Whether to remove superfluous semicolons. @@ -2478,6 +2823,9 @@ mod_add_long_ifdef_endif_comment = 0 # unsigned number # 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 @@ -2489,8 +2837,27 @@ mod_sort_using = false # true/false # break your code if your includes/imports have ordering dependencies. mod_sort_include = false # 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 = false # 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 = false # 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; }'. +# the close brace, as in 'case X: { ... } break;' => 'case X: { ... break; }'. mod_move_case_break = false # true/false # Add or remove braces around a fully braced case statement. Will only remove @@ -2659,6 +3026,11 @@ use_indent_continue_only_once = false # true/false # false: indentation will be used every time (default) indent_cpp_lambda_only_once = true # 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 @@ -2670,6 +3042,11 @@ indent_cpp_lambda_only_once = true # true/false # 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 # @@ -2680,6 +3057,21 @@ use_options_overriding_for_qt_macros = true # true/false # 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 + # Meaning of the settings: # Ignore - do not do any changes # Add - makes sure there is 1 or more space/brace/newline/etc @@ -2695,7 +3087,7 @@ warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number # `set BOOL __AND__ __OR__` # # tokenTypes are defined in src/token_enum.h, use them without the -# 'CT_' prefix: 'CT_BOOL' → 'BOOL' +# 'CT_' prefix: 'CT_BOOL' => 'BOOL' # # # - Token(s) can be treated as type(s) with the 'type' option. @@ -2719,7 +3111,7 @@ warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number # `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' +# them without the 'LANG_' prefix: 'LANG_CPP' => 'CPP' # # # - Custom macro-based indentation can be set up using 'macro-open', @@ -2732,5 +3124,5 @@ warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number # `macro-close END_MESSAGE_MAP` # # -# option(s) with 'not default' value: 98 +# option(s) with 'not default' value: 149 #