Правила форматирования

.uncrustify.cfg

@@ -1,4 +1,4 @@
-# Uncrustify-0.74.0_f
+# Uncrustify-0.75.0_f
 
 #
 # General options
@@ -127,6 +127,11 @@ sp_before_assign                = force    # ignore/add/remove/force/not_defined
 # Overrides sp_assign.
 sp_after_assign                 = force    # 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
 
@@ -218,6 +223,10 @@ sp_after_ptr_star_trailing      = ignore   # ignore/add/remove/force/not_defined
 # 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           = remove   # 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
@@ -252,6 +261,10 @@ sp_after_byref_func             = ignore   # ignore/add/remove/force/not_defined
 # 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                  = force    # 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'.
@@ -452,14 +465,17 @@ sp_between_mdatype_commas       = ignore   # ignore/add/remove/force/not_defined
 # Default: force
 sp_paren_comma                  = force    # ignore/add/remove/force/not_defined
 
+# Add or remove space between a type and ':'.
+sp_type_colon                   = force    # ignore/add/remove/force/not_defined
+
 # Add or remove space after the variadic '...' when preceded by a
 # non-punctuator.
-# The value REMOVE will be overriden with FORCE
+# 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 overriden with FORCE
+# The value REMOVE will be overridden with FORCE
 sp_before_ellipsis              = force    # ignore/add/remove/force/not_defined
 
 # Add or remove space between a type and '...'.
@@ -468,9 +484,6 @@ sp_type_ellipsis                = force    # ignore/add/remove/force/not_defined
 # Add or remove space between a '*' and '...'.
 sp_ptr_type_ellipsis            = ignore   # ignore/add/remove/force/not_defined
 
-# (D) Add or remove space between a type and '?'.
-sp_type_question                = ignore   # ignore/add/remove/force/not_defined
-
 # Add or remove space between ')' and '...'.
 sp_paren_ellipsis               = ignore   # ignore/add/remove/force/not_defined
 
@@ -790,6 +803,10 @@ sp_d_array_colon                = ignore   # ignore/add/remove/force/not_defined
 # 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
@@ -1044,15 +1061,21 @@ force_tab_after_define          = false    # true/false
 # Default: 8
 indent_columns                  = 8        # 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
@@ -1128,16 +1151,23 @@ indent_namespace_level          = 0        # unsigned number
 # 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                    = true     # 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 a newline break before colon (see pos_class_colon
+# Requires indent_ignore_before_class_colon=false and a newline break before
-# and nl_class_colon)
+# 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.
@@ -1147,6 +1177,9 @@ indent_class_colon              = true     # true/false
 # colon. Requires indent_class_colon=true.
 indent_class_on_colon           = true     # true/false
 
+# Whether to ignore indent for a leading class initializer colon.
+indent_ignore_before_constr_colon = true     # true/false
+
 # Whether to indent the stuff after a leading class initializer colon.
 indent_constr_colon             = false    # true/false
 
@@ -1177,9 +1210,12 @@ indent_var_def_blk              = 0        # number
 # Whether to indent continued variable declarations instead of aligning.
 indent_var_def_cont             = false    # true/false
 
-# Whether to indent continued shift expressions ('<<' and '>>') instead of
+# How to indent continued shift expressions ('<<' and '>>').
-# aligning. Set align_left_shift=false when enabling this.
+# Set align_left_shift=false when using this.
-indent_shift                    = false    # true/false
+#  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
@@ -1266,6 +1302,9 @@ indent_switch_case              = 0        # unsigned number
 # 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.
@@ -1334,10 +1373,11 @@ indent_paren_nl                 = false    # true/false
 
 # How to indent a close parenthesis after a newline.
 #
-# 0: Indent to body level (default)
+#  0: Indent to body level (default)
-# 1: Align under the open parenthesis
+#  1: Align under the open parenthesis
-# 2: Indent to the brace level
+#  2: Indent to the brace level
-indent_paren_close              = 0        # unsigned number
+# -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.
@@ -1351,24 +1391,41 @@ indent_paren_after_func_decl    = false    # true/false
 # if the parenthesis is on its own line.
 indent_paren_after_func_call    = false    # true/false
 
-# Whether to indent a comma when inside a brace.
+# How to indent a comma when inside braces.
-# If true, aligns under the open brace.
+#  0: Indent by one level (default)
-indent_comma_brace              = false    # true/false
+#  1: Align under the open brace
+# -1: Preserve original indentation
+indent_comma_brace              = 0        # number
 
-# Whether to indent a comma when inside a parenthesis.
+# How to indent a comma when inside parentheses.
-# If true, aligns under the open parenthesis.
+#  0: Indent by one level (default)
-indent_comma_paren              = true     # true/false
+#  1: Align under the open parenthesis
+# -1: Preserve original indentation
+indent_comma_paren              = 1        # number
 
-# Whether to indent a Boolean operator when inside a parenthesis.
+# How to indent a Boolean operator when inside parentheses.
-# If true, aligns under the open parenthesis.
+#  0: Indent by one level (default)
-indent_bool_paren               = false    # true/false
+#  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=true.
+# if indent_bool_paren=1.
 indent_first_bool_expr          = false    # true/false
 
 # Whether to align the first expression to following ones
@@ -1382,6 +1439,9 @@ 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.
 #
@@ -1982,7 +2042,8 @@ nl_after_semicolon              = false    # true/false
 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.
+# 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
@@ -2222,7 +2283,7 @@ nl_after_func_body_one_liner    = 0        # unsigned number
 # of a function body.
 #
 # 0: No change (default).
-nl_func_var_def_blk             = 0        # unsigned number
+nl_func_var_def_blk             = 1        # unsigned number
 
 # The number of newlines before a block of typedefs. If nl_after_access_spec
 # is non-zero, that option takes precedence.
@@ -2233,22 +2294,22 @@ 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
+nl_typedef_blk_end              = 1        # 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
+# The number of empty newlines before a block of variable definitions
-# of a function body. If nl_after_access_spec is non-zero, that option takes
+# not at the top of a function body. If nl_after_access_spec is non-zero,
-# precedence.
+# that option takes precedence.
 #
 # 0: No change (default).
-nl_var_def_blk_start            = 0        # unsigned number
+nl_var_def_blk_start            = 1        # unsigned number
 
-# The number of newlines after a block of variable definitions not at the top
+# The number of empty newlines after a block of variable definitions
-# of a function body.
+# not at the top of a function body.
 #
 # 0: No change (default).
 nl_var_def_blk_end              = 0        # unsigned number
@@ -2278,13 +2339,13 @@ nl_after_multiline_comment      = false    # true/false
 nl_after_label_colon            = false    # true/false
 
 # The number of newlines before a struct definition.
-nl_before_struct                = 0        # unsigned number
+nl_before_struct                = 1        # 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
+nl_before_class                 = 1        # unsigned number
 
 # The number of newlines after '}' or ';' of a class definition.
 nl_after_class                  = 0        # unsigned number
@@ -2564,6 +2625,11 @@ align_var_def_inline            = false    # true/false
 # 0: Don't align (default).
 align_assign_span               = 1        # unsigned number
 
+# The span for aligning on '{' in braced init list.
+#
+# 0: Don't align (default).
+align_braced_init_list_span     = 0        # unsigned number
+
 # The span for aligning on '=' in function prototype modifier.
 #
 # 0: Don't align (default).
@@ -2575,6 +2641,17 @@ align_assign_func_proto_span    = 1        # unsigned number
 # 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  = true     # true/false
+
+# 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}'.
 #
@@ -2780,7 +2857,7 @@ 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)
+# alignment)
 align_oc_msg_colon_xcode_like   = false    # true/false
 
 #
@@ -2840,7 +2917,7 @@ cmt_convert_tab_to_spaces       = false    # true/false
 # keyword substitution and leading chars.
 #
 # Default: true
-cmt_indent_multi                = true     # true/false
+cmt_indent_multi                = false    # true/false
 
 # Whether to align doxygen javadoc-style tags ('@param', '@return', etc.)
 # and corresponding fields such that groups of consecutive block tags,
@@ -2848,7 +2925,7 @@ cmt_indent_multi                = true     # true/false
 # 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
+cmt_align_doxygen_javadoc_tags  = true     # true/false
 
 # The number of spaces to insert after the star and before doxygen
 # javadoc-style tags (@param, @return, etc). Requires enabling
@@ -2859,7 +2936,7 @@ cmt_align_doxygen_javadoc_tags  = false    # true/false
 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
+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
@@ -2890,10 +2967,10 @@ cmt_cpp_nl_start                = false    # true/false
 cmt_cpp_nl_end                  = false    # true/false
 
 # Whether to put a star on subsequent comment lines.
-cmt_star_cont                   = true     # true/false
+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
+cmt_sp_before_star_cont         = 1        # unsigned number
 
 # The number of spaces to insert after the star on subsequent comment lines.
 cmt_sp_after_star_cont          = 1        # unsigned number
@@ -2980,12 +3057,17 @@ mod_full_brace_function         = ignore   # ignore/add/remove/force/not_defined
 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. If true, braces will be added if any block
+# have, or do not have, braces. Overrides mod_full_brace_if.
-# needs braces, and will only be removed if they can be removed from all
-# blocks.
 #
-# Overrides mod_full_brace_if.
+# 0: Don't override mod_full_brace_if
-mod_full_brace_if_chain         = false    # true/false
+# 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
@@ -3027,6 +3109,14 @@ mod_pawn_semicolon              = false    # true/false
 # statement, as in 'if (a && b > c)' => 'if (a && (b > c))'.
 mod_full_paren_if_bool          = true     # 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      = true     # 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      = true     # true/false
+
 # Whether to remove superfluous semicolons.
 mod_remove_extra_semicolon      = true     # true/false
 
@@ -3094,6 +3184,10 @@ mod_sort_incl_import_grouping_enabled = false    # true/false
 # 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
@@ -3144,6 +3238,10 @@ pp_indent                       = ignore   # ignore/add/remove/force/not_defined
 # indented from column 1.
 pp_indent_at_level              = true     # 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
@@ -3209,12 +3307,37 @@ pp_indent_func_def              = true     # true/false
 # Default: true
 pp_indent_extern                = true     # true/false
 
-# Whether to indent braces directly inside #if, #else, and #endif.
+# How to indent braces directly inside #if, #else, and #endif.
-# Only applies to the indent of the preprocesser that the braces are directly
+# Requires pp_if_indent_code=true and only applies to the indent of the
-# inside of.
+# preprocesser that the braces are directly inside of.
+#  0: No extra indent
+#  1: Indent by one level
+# -1: Preserve original indentation
 #
-# Default: true
+# Default: 1
-pp_indent_brace                 = true     # true/false
+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
@@ -3253,17 +3376,16 @@ use_indent_func_call_param      = true     # true/false
 #
 # 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 value might be used twice:
+# The indentation can be:
-# - at the assignment
+# - after the assignment, at the '[' character
-# - at the opening brace
+# - at the begin of the lambda body
 #
-# To prevent the double use of the indentation value, use this option with the
+# true:  indentation will be after the assignment
-# value 'true'.
+# false: indentation will be at the begin of the lambda body (default)
-#
-# true:  indentation will be used only once
-# 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
@@ -3367,5 +3489,5 @@ debug_truncate                  = 0        # unsigned number
 #       `macro-close END_MESSAGE_MAP`
 #
 #
-# option(s) with 'not default' value: 193
+# option(s) with 'not default' value: 214
 #