1# Uncrustify-0.72.0-102-b22264bf 2 3# 4# General options 5# 6 7# The type of line endings. 8# 9# Default: auto 10newlines = auto # lf/crlf/cr/auto 11 12# The original size of tabs in the input. 13# 14# Default: 8 15input_tab_size = 2 # unsigned number 16 17# The size of tabs in the output (only used if align_with_tabs=true). 18# 19# Default: 8 20output_tab_size = 2 # unsigned number 21 22# The ASCII value of the string escape char, usually 92 (\) or (Pawn) 94 (^). 23# 24# Default: 92 25string_escape_char = 92 # unsigned number 26 27# Alternate string escape char (usually only used for Pawn). 28# Only works right before the quote char. 29string_escape_char2 = 0 # unsigned number 30 31# Replace tab characters found in string literals with the escape sequence \t 32# instead. 33string_replace_tab_chars = false # true/false 34 35# Allow interpreting '>=' and '>>=' as part of a template in code like 36# 'void f(list<list<B>>=val);'. If true, 'assert(x<0 && y>=3)' will be broken. 37# Improvements to template detection may make this option obsolete. 38tok_split_gte = false # true/false 39 40# Disable formatting of NL_CONT ('\\n') ended lines (e.g. multiline macros) 41disable_processing_nl_cont = false # true/false 42 43# Specify the marker used in comments to disable processing of part of the 44# file. 45# 46# Default: *INDENT-OFF* 47disable_processing_cmt = " *INDENT-OFF*" # string 48 49# Specify the marker used in comments to (re)enable processing in a file. 50# 51# Default: *INDENT-ON* 52enable_processing_cmt = " *INDENT-ON*" # string 53 54# Enable parsing of digraphs. 55enable_digraphs = false # true/false 56 57# Option to allow both disable_processing_cmt and enable_processing_cmt strings, 58# if specified, to be interpreted as ECMAScript regular expressions. If true, 59# a regex search will be performed within comments according to the specified 60# patterns in order to disable/enable processing 61processing_cmt_as_regex = false # true/false 62 63# Add or remove the UTF-8 BOM (recommend 'remove'). 64utf8_bom = remove # ignore/add/remove/force 65 66# If the file contains bytes with values between 128 and 255, but is not 67# UTF-8, then output as UTF-8. 68utf8_byte = false # true/false 69 70# Force the output encoding to UTF-8. 71utf8_force = false # true/false 72 73# Add or remove space between 'do' and '{'. 74sp_do_brace_open = add # ignore/add/remove/force 75 76# Add or remove space between '}' and 'while'. 77sp_brace_close_while = add # ignore/add/remove/force 78 79# Add or remove space between 'while' and '('. 80sp_while_paren_open = add # ignore/add/remove/force 81 82# 83# Spacing options 84# 85 86# Add or remove space around non-assignment symbolic operators ('+', '/', '%', 87# '<<', and so forth). 88sp_arith = force # ignore/add/remove/force 89 90# Add or remove space around arithmetic operators '+' and '-'. 91# 92# Overrides sp_arith. 93sp_arith_additive = ignore # ignore/add/remove/force 94 95# Add or remove space around assignment operator '=', '+=', etc. 96sp_assign = force # ignore/add/remove/force 97 98# Add or remove space around '=' in C++11 lambda capture specifications. 99# 100# Overrides sp_assign. 101sp_cpp_lambda_assign = ignore # ignore/add/remove/force 102 103# Add or remove space after the capture specification of a C++11 lambda when 104# an argument list is present, as in '[] <here> (int x){ ... }'. 105sp_cpp_lambda_square_paren = ignore # ignore/add/remove/force 106 107# Add or remove space after the capture specification of a C++11 lambda with 108# no argument list is present, as in '[] <here> { ... }'. 109sp_cpp_lambda_square_brace = ignore # ignore/add/remove/force 110 111# Add or remove space after the argument list of a C++11 lambda, as in 112# '[](int x) <here> { ... }'. 113sp_cpp_lambda_paren_brace = ignore # ignore/add/remove/force 114 115# Add or remove space between a lambda body and its call operator of an 116# immediately invoked lambda, as in '[]( ... ){ ... } <here> ( ... )'. 117sp_cpp_lambda_fparen = ignore # ignore/add/remove/force 118 119# Add or remove space around assignment operator '=' in a prototype. 120# 121# If set to ignore, use sp_assign. 122sp_assign_default = ignore # ignore/add/remove/force 123 124# Add or remove space before assignment operator '=', '+=', etc. 125# 126# Overrides sp_assign. 127sp_before_assign = ignore # ignore/add/remove/force 128 129# Add or remove space after assignment operator '=', '+=', etc. 130# 131# Overrides sp_assign. 132sp_after_assign = ignore # ignore/add/remove/force 133 134# Add or remove space in 'NS_ENUM ('. 135sp_enum_paren = ignore # ignore/add/remove/force 136 137# Add or remove space around assignment '=' in enum. 138sp_enum_assign = ignore # ignore/add/remove/force 139 140# Add or remove space before assignment '=' in enum. 141# 142# Overrides sp_enum_assign. 143sp_enum_before_assign = ignore # ignore/add/remove/force 144 145# Add or remove space after assignment '=' in enum. 146# 147# Overrides sp_enum_assign. 148sp_enum_after_assign = ignore # ignore/add/remove/force 149 150# Add or remove space around assignment ':' in enum. 151sp_enum_colon = ignore # ignore/add/remove/force 152 153# Add or remove space around preprocessor '##' concatenation operator. 154# 155# Default: add 156sp_pp_concat = add # ignore/add/remove/force 157 158# Add or remove space after preprocessor '#' stringify operator. 159# Also affects the '#@' charizing operator. 160sp_pp_stringify = remove # ignore/add/remove/force 161 162# Add or remove space before preprocessor '#' stringify operator 163# as in '#define x(y) L#y'. 164sp_before_pp_stringify = remove # ignore/add/remove/force 165 166# Add or remove space around boolean operators '&&' and '||'. 167sp_bool = force # ignore/add/remove/force 168 169# Add or remove space around compare operator '<', '>', '==', etc. 170sp_compare = force # ignore/add/remove/force 171 172# Add or remove space inside '(' and ')'. 173sp_inside_paren = remove # ignore/add/remove/force 174 175# Add or remove space between nested parentheses, i.e. '((' vs. ') )'. 176sp_paren_paren = ignore # ignore/add/remove/force 177 178# Add or remove space between back-to-back parentheses, i.e. ')(' vs. ') ('. 179sp_cparen_oparen = add # ignore/add/remove/force 180 181# Whether to balance spaces inside nested parentheses. 182sp_balance_nested_parens = false # true/false 183 184# Add or remove space between ')' and '{'. 185sp_paren_brace = force # ignore/add/remove/force 186 187# Add or remove space between nested braces, i.e. '{{' vs '{ {'. 188sp_brace_brace = remove # ignore/add/remove/force 189 190# Add or remove space before pointer star '*'. 191sp_before_ptr_star = force # ignore/add/remove/force 192 193# Add or remove space before pointer star '*' that isn't followed by a 194# variable name. If set to ignore, sp_before_ptr_star is used instead. 195sp_before_unnamed_ptr_star = remove # ignore/add/remove/force 196 197# Add or remove space between pointer stars '*'. 198sp_between_ptr_star = remove # ignore/add/remove/force 199 200# Add or remove space after pointer star '*', if followed by a word. 201# 202# Overrides sp_type_func. 203sp_after_ptr_star = remove # ignore/add/remove/force 204 205# Add or remove space after pointer caret '^', if followed by a word. 206sp_after_ptr_block_caret = ignore # ignore/add/remove/force 207 208# Add or remove space after pointer star '*', if followed by a qualifier. 209sp_after_ptr_star_qualifier = force # ignore/add/remove/force 210 211# Add or remove space after a pointer star '*', if followed by a function 212# prototype or function definition. 213# 214# Overrides sp_after_ptr_star and sp_type_func. 215sp_after_ptr_star_func = remove # ignore/add/remove/force 216 217# Add or remove space after a pointer star '*', if followed by an open 218# parenthesis, as in 'void* (*)(). 219sp_ptr_star_paren = force # ignore/add/remove/force 220 221# Add or remove space before a pointer star '*', if followed by a function 222# prototype or function definition. 223sp_before_ptr_star_func = force # ignore/add/remove/force 224 225# Add or remove space before a reference sign '&'. 226sp_before_byref = ignore # ignore/add/remove/force 227 228# Add or remove space before a reference sign '&' that isn't followed by a 229# variable name. If set to ignore, sp_before_byref is used instead. 230sp_before_unnamed_byref = ignore # ignore/add/remove/force 231 232# Add or remove space after reference sign '&', if followed by a word. 233# 234# Overrides sp_type_func. 235sp_after_byref = ignore # ignore/add/remove/force 236 237# Add or remove space after a reference sign '&', if followed by a function 238# prototype or function definition. 239# 240# Overrides sp_after_byref and sp_type_func. 241sp_after_byref_func = ignore # ignore/add/remove/force 242 243# Add or remove space before a reference sign '&', if followed by a function 244# prototype or function definition. 245sp_before_byref_func = ignore # ignore/add/remove/force 246 247# Add or remove space between type and word. In cases where total removal of 248# whitespace would be a syntax error, a value of 'remove' is treated the same 249# as 'force'. 250# 251# This also affects some other instances of space following a type that are 252# not covered by other options; for example, between the return type and 253# parenthesis of a function type template argument, between the type and 254# parenthesis of an array parameter, or between 'decltype(...)' and the 255# following word. 256# 257# Default: force 258sp_after_type = force # ignore/add/remove/force 259 260# Add or remove space between 'decltype(...)' and word. 261# 262# Overrides sp_after_type. 263sp_after_decltype = ignore # ignore/add/remove/force 264 265# (D) Add or remove space before the parenthesis in the D constructs 266# 'template Foo(' and 'class Foo('. 267sp_before_template_paren = ignore # ignore/add/remove/force 268 269# Add or remove space between 'template' and '<'. 270# If set to ignore, sp_before_angle is used. 271sp_template_angle = ignore # ignore/add/remove/force 272 273# Add or remove space before '<'. 274sp_before_angle = ignore # ignore/add/remove/force 275 276# Add or remove space inside '<' and '>'. 277sp_inside_angle = ignore # ignore/add/remove/force 278 279# Add or remove space inside '<>'. 280sp_inside_angle_empty = ignore # ignore/add/remove/force 281 282# Add or remove space between '>' and ':'. 283sp_angle_colon = ignore # ignore/add/remove/force 284 285# Add or remove space after '>'. 286sp_after_angle = ignore # ignore/add/remove/force 287 288# Add or remove space between '>' and '(' as found in 'new List<byte>(foo);'. 289sp_angle_paren = ignore # ignore/add/remove/force 290 291# Add or remove space between '>' and '()' as found in 'new List<byte>();'. 292sp_angle_paren_empty = ignore # ignore/add/remove/force 293 294# Add or remove space between '>' and a word as in 'List<byte> m;' or 295# 'template <typename T> static ...'. 296sp_angle_word = ignore # ignore/add/remove/force 297 298# Add or remove space between '>' and '>' in '>>' (template stuff). 299# 300# Default: add 301sp_angle_shift = add # ignore/add/remove/force 302 303# (C++11) Permit removal of the space between '>>' in 'foo<bar<int> >'. Note 304# that sp_angle_shift cannot remove the space without this option. 305sp_permit_cpp11_shift = false # true/false 306 307# Add or remove space before '(' of control statements ('if', 'for', 'switch', 308# 'while', etc.). 309sp_before_sparen = force # ignore/add/remove/force 310 311# Add or remove space inside '(' and ')' of control statements. 312sp_inside_sparen = remove # ignore/add/remove/force 313 314# Add or remove space after '(' of control statements. 315# 316# Overrides sp_inside_sparen. 317sp_inside_sparen_open = ignore # ignore/add/remove/force 318 319# Add or remove space before ')' of control statements. 320# 321# Overrides sp_inside_sparen. 322sp_inside_sparen_close = ignore # ignore/add/remove/force 323 324# Add or remove space after ')' of control statements. 325sp_after_sparen = force # ignore/add/remove/force 326 327# Add or remove space between ')' and '{' of of control statements. 328sp_sparen_brace = force # ignore/add/remove/force 329 330# (D) Add or remove space between 'invariant' and '('. 331sp_invariant_paren = ignore # ignore/add/remove/force 332 333# (D) Add or remove space after the ')' in 'invariant (C) c'. 334sp_after_invariant_paren = ignore # ignore/add/remove/force 335 336# Add or remove space before empty statement ';' on 'if', 'for' and 'while'. 337sp_special_semi = add # ignore/add/remove/force 338 339# Add or remove space before ';'. 340# 341# Default: remove 342sp_before_semi = remove # ignore/add/remove/force 343 344# Add or remove space before ';' in non-empty 'for' statements. 345sp_before_semi_for = remove # ignore/add/remove/force 346 347# Add or remove space before a semicolon of an empty part of a for statement. 348sp_before_semi_for_empty = add # ignore/add/remove/force 349 350# Add or remove space after ';', except when followed by a comment. 351# 352# Default: add 353sp_after_semi = add # ignore/add/remove/force 354 355# Add or remove space after ';' in non-empty 'for' statements. 356# 357# Default: force 358sp_after_semi_for = force # ignore/add/remove/force 359 360# Add or remove space after the final semicolon of an empty part of a for 361# statement, as in 'for ( ; ; <here> )'. 362sp_after_semi_for_empty = add # ignore/add/remove/force 363 364# Add or remove space before '[' (except '[]'). 365sp_before_square = ignore # ignore/add/remove/force 366 367# Add or remove space before '[' for a variable definition. 368# 369# Default: remove 370sp_before_vardef_square = remove # ignore/add/remove/force 371 372# Add or remove space before '[' for asm block. 373sp_before_square_asm_block = ignore # ignore/add/remove/force 374 375# Add or remove space before '[]'. 376sp_before_squares = ignore # ignore/add/remove/force 377 378# Add or remove space before C++17 structured bindings. 379sp_cpp_before_struct_binding = ignore # ignore/add/remove/force 380 381# Add or remove space inside a non-empty '[' and ']'. 382sp_inside_square = ignore # ignore/add/remove/force 383 384# Add or remove space inside '[]'. 385sp_inside_square_empty = remove # ignore/add/remove/force 386 387# (OC) Add or remove space inside a non-empty Objective-C boxed array '@[' and 388# ']'. If set to ignore, sp_inside_square is used. 389sp_inside_square_oc_array = ignore # ignore/add/remove/force 390 391# Add or remove space after ',', i.e. 'a,b' vs. 'a, b'. 392sp_after_comma = force # ignore/add/remove/force 393 394# Add or remove space before ','. 395# 396# Default: remove 397sp_before_comma = remove # ignore/add/remove/force 398 399# (C#) Add or remove space between ',' and ']' in multidimensional array type 400# like 'int[,,]'. 401sp_after_mdatype_commas = ignore # ignore/add/remove/force 402 403# (C#) Add or remove space between '[' and ',' in multidimensional array type 404# like 'int[,,]'. 405sp_before_mdatype_commas = ignore # ignore/add/remove/force 406 407# (C#) Add or remove space between ',' in multidimensional array type 408# like 'int[,,]'. 409sp_between_mdatype_commas = ignore # ignore/add/remove/force 410 411# Add or remove space between an open parenthesis and comma, 412# i.e. '(,' vs. '( ,'. 413# 414# Default: force 415sp_paren_comma = force # ignore/add/remove/force 416 417# Add or remove space before the variadic '...' when preceded by a 418# non-punctuator. 419sp_before_ellipsis = force # ignore/add/remove/force 420 421# Add or remove space between a type and '...'. 422sp_type_ellipsis = ignore # ignore/add/remove/force 423 424# (D) Add or remove space between a type and '?'. 425sp_type_question = ignore # ignore/add/remove/force 426 427# Add or remove space between ')' and '...'. 428sp_paren_ellipsis = remove # ignore/add/remove/force 429 430# Add or remove space between ')' and a qualifier such as 'const'. 431sp_paren_qualifier = ignore # ignore/add/remove/force 432 433# Add or remove space between ')' and 'noexcept'. 434sp_paren_noexcept = ignore # ignore/add/remove/force 435 436# Add or remove space after class ':'. 437sp_after_class_colon = ignore # ignore/add/remove/force 438 439# Add or remove space before class ':'. 440sp_before_class_colon = ignore # ignore/add/remove/force 441 442# Add or remove space after class constructor ':'. 443sp_after_constr_colon = ignore # ignore/add/remove/force 444 445# Add or remove space before class constructor ':'. 446sp_before_constr_colon = ignore # ignore/add/remove/force 447 448# Add or remove space before case ':'. 449# 450# Default: remove 451sp_before_case_colon = remove # ignore/add/remove/force 452 453# Add or remove space between 'operator' and operator sign. 454sp_after_operator = ignore # ignore/add/remove/force 455 456# Add or remove space between the operator symbol and the open parenthesis, as 457# in 'operator ++('. 458sp_after_operator_sym = ignore # ignore/add/remove/force 459 460# Overrides sp_after_operator_sym when the operator has no arguments, as in 461# 'operator *()'. 462sp_after_operator_sym_empty = ignore # ignore/add/remove/force 463 464# Add or remove space after C/D cast, i.e. 'cast(int)a' vs. 'cast(int) a' or 465# '(int)a' vs. '(int) a'. 466sp_after_cast = force # ignore/add/remove/force 467 468# Add or remove spaces inside cast parentheses. 469sp_inside_paren_cast = remove # ignore/add/remove/force 470 471# Add or remove space between the type and open parenthesis in a C++ cast, 472# i.e. 'int(exp)' vs. 'int (exp)'. 473sp_cpp_cast_paren = remove # ignore/add/remove/force 474 475# Add or remove space between 'sizeof' and '('. 476sp_sizeof_paren = remove # ignore/add/remove/force 477 478# Add or remove space between 'sizeof' and '...'. 479sp_sizeof_ellipsis = ignore # ignore/add/remove/force 480 481# Add or remove space between 'sizeof...' and '('. 482sp_sizeof_ellipsis_paren = ignore # ignore/add/remove/force 483 484# Add or remove space between 'decltype' and '('. 485sp_decltype_paren = ignore # ignore/add/remove/force 486 487# (Pawn) Add or remove space after the tag keyword. 488sp_after_tag = ignore # ignore/add/remove/force 489 490# Add or remove space inside enum '{' and '}'. 491sp_inside_braces_enum = force # ignore/add/remove/force 492 493# Add or remove space inside struct/union '{' and '}'. 494sp_inside_braces_struct = force # ignore/add/remove/force 495 496# (OC) Add or remove space inside Objective-C boxed dictionary '{' and '}' 497sp_inside_braces_oc_dict = ignore # ignore/add/remove/force 498 499# Add or remove space after open brace in an unnamed temporary 500# direct-list-initialization. 501sp_after_type_brace_init_lst_open = ignore # ignore/add/remove/force 502 503# Add or remove space before close brace in an unnamed temporary 504# direct-list-initialization. 505sp_before_type_brace_init_lst_close = ignore # ignore/add/remove/force 506 507# Add or remove space inside an unnamed temporary direct-list-initialization. 508sp_inside_type_brace_init_lst = ignore # ignore/add/remove/force 509 510# Add or remove space inside '{' and '}'. 511sp_inside_braces = force # ignore/add/remove/force 512 513# Add or remove space inside '{}'. 514sp_inside_braces_empty = remove # ignore/add/remove/force 515 516# Add or remove space around trailing return operator '->'. 517sp_trailing_return = ignore # ignore/add/remove/force 518 519# Add or remove space between return type and function name. A minimum of 1 520# is forced except for pointer return types. 521sp_type_func = force # ignore/add/remove/force 522 523# Add or remove space between type and open brace of an unnamed temporary 524# direct-list-initialization. 525sp_type_brace_init_lst = ignore # ignore/add/remove/force 526 527# Add or remove space between function name and '(' on function declaration. 528sp_func_proto_paren = remove # ignore/add/remove/force 529 530# Add or remove space between function name and '()' on function declaration 531# without parameters. 532sp_func_proto_paren_empty = ignore # ignore/add/remove/force 533 534# Add or remove space between function name and '(' with a typedef specifier. 535sp_func_type_paren = remove # ignore/add/remove/force 536 537# Add or remove space between alias name and '(' of a non-pointer function type typedef. 538sp_func_def_paren = remove # ignore/add/remove/force 539 540# Add or remove space between function name and '()' on function definition 541# without parameters. 542sp_func_def_paren_empty = remove # ignore/add/remove/force 543 544# Add or remove space inside empty function '()'. 545# Overrides sp_after_angle unless use_sp_after_angle_always is set to true. 546sp_inside_fparens = remove # ignore/add/remove/force 547 548# Add or remove space inside function '(' and ')'. 549sp_inside_fparen = remove # ignore/add/remove/force 550 551# Add or remove space inside the first parentheses in a function type, as in 552# 'void (*x)(...)'. 553sp_inside_tparen = remove # ignore/add/remove/force 554 555# Add or remove space between the ')' and '(' in a function type, as in 556# 'void (*x)(...)'. 557sp_after_tparen_close = remove # ignore/add/remove/force 558 559# Add or remove space between ']' and '(' when part of a function call. 560sp_square_fparen = remove # ignore/add/remove/force 561 562# Add or remove space between ')' and '{' of function. 563sp_fparen_brace = force # ignore/add/remove/force 564 565# Add or remove space between ')' and '{' of a function call in object 566# initialization. 567# 568# Overrides sp_fparen_brace. 569sp_fparen_brace_initializer = force # ignore/add/remove/force 570 571# (Java) Add or remove space between ')' and '{{' of double brace initializer. 572sp_fparen_dbrace = ignore # ignore/add/remove/force 573 574# Add or remove space between function name and '(' on function calls. 575sp_func_call_paren = remove # ignore/add/remove/force 576 577# Add or remove space between function name and '()' on function calls without 578# parameters. If set to ignore (the default), sp_func_call_paren is used. 579sp_func_call_paren_empty = remove # ignore/add/remove/force 580 581# Add or remove space between the user function name and '(' on function 582# calls. You need to set a keyword to be a user function in the config file, 583# like: 584# set func_call_user tr _ i18n 585sp_func_call_user_paren = ignore # ignore/add/remove/force 586 587# Add or remove space inside user function '(' and ')'. 588sp_func_call_user_inside_fparen = ignore # ignore/add/remove/force 589 590# Add or remove space between nested parentheses with user functions, 591# i.e. '((' vs. '( ('. 592sp_func_call_user_paren_paren = ignore # ignore/add/remove/force 593 594# Add or remove space between a constructor/destructor and the open 595# parenthesis. 596sp_func_class_paren = remove # ignore/add/remove/force 597 598# Add or remove space between a constructor without parameters or destructor 599# and '()'. 600sp_func_class_paren_empty = ignore # ignore/add/remove/force 601 602# Add or remove space between 'return' and '('. 603sp_return_paren = force # ignore/add/remove/force 604 605# Add or remove space between 'return' and '{'. 606sp_return_brace = force # ignore/add/remove/force 607 608# Add or remove space between '__attribute__' and '('. 609sp_attribute_paren = remove # ignore/add/remove/force 610 611# Add or remove space between 'defined' and '(' in '#if defined (FOO)'. 612sp_defined_paren = remove # ignore/add/remove/force 613 614# Add or remove space between 'throw' and '(' in 'throw (something)'. 615sp_throw_paren = force # ignore/add/remove/force 616 617# Add or remove space between 'throw' and anything other than '(' as in 618# '@throw [...];'. 619sp_after_throw = force # ignore/add/remove/force 620 621# Add or remove space between 'catch' and '(' in 'catch (something) { }'. 622# If set to ignore, sp_before_sparen is used. 623sp_catch_paren = remove # ignore/add/remove/force 624 625# (OC) Add or remove space between '@catch' and '(' 626# in '@catch (something) { }'. If set to ignore, sp_catch_paren is used. 627sp_oc_catch_paren = ignore # ignore/add/remove/force 628 629# (OC) Add or remove space before Objective-C protocol list 630# as in '@protocol Protocol<here><Protocol_A>' or '@interface MyClass : NSObject<here><MyProtocol>'. 631sp_before_oc_proto_list = ignore # ignore/add/remove/force 632 633# (OC) Add or remove space between class name and '(' 634# in '@interface className(categoryName)<ProtocolName>:BaseClass' 635sp_oc_classname_paren = ignore # ignore/add/remove/force 636 637# (D) Add or remove space between 'version' and '(' 638# in 'version (something) { }'. If set to ignore, sp_before_sparen is used. 639sp_version_paren = ignore # ignore/add/remove/force 640 641# (D) Add or remove space between 'scope' and '(' 642# in 'scope (something) { }'. If set to ignore, sp_before_sparen is used. 643sp_scope_paren = ignore # ignore/add/remove/force 644 645# Add or remove space between 'super' and '(' in 'super (something)'. 646# 647# Default: remove 648sp_super_paren = remove # ignore/add/remove/force 649 650# Add or remove space between 'this' and '(' in 'this (something)'. 651# 652# Default: remove 653sp_this_paren = remove # ignore/add/remove/force 654 655# Add or remove space between a macro name and its definition. 656sp_macro = force # ignore/add/remove/force 657 658# Add or remove space between a macro function ')' and its definition. 659sp_macro_func = ignore # ignore/add/remove/force 660 661# Add or remove space between 'else' and '{' if on the same line. 662sp_else_brace = force # ignore/add/remove/force 663 664# Add or remove space between '}' and 'else' if on the same line. 665sp_brace_else = force # ignore/add/remove/force 666 667# Add or remove space between '}' and the name of a typedef on the same line. 668sp_brace_typedef = force # ignore/add/remove/force 669 670# Add or remove space before the '{' of a 'catch' statement, if the '{' and 671# 'catch' are on the same line, as in 'catch (decl) <here> {'. 672sp_catch_brace = ignore # ignore/add/remove/force 673 674# (OC) Add or remove space before the '{' of a '@catch' statement, if the '{' 675# and '@catch' are on the same line, as in '@catch (decl) <here> {'. 676# If set to ignore, sp_catch_brace is used. 677sp_oc_catch_brace = ignore # ignore/add/remove/force 678 679# Add or remove space between '}' and 'catch' if on the same line. 680sp_brace_catch = ignore # ignore/add/remove/force 681 682# (OC) Add or remove space between '}' and '@catch' if on the same line. 683# If set to ignore, sp_brace_catch is used. 684sp_oc_brace_catch = ignore # ignore/add/remove/force 685 686# Add or remove space between 'finally' and '{' if on the same line. 687sp_finally_brace = ignore # ignore/add/remove/force 688 689# Add or remove space between '}' and 'finally' if on the same line. 690sp_brace_finally = ignore # ignore/add/remove/force 691 692# Add or remove space between 'try' and '{' if on the same line. 693sp_try_brace = ignore # ignore/add/remove/force 694 695# Add or remove space between get/set and '{' if on the same line. 696sp_getset_brace = ignore # ignore/add/remove/force 697 698# Add or remove space between a variable and '{' for C++ uniform 699# initialization. 700sp_word_brace_init_lst = ignore # ignore/add/remove/force 701 702# Add or remove space between a variable and '{' for a namespace. 703# 704# Default: add 705sp_word_brace_ns = add # ignore/add/remove/force 706 707# Add or remove space before the '::' operator. 708sp_before_dc = ignore # ignore/add/remove/force 709 710# Add or remove space after the '::' operator. 711sp_after_dc = ignore # ignore/add/remove/force 712 713# (D) Add or remove around the D named array initializer ':' operator. 714sp_d_array_colon = ignore # ignore/add/remove/force 715 716# Add or remove space after the '!' (not) unary operator. 717# 718# Default: remove 719sp_not = remove # ignore/add/remove/force 720 721# Add or remove space after the '~' (invert) unary operator. 722# 723# Default: remove 724sp_inv = remove # ignore/add/remove/force 725 726# Add or remove space after the '&' (address-of) unary operator. This does not 727# affect the spacing after a '&' that is part of a type. 728# 729# Default: remove 730sp_addr = remove # ignore/add/remove/force 731 732# Add or remove space around the '.' or '->' operators. 733# 734# Default: remove 735sp_member = remove # ignore/add/remove/force 736 737# Add or remove space after the '*' (dereference) unary operator. This does 738# not affect the spacing after a '*' that is part of a type. 739# 740# Default: remove 741sp_deref = remove # ignore/add/remove/force 742 743# Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'. 744# 745# Default: remove 746sp_sign = remove # ignore/add/remove/force 747 748# Add or remove space between '++' and '--' the word to which it is being 749# applied, as in '(--x)' or 'y++;'. 750# 751# Default: remove 752sp_incdec = remove # ignore/add/remove/force 753 754# Add or remove space before a backslash-newline at the end of a line. 755# 756# Default: add 757sp_before_nl_cont = add # ignore/add/remove/force 758 759# (OC) Add or remove space after the scope '+' or '-', as in '-(void) foo;' 760# or '+(int) bar;'. 761sp_after_oc_scope = ignore # ignore/add/remove/force 762 763# (OC) Add or remove space after the colon in message specs, 764# i.e. '-(int) f:(int) x;' vs. '-(int) f: (int) x;'. 765sp_after_oc_colon = ignore # ignore/add/remove/force 766 767# (OC) Add or remove space before the colon in message specs, 768# i.e. '-(int) f: (int) x;' vs. '-(int) f : (int) x;'. 769sp_before_oc_colon = ignore # ignore/add/remove/force 770 771# (OC) Add or remove space after the colon in immutable dictionary expression 772# 'NSDictionary *test = @{@"foo" :@"bar"};'. 773sp_after_oc_dict_colon = ignore # ignore/add/remove/force 774 775# (OC) Add or remove space before the colon in immutable dictionary expression 776# 'NSDictionary *test = @{@"foo" :@"bar"};'. 777sp_before_oc_dict_colon = ignore # ignore/add/remove/force 778 779# (OC) Add or remove space after the colon in message specs, 780# i.e. '[object setValue:1];' vs. '[object setValue: 1];'. 781sp_after_send_oc_colon = ignore # ignore/add/remove/force 782 783# (OC) Add or remove space before the colon in message specs, 784# i.e. '[object setValue:1];' vs. '[object setValue :1];'. 785sp_before_send_oc_colon = ignore # ignore/add/remove/force 786 787# (OC) Add or remove space after the (type) in message specs, 788# i.e. '-(int)f: (int) x;' vs. '-(int)f: (int)x;'. 789sp_after_oc_type = ignore # ignore/add/remove/force 790 791# (OC) Add or remove space after the first (type) in message specs, 792# i.e. '-(int) f:(int)x;' vs. '-(int)f:(int)x;'. 793sp_after_oc_return_type = ignore # ignore/add/remove/force 794 795# (OC) Add or remove space between '@selector' and '(', 796# i.e. '@selector(msgName)' vs. '@selector (msgName)'. 797# Also applies to '@protocol()' constructs. 798sp_after_oc_at_sel = ignore # ignore/add/remove/force 799 800# (OC) Add or remove space between '@selector(x)' and the following word, 801# i.e. '@selector(foo) a:' vs. '@selector(foo)a:'. 802sp_after_oc_at_sel_parens = ignore # ignore/add/remove/force 803 804# (OC) Add or remove space inside '@selector' parentheses, 805# i.e. '@selector(foo)' vs. '@selector( foo )'. 806# Also applies to '@protocol()' constructs. 807sp_inside_oc_at_sel_parens = ignore # ignore/add/remove/force 808 809# (OC) Add or remove space before a block pointer caret, 810# i.e. '^int (int arg){...}' vs. ' ^int (int arg){...}'. 811sp_before_oc_block_caret = ignore # ignore/add/remove/force 812 813# (OC) Add or remove space after a block pointer caret, 814# i.e. '^int (int arg){...}' vs. '^ int (int arg){...}'. 815sp_after_oc_block_caret = ignore # ignore/add/remove/force 816 817# (OC) Add or remove space between the receiver and selector in a message, 818# as in '[receiver selector ...]'. 819sp_after_oc_msg_receiver = ignore # ignore/add/remove/force 820 821# (OC) Add or remove space after '@property'. 822sp_after_oc_property = ignore # ignore/add/remove/force 823 824# (OC) Add or remove space between '@synchronized' and the open parenthesis, 825# i.e. '@synchronized(foo)' vs. '@synchronized (foo)'. 826sp_after_oc_synchronized = ignore # ignore/add/remove/force 827 828# Add or remove space around the ':' in 'b ? t : f'. 829sp_cond_colon = force # ignore/add/remove/force 830 831# Add or remove space before the ':' in 'b ? t : f'. 832# 833# Overrides sp_cond_colon. 834sp_cond_colon_before = ignore # ignore/add/remove/force 835 836# Add or remove space after the ':' in 'b ? t : f'. 837# 838# Overrides sp_cond_colon. 839sp_cond_colon_after = ignore # ignore/add/remove/force 840 841# Add or remove space around the '?' in 'b ? t : f'. 842sp_cond_question = force # ignore/add/remove/force 843 844# Add or remove space before the '?' in 'b ? t : f'. 845# 846# Overrides sp_cond_question. 847sp_cond_question_before = ignore # ignore/add/remove/force 848 849# Add or remove space after the '?' in 'b ? t : f'. 850# 851# Overrides sp_cond_question. 852sp_cond_question_after = ignore # ignore/add/remove/force 853 854# In the abbreviated ternary form '(a ?: b)', add or remove space between '?' 855# and ':'. 856# 857# Overrides all other sp_cond_* options. 858sp_cond_ternary_short = remove # ignore/add/remove/force 859 860# Fix the spacing between 'case' and the label. Only 'ignore' and 'force' make 861# sense here. 862sp_case_label = force # ignore/add/remove/force 863 864# (D) Add or remove space around the D '..' operator. 865sp_range = ignore # ignore/add/remove/force 866 867# Add or remove space after ':' in a Java/C++11 range-based 'for', 868# as in 'for (Type var : <here> expr)'. 869sp_after_for_colon = ignore # ignore/add/remove/force 870 871# Add or remove space before ':' in a Java/C++11 range-based 'for', 872# as in 'for (Type var <here> : expr)'. 873sp_before_for_colon = ignore # ignore/add/remove/force 874 875# (D) Add or remove space between 'extern' and '(' as in 'extern <here> (C)'. 876sp_extern_paren = ignore # ignore/add/remove/force 877 878# Add or remove space after the opening of a C++ comment, as in '// <here> A'. 879sp_cmt_cpp_start = ignore # ignore/add/remove/force 880 881# Add or remove space in a C++ region marker comment, as in '// <here> BEGIN'. 882# A region marker is defined as a comment which is not preceded by other text 883# (i.e. the comment is the first non-whitespace on the line), and which starts 884# with either 'BEGIN' or 'END'. 885# 886# Overrides sp_cmt_cpp_start. 887sp_cmt_cpp_region = ignore # ignore/add/remove/force 888 889# If true, space added with sp_cmt_cpp_start will be added after Doxygen 890# sequences like '///', '///<', '//!' and '//!<'. 891sp_cmt_cpp_doxygen = false # true/false 892 893# If true, space added with sp_cmt_cpp_start will be added after Qt translator 894# or meta-data comments like '//:', '//=', and '//~'. 895sp_cmt_cpp_qttr = false # true/false 896 897# Add or remove space between #else or #endif and a trailing comment. 898sp_endif_cmt = ignore # ignore/add/remove/force 899 900# Add or remove space after 'new', 'delete' and 'delete[]'. 901sp_after_new = force # ignore/add/remove/force 902 903# Add or remove space between 'new' and '(' in 'new()'. 904sp_between_new_paren = ignore # ignore/add/remove/force 905 906# Add or remove space between ')' and type in 'new(foo) BAR'. 907sp_after_newop_paren = ignore # ignore/add/remove/force 908 909# Add or remove space inside parenthesis of the new operator 910# as in 'new(foo) BAR'. 911sp_inside_newop_paren = ignore # ignore/add/remove/force 912 913# Add or remove space after the open parenthesis of the new operator, 914# as in 'new(foo) BAR'. 915# 916# Overrides sp_inside_newop_paren. 917sp_inside_newop_paren_open = ignore # ignore/add/remove/force 918 919# Add or remove space before the close parenthesis of the new operator, 920# as in 'new(foo) BAR'. 921# 922# Overrides sp_inside_newop_paren. 923sp_inside_newop_paren_close = ignore # ignore/add/remove/force 924 925# Add or remove space before a trailing or embedded comment. 926sp_before_tr_emb_cmt = ignore # ignore/add/remove/force 927 928# Number of spaces before a trailing or embedded comment. 929sp_num_before_tr_emb_cmt = 0 # unsigned number 930 931# (Java) Add or remove space between an annotation and the open parenthesis. 932sp_annotation_paren = ignore # ignore/add/remove/force 933 934# If true, vbrace tokens are dropped to the previous token and skipped. 935sp_skip_vbrace_tokens = false # true/false 936 937# Add or remove space after 'noexcept'. 938sp_after_noexcept = ignore # ignore/add/remove/force 939 940# Add or remove space after '_'. 941sp_vala_after_translation = ignore # ignore/add/remove/force 942 943# If true, a <TAB> is inserted after #define. 944force_tab_after_define = false # true/false 945 946# 947# Indenting options 948# 949 950# The number of columns to indent per level. Usually 2, 3, 4, or 8. 951# 952# Default: 8 953indent_columns = 2 # unsigned number 954 955# The continuation indent. If non-zero, this overrides the indent of '(', '[' 956# and '=' continuation indents. Negative values are OK; negative value is 957# absolute and not increased for each '(' or '[' level. 958# 959# For FreeBSD, this is set to 4. 960indent_continue = 0 # number 961 962# The continuation indent, only for class header line(s). If non-zero, this 963# overrides the indent of 'class' continuation indents. 964indent_continue_class_head = 0 # unsigned number 965 966# Whether to indent empty lines (i.e. lines which contain only spaces before 967# the newline character). 968indent_single_newlines = false # true/false 969 970# The continuation indent for func_*_param if they are true. If non-zero, this 971# overrides the indent. 972indent_param = 0 # unsigned number 973 974# How to use tabs when indenting code. 975# 976# 0: Spaces only 977# 1: Indent with tabs to brace level, align with spaces (default) 978# 2: Indent and align with tabs, using spaces when not on a tabstop 979# 980# Default: 1 981indent_with_tabs = 0 # unsigned number 982 983# Whether to indent comments that are not at a brace level with tabs on a 984# tabstop. Requires indent_with_tabs=2. If false, will use spaces. 985indent_cmt_with_tabs = false # true/false 986 987# Whether to indent strings broken by '\' so that they line up. 988indent_align_string = false # true/false 989 990# The number of spaces to indent multi-line XML strings. 991# Requires indent_align_string=true. 992indent_xml_string = 0 # unsigned number 993 994# Spaces to indent '{' from level. 995indent_brace = 0 # unsigned number 996 997# Whether braces are indented to the body level. 998indent_braces = false # true/false 999 1000# Whether to disable indenting function braces if indent_braces=true. 1001indent_braces_no_func = false # true/false 1002 1003# Whether to disable indenting class braces if indent_braces=true. 1004indent_braces_no_class = false # true/false 1005 1006# Whether to disable indenting struct braces if indent_braces=true. 1007indent_braces_no_struct = false # true/false 1008 1009# Whether to indent based on the size of the brace parent, 1010# i.e. 'if' => 3 spaces, 'for' => 4 spaces, etc. 1011indent_brace_parent = false # true/false 1012 1013# Whether to indent based on the open parenthesis instead of the open brace 1014# in '({\n'. 1015indent_paren_open_brace = false # true/false 1016 1017# (C#) Whether to indent the brace of a C# delegate by another level. 1018indent_cs_delegate_brace = false # true/false 1019 1020# (C#) Whether to indent a C# delegate (to handle delegates with no brace) by 1021# another level. 1022indent_cs_delegate_body = false # true/false 1023 1024# Whether to indent the body of a 'namespace'. 1025indent_namespace = false # true/false 1026 1027# Whether to indent only the first namespace, and not any nested namespaces. 1028# Requires indent_namespace=true. 1029indent_namespace_single_indent = false # true/false 1030 1031# The number of spaces to indent a namespace block. 1032# If set to zero, use the value indent_columns 1033indent_namespace_level = 0 # unsigned number 1034 1035# If the body of the namespace is longer than this number, it won't be 1036# indented. Requires indent_namespace=true. 0 means no limit. 1037indent_namespace_limit = 0 # unsigned number 1038 1039# Whether the 'extern "C"' body is indented. 1040indent_extern = false # true/false 1041 1042# Whether the 'class' body is indented. 1043indent_class = false # true/false 1044 1045# Additional indent before the leading base class colon. 1046# Negative values decrease indent down to the first column. 1047# Requires a newline break before colon (see pos_class_colon 1048# and nl_class_colon) 1049indent_before_class_colon = 0 # number 1050 1051# Whether to indent the stuff after a leading base class colon. 1052indent_class_colon = false # true/false 1053 1054# Whether to indent based on a class colon instead of the stuff after the 1055# colon. Requires indent_class_colon=true. 1056indent_class_on_colon = false # true/false 1057 1058# Whether to indent the stuff after a leading class initializer colon. 1059indent_constr_colon = false # true/false 1060 1061# Virtual indent from the ':' for member initializers. 1062# 1063# Default: 2 1064indent_ctor_init_leading = 2 # unsigned number 1065 1066# Additional indent for constructor initializer list. 1067# Negative values decrease indent down to the first column. 1068indent_ctor_init = 0 # number 1069 1070# Whether to indent 'if' following 'else' as a new block under the 'else'. 1071# If false, 'else\nif' is treated as 'else if' for indenting purposes. 1072indent_else_if = false # true/false 1073 1074# Amount to indent variable declarations after a open brace. 1075# 1076# <0: Relative 1077# >=0: Absolute 1078indent_var_def_blk = 0 # number 1079 1080# Whether to indent continued variable declarations instead of aligning. 1081indent_var_def_cont = false # true/false 1082 1083# Whether to indent continued shift expressions ('<<' and '>>') instead of 1084# aligning. Set align_left_shift=false when enabling this. 1085indent_shift = false # true/false 1086 1087# Whether to force indentation of function definitions to start in column 1. 1088indent_func_def_force_col1 = false # true/false 1089 1090# Whether to indent continued function call parameters one indent level, 1091# rather than aligning parameters under the open parenthesis. 1092indent_func_call_param = false # true/false 1093 1094# Whether to indent continued function definition parameters one indent level, 1095# rather than aligning parameters under the open parenthesis. 1096indent_func_def_param = false # true/false 1097 1098# for function definitions, only if indent_func_def_param is false 1099# Allows to align params when appropriate and indent them when not 1100# behave as if it was true if paren position is more than this value 1101# if paren position is more than the option value 1102indent_func_def_param_paren_pos_threshold = 0 # unsigned number 1103 1104# Whether to indent continued function call prototype one indent level, 1105# rather than aligning parameters under the open parenthesis. 1106indent_func_proto_param = false # true/false 1107 1108# Whether to indent continued function call declaration one indent level, 1109# rather than aligning parameters under the open parenthesis. 1110indent_func_class_param = false # true/false 1111 1112# Whether to indent continued class variable constructors one indent level, 1113# rather than aligning parameters under the open parenthesis. 1114indent_func_ctor_var_param = false # true/false 1115 1116# Whether to indent continued template parameter list one indent level, 1117# rather than aligning parameters under the open parenthesis. 1118indent_template_param = false # true/false 1119 1120# Double the indent for indent_func_xxx_param options. 1121# Use both values of the options indent_columns and indent_param. 1122indent_func_param_double = false # true/false 1123 1124# Indentation column for standalone 'const' qualifier on a function 1125# prototype. 1126indent_func_const = 0 # unsigned number 1127 1128# Indentation column for standalone 'throw' qualifier on a function 1129# prototype. 1130indent_func_throw = 0 # unsigned number 1131 1132# How to indent within a macro followed by a brace on the same line 1133# This allows reducing the indent in macros that have (for example) 1134# `do { ... } while (0)` blocks bracketing them. 1135# 1136# true: add an indent for the brace on the same line as the macro 1137# false: do not add an indent for the brace on the same line as the macro 1138# 1139# Default: true 1140indent_macro_brace = true # true/false 1141 1142# The number of spaces to indent a continued '->' or '.'. 1143# Usually set to 0, 1, or indent_columns. 1144indent_member = indent_columns # unsigned number 1145 1146# Whether lines broken at '.' or '->' should be indented by a single indent. 1147# The indent_member option will not be effective if this is set to true. 1148indent_member_single = false # true/false 1149 1150# Spaces to indent single line ('//') comments on lines before code. 1151indent_sing_line_comments = 0 # unsigned number 1152 1153# When opening a paren for a control statement (if, for, while, etc), increase 1154# the indent level by this value. Negative values decrease the indent level. 1155indent_sparen_extra = 0 # number 1156 1157# Whether to indent trailing single line ('//') comments relative to the code 1158# instead of trying to keep the same absolute column. 1159indent_relative_single_line_comments = false # true/false 1160 1161# Spaces to indent 'case' from 'switch'. Usually 0 or indent_columns. 1162indent_switch_case = 2 # unsigned number 1163 1164# indent 'break' with 'case' from 'switch'. 1165indent_switch_break_with_case = false # true/false 1166 1167# Whether to indent preprocessor statements inside of switch statements. 1168# 1169# Default: true 1170indent_switch_pp = true # true/false 1171 1172# Spaces to shift the 'case' line, without affecting any other lines. 1173# Usually 0. 1174indent_case_shift = 0 # unsigned number 1175 1176# Spaces to indent '{' from 'case'. By default, the brace will appear under 1177# the 'c' in case. Usually set to 0 or indent_columns. Negative values are OK. 1178indent_case_brace = 0 # number 1179 1180# Whether to indent comments found in first column. 1181indent_col1_comment = false # true/false 1182 1183# Whether to indent multi string literal in first column. 1184indent_col1_multi_string_literal = false # true/false 1185 1186# How to indent goto labels. 1187# 1188# >0: Absolute column where 1 is the leftmost column 1189# <=0: Subtract from brace indent 1190# 1191# Default: 1 1192indent_label = 1 # number 1193 1194# How to indent access specifiers that are followed by a 1195# colon. 1196# 1197# >0: Absolute column where 1 is the leftmost column 1198# <=0: Subtract from brace indent 1199# 1200# Default: 1 1201indent_access_spec = 1 # number 1202 1203# Whether to indent the code after an access specifier by one level. 1204# If true, this option forces 'indent_access_spec=0'. 1205indent_access_spec_body = false # true/false 1206 1207# If an open parenthesis is followed by a newline, whether to indent the next 1208# line so that it lines up after the open parenthesis (not recommended). 1209indent_paren_nl = false # true/false 1210 1211# How to indent a close parenthesis after a newline. 1212# 1213# 0: Indent to body level (default) 1214# 1: Align under the open parenthesis 1215# 2: Indent to the brace level 1216indent_paren_close = 0 # unsigned number 1217 1218# Whether to indent the open parenthesis of a function definition, 1219# if the parenthesis is on its own line. 1220indent_paren_after_func_def = false # true/false 1221 1222# Whether to indent the open parenthesis of a function declaration, 1223# if the parenthesis is on its own line. 1224indent_paren_after_func_decl = false # true/false 1225 1226# Whether to indent the open parenthesis of a function call, 1227# if the parenthesis is on its own line. 1228indent_paren_after_func_call = false # true/false 1229 1230# Whether to indent a comma when inside a parenthesis. 1231# If true, aligns under the open parenthesis. 1232indent_comma_paren = false # true/false 1233 1234# Whether to indent a Boolean operator when inside a parenthesis. 1235# If true, aligns under the open parenthesis. 1236indent_bool_paren = true # true/false 1237 1238# Whether to indent a semicolon when inside a for parenthesis. 1239# If true, aligns under the open for parenthesis. 1240indent_semicolon_for_paren = false # true/false 1241 1242# Whether to align the first expression to following ones 1243# if indent_bool_paren=true. 1244indent_first_bool_expr = true # true/false 1245 1246# Whether to align the first expression to following ones 1247# if indent_semicolon_for_paren=true. 1248indent_first_for_expr = false # true/false 1249 1250# If an open square is followed by a newline, whether to indent the next line 1251# so that it lines up after the open square (not recommended). 1252indent_square_nl = false # true/false 1253 1254# (ESQL/C) Whether to preserve the relative indent of 'EXEC SQL' bodies. 1255indent_preserve_sql = false # true/false 1256 1257# Whether to align continued statements at the '='. If false or if the '=' is 1258# followed by a newline, the next line is indent one tab. 1259# 1260# Default: true 1261indent_align_assign = true # true/false 1262 1263# If true, the indentation of the chunks after a '=' sequence will be set at 1264# LHS token indentation column before '='. 1265indent_off_after_assign = false # true/false 1266 1267# Whether to align continued statements at the '('. If false or the '(' is 1268# followed by a newline, the next line indent is one tab. 1269# 1270# Default: true 1271indent_align_paren = true # true/false 1272 1273# (OC) Whether to indent Objective-C code inside message selectors. 1274indent_oc_inside_msg_sel = false # true/false 1275 1276# (OC) Whether to indent Objective-C blocks at brace level instead of usual 1277# rules. 1278indent_oc_block = false # true/false 1279 1280# (OC) Indent for Objective-C blocks in a message relative to the parameter 1281# name. 1282# 1283# =0: Use indent_oc_block rules 1284# >0: Use specified number of spaces to indent 1285indent_oc_block_msg = 0 # unsigned number 1286 1287# (OC) Minimum indent for subsequent parameters 1288indent_oc_msg_colon = 0 # unsigned number 1289 1290# (OC) Whether to prioritize aligning with initial colon (and stripping spaces 1291# from lines, if necessary). 1292# 1293# Default: true 1294indent_oc_msg_prioritize_first_colon = true # true/false 1295 1296# (OC) Whether to indent blocks the way that Xcode does by default 1297# (from the keyword if the parameter is on its own line; otherwise, from the 1298# previous indentation level). Requires indent_oc_block_msg=true. 1299indent_oc_block_msg_xcode_style = false # true/false 1300 1301# (OC) Whether to indent blocks from where the brace is, relative to a 1302# message keyword. Requires indent_oc_block_msg=true. 1303indent_oc_block_msg_from_keyword = false # true/false 1304 1305# (OC) Whether to indent blocks from where the brace is, relative to a message 1306# colon. Requires indent_oc_block_msg=true. 1307indent_oc_block_msg_from_colon = false # true/false 1308 1309# (OC) Whether to indent blocks from where the block caret is. 1310# Requires indent_oc_block_msg=true. 1311indent_oc_block_msg_from_caret = false # true/false 1312 1313# (OC) Whether to indent blocks from where the brace caret is. 1314# Requires indent_oc_block_msg=true. 1315indent_oc_block_msg_from_brace = false # true/false 1316 1317# When indenting after virtual brace open and newline add further spaces to 1318# reach this minimum indent. 1319indent_min_vbrace_open = 0 # unsigned number 1320 1321# Whether to add further spaces after regular indent to reach next tabstop 1322# when indenting after virtual brace open and newline. 1323indent_vbrace_open_on_tabstop = false # true/false 1324 1325# How to indent after a brace followed by another token (not a newline). 1326# true: indent all contained lines to match the token 1327# false: indent all contained lines to match the brace 1328# 1329# Default: true 1330indent_token_after_brace = true # true/false 1331 1332# Whether to indent the body of a C++11 lambda. 1333indent_cpp_lambda_body = false # true/false 1334 1335# How to indent compound literals that are being returned. 1336# true: add both the indent from return & the compound literal open brace (ie: 1337# 2 indent levels) 1338# false: only indent 1 level, don't add the indent for the open brace, only add 1339# the indent for the return. 1340# 1341# Default: true 1342indent_compound_literal_return = true # true/false 1343 1344# (C#) Whether to indent a 'using' block if no braces are used. 1345# 1346# Default: true 1347indent_using_block = true # true/false 1348 1349# How to indent the continuation of ternary operator. 1350# 1351# 0: Off (default) 1352# 1: When the `if_false` is a continuation, indent it under `if_false` 1353# 2: When the `:` is a continuation, indent it under `?` 1354indent_ternary_operator = 0 # unsigned number 1355 1356# Whether to indent the statments inside ternary operator. 1357indent_inside_ternary_operator = false # true/false 1358 1359# If true, the indentation of the chunks after a `return` sequence will be set at return indentation column. 1360indent_off_after_return = false # true/false 1361 1362# If true, the indentation of the chunks after a `return new` sequence will be set at return indentation column. 1363indent_off_after_return_new = false # true/false 1364 1365# If true, the tokens after return are indented with regular single indentation. By default (false) the indentation is after the return token. 1366indent_single_after_return = false # true/false 1367 1368# Whether to ignore indent and alignment for 'asm' blocks (i.e. assume they 1369# have their own indentation). 1370indent_ignore_asm_block = false # true/false 1371 1372# Don't indent the close parenthesis of a function definition, 1373# if the parenthesis is on its own line. 1374donot_indent_func_def_close_paren = false # true/false 1375 1376# 1377# Newline adding and removing options 1378# 1379 1380# Whether to collapse empty blocks between '{' and '}'. 1381# If true, overrides nl_inside_empty_func 1382nl_collapse_empty_body = false # true/false 1383 1384# Don't split one-line braced assignments, as in 'foo_t f = { 1, 2 };'. 1385nl_assign_leave_one_liners = true # true/false 1386 1387# Don't split one-line braced statements inside a 'class xx { }' body. 1388nl_class_leave_one_liners = false # true/false 1389 1390# Don't split one-line enums, as in 'enum foo { BAR = 15 };' 1391nl_enum_leave_one_liners = true # true/false 1392 1393# Don't split one-line get or set functions. 1394nl_getset_leave_one_liners = false # true/false 1395 1396# (C#) Don't split one-line property get or set functions. 1397nl_cs_property_leave_one_liners = false # true/false 1398 1399# Don't split one-line function definitions, as in 'int foo() { return 0; }'. 1400# might modify nl_func_type_name 1401nl_func_leave_one_liners = false # true/false 1402 1403# Don't split one-line C++11 lambdas, as in '[]() { return 0; }'. 1404nl_cpp_lambda_leave_one_liners = false # true/false 1405 1406# Don't split one-line if/else statements, as in 'if(...) b++;'. 1407nl_if_leave_one_liners = false # true/false 1408 1409# Don't split one-line while statements, as in 'while(...) b++;'. 1410nl_while_leave_one_liners = false # true/false 1411 1412# Don't split one-line for statements, as in 'for(...) b++;'. 1413nl_for_leave_one_liners = false # true/false 1414 1415# (OC) Don't split one-line Objective-C messages. 1416nl_oc_msg_leave_one_liner = false # true/false 1417 1418# (OC) Add or remove newline between method declaration and '{'. 1419nl_oc_mdef_brace = ignore # ignore/add/remove/force 1420 1421# (OC) Add or remove newline between Objective-C block signature and '{'. 1422nl_oc_block_brace = ignore # ignore/add/remove/force 1423 1424# (OC) Add or remove blank line before '@interface' statement. 1425nl_oc_before_interface = ignore # ignore/add/remove/force 1426 1427# (OC) Add or remove blank line before '@implementation' statement. 1428nl_oc_before_implementation = ignore # ignore/add/remove/force 1429 1430# (OC) Add or remove blank line before '@end' statement. 1431nl_oc_before_end = ignore # ignore/add/remove/force 1432 1433# (OC) Add or remove newline between '@interface' and '{'. 1434nl_oc_interface_brace = ignore # ignore/add/remove/force 1435 1436# (OC) Add or remove newline between '@implementation' and '{'. 1437nl_oc_implementation_brace = ignore # ignore/add/remove/force 1438 1439# Add or remove newlines at the start of the file. 1440nl_start_of_file = ignore # ignore/add/remove/force 1441 1442# The minimum number of newlines at the start of the file (only used if 1443# nl_start_of_file is 'add' or 'force'). 1444nl_start_of_file_min = 0 # unsigned number 1445 1446# Add or remove newline at the end of the file. 1447nl_end_of_file = add # ignore/add/remove/force 1448 1449# The minimum number of newlines at the end of the file (only used if 1450# nl_end_of_file is 'add' or 'force'). 1451nl_end_of_file_min = 0 # unsigned number 1452 1453# Add or remove newline between '=' and '{'. 1454nl_assign_brace = remove # ignore/add/remove/force 1455 1456# (D) Add or remove newline between '=' and '['. 1457nl_assign_square = ignore # ignore/add/remove/force 1458 1459# Add or remove newline between '[]' and '{'. 1460nl_tsquare_brace = ignore # ignore/add/remove/force 1461 1462# (D) Add or remove newline after '= ['. Will also affect the newline before 1463# the ']'. 1464nl_after_square_assign = ignore # ignore/add/remove/force 1465 1466# Add or remove newline between a function call's ')' and '{', as in 1467# 'list_for_each(item, &list) { }'. 1468nl_fcall_brace = remove # ignore/add/remove/force 1469 1470# Add or remove newline between 'enum' and '{'. 1471nl_enum_brace = remove # ignore/add/remove/force 1472 1473# Add or remove newline between 'enum' and 'class'. 1474nl_enum_class = ignore # ignore/add/remove/force 1475 1476# Add or remove newline between 'enum class' and the identifier. 1477nl_enum_class_identifier = ignore # ignore/add/remove/force 1478 1479# Add or remove newline between 'enum class' type and ':'. 1480nl_enum_identifier_colon = ignore # ignore/add/remove/force 1481 1482# Add or remove newline between 'enum class identifier :' and type. 1483nl_enum_colon_type = ignore # ignore/add/remove/force 1484 1485# Add or remove newline between 'struct and '{'. 1486nl_struct_brace = remove # ignore/add/remove/force 1487 1488# Add or remove newline between 'union' and '{'. 1489nl_union_brace = remove # ignore/add/remove/force 1490 1491# Add or remove newline between 'if' and '{'. 1492nl_if_brace = remove # ignore/add/remove/force 1493 1494# Add or remove newline between '}' and 'else'. 1495nl_brace_else = remove # ignore/add/remove/force 1496 1497# Add or remove newline between 'else if' and '{'. If set to ignore, 1498# nl_if_brace is used instead. 1499nl_elseif_brace = remove # ignore/add/remove/force 1500 1501# Add or remove newline between 'else' and '{'. 1502nl_else_brace = remove # ignore/add/remove/force 1503 1504# Add or remove newline between 'else' and 'if'. 1505nl_else_if = remove # ignore/add/remove/force 1506 1507# Add or remove newline before '{' opening brace 1508nl_before_opening_brace_func_class_def = ignore # ignore/add/remove/force 1509 1510# Add or remove newline before 'if'/'else if' closing parenthesis. 1511nl_before_if_closing_paren = remove # ignore/add/remove/force 1512 1513# Add or remove newline between '}' and 'finally'. 1514nl_brace_finally = remove # ignore/add/remove/force 1515 1516# Add or remove newline between 'finally' and '{'. 1517nl_finally_brace = remove # ignore/add/remove/force 1518 1519# Add or remove newline between 'try' and '{'. 1520nl_try_brace = remove # ignore/add/remove/force 1521 1522# Add or remove newline between get/set and '{'. 1523nl_getset_brace = ignore # ignore/add/remove/force 1524 1525# Add or remove newline between 'for' and '{'. 1526nl_for_brace = remove # ignore/add/remove/force 1527 1528# Add or remove newline before the '{' of a 'catch' statement, as in 1529# 'catch (decl) <here> {'. 1530nl_catch_brace = remove # ignore/add/remove/force 1531 1532# (OC) Add or remove newline before the '{' of a '@catch' statement, as in 1533# '@catch (decl) <here> {'. If set to ignore, nl_catch_brace is used. 1534nl_oc_catch_brace = ignore # ignore/add/remove/force 1535 1536# Add or remove newline between '}' and 'catch'. 1537nl_brace_catch = remove # ignore/add/remove/force 1538 1539# (OC) Add or remove newline between '}' and '@catch'. If set to ignore, 1540# nl_brace_catch is used. 1541nl_oc_brace_catch = ignore # ignore/add/remove/force 1542 1543# Add or remove newline between '}' and ']'. 1544nl_brace_square = ignore # ignore/add/remove/force 1545 1546# Add or remove newline between '}' and ')' in a function invocation. 1547nl_brace_fparen = ignore # ignore/add/remove/force 1548 1549# Add or remove newline between 'while' and '{'. 1550nl_while_brace = remove # ignore/add/remove/force 1551 1552# (D) Add or remove newline between 'scope (x)' and '{'. 1553nl_scope_brace = ignore # ignore/add/remove/force 1554 1555# (D) Add or remove newline between 'unittest' and '{'. 1556nl_unittest_brace = ignore # ignore/add/remove/force 1557 1558# (D) Add or remove newline between 'version (x)' and '{'. 1559nl_version_brace = ignore # ignore/add/remove/force 1560 1561# (C#) Add or remove newline between 'using' and '{'. 1562nl_using_brace = ignore # ignore/add/remove/force 1563 1564# Add or remove newline between two open or close braces. Due to general 1565# newline/brace handling, REMOVE may not work. 1566nl_brace_brace = ignore # ignore/add/remove/force 1567 1568# Add or remove newline between 'do' and '{'. 1569nl_do_brace = remove # ignore/add/remove/force 1570 1571# Add or remove newline between '}' and 'while' of 'do' statement. 1572nl_brace_while = remove # ignore/add/remove/force 1573 1574# Add or remove newline between 'switch' and '{'. 1575nl_switch_brace = remove # ignore/add/remove/force 1576 1577# Add or remove newline between 'synchronized' and '{'. 1578nl_synchronized_brace = remove # ignore/add/remove/force 1579 1580# Add a newline between ')' and '{' if the ')' is on a different line than the 1581# if/for/etc. 1582# 1583# Overrides nl_for_brace, nl_if_brace, nl_switch_brace, nl_while_switch and 1584# nl_catch_brace. 1585nl_multi_line_cond = false # true/false 1586 1587# Add a newline after '(' if an if/for/while/switch condition spans multiple 1588# lines 1589nl_multi_line_sparen_open = remove # ignore/add/remove/force 1590 1591# Add a newline before ')' if an if/for/while/switch condition spans multiple 1592# lines. Overrides nl_before_if_closing_paren if both are specified. 1593nl_multi_line_sparen_close = remove # ignore/add/remove/force 1594 1595# Force a newline in a define after the macro name for multi-line defines. 1596nl_multi_line_define = false # true/false 1597 1598# Whether to add a newline before 'case', and a blank line before a 'case' 1599# statement that follows a ';' or '}'. 1600nl_before_case = false # true/false 1601 1602# Whether to add a newline after a 'case' statement. 1603nl_after_case = true # true/false 1604 1605# Add or remove newline between a case ':' and '{'. 1606# 1607# Overrides nl_after_case. 1608nl_case_colon_brace = remove # ignore/add/remove/force 1609 1610# Add or remove newline between ')' and 'throw'. 1611nl_before_throw = ignore # ignore/add/remove/force 1612 1613# Add or remove newline between 'namespace' and '{'. 1614nl_namespace_brace = ignore # ignore/add/remove/force 1615 1616# Add or remove newline after 'template<...>' of a template class. 1617nl_template_class = ignore # ignore/add/remove/force 1618 1619# Add or remove newline after 'template<...>' of a template class declaration. 1620# 1621# Overrides nl_template_class. 1622nl_template_class_decl = ignore # ignore/add/remove/force 1623 1624# Add or remove newline after 'template<>' of a specialized class declaration. 1625# 1626# Overrides nl_template_class_decl. 1627nl_template_class_decl_special = ignore # ignore/add/remove/force 1628 1629# Add or remove newline after 'template<...>' of a template class definition. 1630# 1631# Overrides nl_template_class. 1632nl_template_class_def = ignore # ignore/add/remove/force 1633 1634# Add or remove newline after 'template<>' of a specialized class definition. 1635# 1636# Overrides nl_template_class_def. 1637nl_template_class_def_special = ignore # ignore/add/remove/force 1638 1639# Add or remove newline after 'template<...>' of a template function. 1640nl_template_func = ignore # ignore/add/remove/force 1641 1642# Add or remove newline after 'template<...>' of a template function 1643# declaration. 1644# 1645# Overrides nl_template_func. 1646nl_template_func_decl = ignore # ignore/add/remove/force 1647 1648# Add or remove newline after 'template<>' of a specialized function 1649# declaration. 1650# 1651# Overrides nl_template_func_decl. 1652nl_template_func_decl_special = ignore # ignore/add/remove/force 1653 1654# Add or remove newline after 'template<...>' of a template function 1655# definition. 1656# 1657# Overrides nl_template_func. 1658nl_template_func_def = ignore # ignore/add/remove/force 1659 1660# Add or remove newline after 'template<>' of a specialized function 1661# definition. 1662# 1663# Overrides nl_template_func_def. 1664nl_template_func_def_special = ignore # ignore/add/remove/force 1665 1666# Add or remove newline after 'template<...>' of a template variable. 1667nl_template_var = ignore # ignore/add/remove/force 1668 1669# Add or remove newline between 'template<...>' and 'using' of a templated 1670# type alias. 1671nl_template_using = ignore # ignore/add/remove/force 1672 1673# Add or remove newline between 'class' and '{'. 1674nl_class_brace = ignore # ignore/add/remove/force 1675 1676# Add or remove newline before or after (depending on pos_class_comma, 1677# may not be IGNORE) each',' in the base class list. 1678nl_class_init_args = ignore # ignore/add/remove/force 1679 1680# Add or remove newline after each ',' in the constructor member 1681# initialization. Related to nl_constr_colon, pos_constr_colon and 1682# pos_constr_comma. 1683nl_constr_init_args = ignore # ignore/add/remove/force 1684 1685# Add or remove newline before first element, after comma, and after last 1686# element, in 'enum'. 1687nl_enum_own_lines = force # ignore/add/remove/force 1688 1689# Add or remove newline between return type and function name in a function 1690# definition. 1691# might be modified by nl_func_leave_one_liners 1692nl_func_type_name = remove # ignore/add/remove/force 1693 1694# Add or remove newline between return type and function name inside a class 1695# definition. If set to ignore, nl_func_type_name or nl_func_proto_type_name 1696# is used instead. 1697nl_func_type_name_class = ignore # ignore/add/remove/force 1698 1699# Add or remove newline between class specification and '::' 1700# in 'void A::f() { }'. Only appears in separate member implementation (does 1701# not appear with in-line implementation). 1702nl_func_class_scope = ignore # ignore/add/remove/force 1703 1704# Add or remove newline between function scope and name, as in 1705# 'void A :: <here> f() { }'. 1706nl_func_scope_name = ignore # ignore/add/remove/force 1707 1708# Add or remove newline between return type and function name in a prototype. 1709nl_func_proto_type_name = remove # ignore/add/remove/force 1710 1711# Add or remove newline between a function name and the opening '(' in the 1712# declaration. 1713nl_func_paren = remove # ignore/add/remove/force 1714 1715# Overrides nl_func_paren for functions with no parameters. 1716nl_func_paren_empty = ignore # ignore/add/remove/force 1717 1718# Add or remove newline between a function name and the opening '(' in the 1719# definition. 1720nl_func_def_paren = remove # ignore/add/remove/force 1721 1722# Overrides nl_func_def_paren for functions with no parameters. 1723nl_func_def_paren_empty = ignore # ignore/add/remove/force 1724 1725# Add or remove newline between a function name and the opening '(' in the 1726# call. 1727nl_func_call_paren = remove # ignore/add/remove/force 1728 1729# Overrides nl_func_call_paren for functions with no parameters. 1730nl_func_call_paren_empty = ignore # ignore/add/remove/force 1731 1732# Add or remove newline after '(' in a function declaration. 1733nl_func_decl_start = remove # ignore/add/remove/force 1734 1735# Add or remove newline after '(' in a function definition. 1736nl_func_def_start = remove # ignore/add/remove/force 1737 1738# Overrides nl_func_decl_start when there is only one parameter. 1739nl_func_decl_start_single = ignore # ignore/add/remove/force 1740 1741# Overrides nl_func_def_start when there is only one parameter. 1742nl_func_def_start_single = ignore # ignore/add/remove/force 1743 1744# Whether to add a newline after '(' in a function declaration if '(' and ')' 1745# are in different lines. If false, nl_func_decl_start is used instead. 1746nl_func_decl_start_multi_line = true # true/false 1747 1748# Whether to add a newline after '(' in a function definition if '(' and ')' 1749# are in different lines. If false, nl_func_def_start is used instead. 1750nl_func_def_start_multi_line = true # true/false 1751 1752# Add or remove newline after each ',' in a function declaration. 1753nl_func_decl_args = ignore # ignore/add/remove/force 1754 1755# Add or remove newline after each ',' in a function definition. 1756nl_func_def_args = ignore # ignore/add/remove/force 1757 1758# Add or remove newline after each ',' in a function call. 1759nl_func_call_args = ignore # ignore/add/remove/force 1760 1761# Whether to add a newline after each ',' in a function declaration if '(' 1762# and ')' are in different lines. If false, nl_func_decl_args is used instead. 1763nl_func_decl_args_multi_line = false # true/false 1764 1765# Whether to add a newline after each ',' in a function definition if '(' 1766# and ')' are in different lines. If false, nl_func_def_args is used instead. 1767nl_func_def_args_multi_line = false # true/false 1768 1769# Add or remove newline before the ')' in a function declaration. 1770nl_func_decl_end = ignore # ignore/add/remove/force 1771 1772# Add or remove newline before the ')' in a function definition. 1773nl_func_def_end = ignore # ignore/add/remove/force 1774 1775# Overrides nl_func_decl_end when there is only one parameter. 1776nl_func_decl_end_single = ignore # ignore/add/remove/force 1777 1778# Overrides nl_func_def_end when there is only one parameter. 1779nl_func_def_end_single = ignore # ignore/add/remove/force 1780 1781# Whether to add a newline before ')' in a function declaration if '(' and ')' 1782# are in different lines. If false, nl_func_decl_end is used instead. 1783nl_func_decl_end_multi_line = false # true/false 1784 1785# Whether to add a newline before ')' in a function definition if '(' and ')' 1786# are in different lines. If false, nl_func_def_end is used instead. 1787nl_func_def_end_multi_line = false # true/false 1788 1789# Add or remove newline between '()' in a function declaration. 1790nl_func_decl_empty = ignore # ignore/add/remove/force 1791 1792# Add or remove newline between '()' in a function definition. 1793nl_func_def_empty = remove # ignore/add/remove/force 1794 1795# Add or remove newline between '()' in a function call. 1796nl_func_call_empty = remove # ignore/add/remove/force 1797 1798# Whether to add a newline after '(' in a function call, 1799# has preference over nl_func_call_start_multi_line. 1800nl_func_call_start = ignore # ignore/add/remove/force 1801 1802# Whether to add a newline before ')' in a function call. 1803nl_func_call_end = ignore # ignore/add/remove/force 1804 1805# Whether to add a newline after '(' in a function call if '(' and ')' are in 1806# different lines. 1807nl_func_call_start_multi_line = false # true/false 1808 1809# Whether to add a newline after each ',' in a function call if '(' and ')' 1810# are in different lines. 1811nl_func_call_args_multi_line = false # true/false 1812 1813# Whether to add a newline before ')' in a function call if '(' and ')' are in 1814# different lines. 1815nl_func_call_end_multi_line = false # true/false 1816 1817# Whether to respect nl_func_call_XXX option incase of closure args. 1818nl_func_call_args_multi_line_ignore_closures = false # true/false 1819 1820# Whether to add a newline after '<' of a template parameter list. 1821nl_template_start = false # true/false 1822 1823# Whether to add a newline after each ',' in a template parameter list. 1824nl_template_args = false # true/false 1825 1826# Whether to add a newline before '>' of a template parameter list. 1827nl_template_end = false # true/false 1828 1829# (OC) Whether to put each Objective-C message parameter on a separate line. 1830# See nl_oc_msg_leave_one_liner. 1831nl_oc_msg_args = false # true/false 1832 1833# Add or remove newline between function signature and '{'. 1834nl_fdef_brace = remove # ignore/add/remove/force 1835 1836# Add or remove newline between function signature and '{', 1837# if signature ends with ')'. Overrides nl_fdef_brace. 1838nl_fdef_brace_cond = ignore # ignore/add/remove/force 1839 1840# Add or remove newline between C++11 lambda signature and '{'. 1841nl_cpp_ldef_brace = ignore # ignore/add/remove/force 1842 1843# Add or remove newline between 'return' and the return expression. 1844nl_return_expr = remove # ignore/add/remove/force 1845 1846# Whether to add a newline after semicolons, except in 'for' statements. 1847nl_after_semicolon = true # true/false 1848 1849# (Java) Add or remove newline between the ')' and '{{' of the double brace 1850# initializer. 1851nl_paren_dbrace_open = ignore # ignore/add/remove/force 1852 1853# Whether to add a newline after the type in an unnamed temporary 1854# direct-list-initialization. 1855nl_type_brace_init_lst = ignore # ignore/add/remove/force 1856 1857# Whether to add a newline after the open brace in an unnamed temporary 1858# direct-list-initialization. 1859nl_type_brace_init_lst_open = ignore # ignore/add/remove/force 1860 1861# Whether to add a newline before the close brace in an unnamed temporary 1862# direct-list-initialization. 1863nl_type_brace_init_lst_close = ignore # ignore/add/remove/force 1864 1865# Whether to add a newline after '{'. This also adds a newline before the 1866# matching '}'. 1867nl_after_brace_open = true # true/false 1868 1869# Whether to add a newline between the open brace and a trailing single-line 1870# comment. Requires nl_after_brace_open=true. 1871nl_after_brace_open_cmt = false # true/false 1872 1873# Whether to add a newline after a virtual brace open with a non-empty body. 1874# These occur in un-braced if/while/do/for statement bodies. 1875nl_after_vbrace_open = false # true/false 1876 1877# Whether to add a newline after a virtual brace open with an empty body. 1878# These occur in un-braced if/while/do/for statement bodies. 1879nl_after_vbrace_open_empty = false # true/false 1880 1881# Whether to add a newline after '}'. Does not apply if followed by a 1882# necessary ';'. 1883nl_after_brace_close = false # true/false 1884 1885# Whether to add a newline after a virtual brace close, 1886# as in 'if (foo) a++; <here> return;'. 1887nl_after_vbrace_close = false # true/false 1888 1889# Add or remove newline between the close brace and identifier, 1890# as in 'struct { int a; } <here> b;'. Affects enumerations, unions and 1891# structures. If set to ignore, uses nl_after_brace_close. 1892nl_brace_struct_var = remove # ignore/add/remove/force 1893 1894# Whether to alter newlines in '#define' macros. 1895nl_define_macro = false # true/false 1896 1897# Whether to alter newlines between consecutive parenthesis closes. The number 1898# of closing parentheses in a line will depend on respective open parenthesis 1899# lines. 1900nl_squeeze_paren_close = false # true/false 1901 1902# Whether to remove blanks after '#ifxx' and '#elxx', or before '#elxx' and 1903# '#endif'. Does not affect top-level #ifdefs. 1904nl_squeeze_ifdef = false # true/false 1905 1906# Makes the nl_squeeze_ifdef option affect the top-level #ifdefs as well. 1907nl_squeeze_ifdef_top_level = false # true/false 1908 1909# Add or remove blank line before 'if'. 1910nl_before_if = ignore # ignore/add/remove/force 1911 1912# Add or remove blank line after 'if' statement. Add/Force work only if the 1913# next token is not a closing brace. 1914nl_after_if = ignore # ignore/add/remove/force 1915 1916# Add or remove blank line before 'for'. 1917nl_before_for = ignore # ignore/add/remove/force 1918 1919# Add or remove blank line after 'for' statement. 1920nl_after_for = ignore # ignore/add/remove/force 1921 1922# Add or remove blank line before 'while'. 1923nl_before_while = ignore # ignore/add/remove/force 1924 1925# Add or remove blank line after 'while' statement. 1926nl_after_while = ignore # ignore/add/remove/force 1927 1928# Add or remove blank line before 'switch'. 1929nl_before_switch = ignore # ignore/add/remove/force 1930 1931# Add or remove blank line after 'switch' statement. 1932nl_after_switch = ignore # ignore/add/remove/force 1933 1934# Add or remove blank line before 'synchronized'. 1935nl_before_synchronized = ignore # ignore/add/remove/force 1936 1937# Add or remove blank line after 'synchronized' statement. 1938nl_after_synchronized = ignore # ignore/add/remove/force 1939 1940# Add or remove blank line before 'do'. 1941nl_before_do = ignore # ignore/add/remove/force 1942 1943# Add or remove blank line after 'do/while' statement. 1944nl_after_do = ignore # ignore/add/remove/force 1945 1946# Whether to put a blank line before 'return' statements, unless after an open 1947# brace. 1948nl_before_return = false # true/false 1949 1950# Whether to put a blank line after 'return' statements, unless followed by a 1951# close brace. 1952nl_after_return = false # true/false 1953 1954# Whether to put a blank line before a member '.' or '->' operators. 1955nl_before_member = ignore # ignore/add/remove/force 1956 1957# (Java) Whether to put a blank line after a member '.' or '->' operators. 1958nl_after_member = ignore # ignore/add/remove/force 1959 1960# Whether to double-space commented-entries in 'struct'/'union'/'enum'. 1961nl_ds_struct_enum_cmt = false # true/false 1962 1963# Whether to force a newline before '}' of a 'struct'/'union'/'enum'. 1964# (Lower priority than eat_blanks_before_close_brace.) 1965nl_ds_struct_enum_close_brace = false # true/false 1966 1967# Add or remove newline before or after (depending on pos_class_colon) a class 1968# colon, as in 'class Foo <here> : <or here> public Bar'. 1969nl_class_colon = ignore # ignore/add/remove/force 1970 1971# Add or remove newline around a class constructor colon. The exact position 1972# depends on nl_constr_init_args, pos_constr_colon and pos_constr_comma. 1973nl_constr_colon = ignore # ignore/add/remove/force 1974 1975# Whether to collapse a two-line namespace, like 'namespace foo\n{ decl; }' 1976# into a single line. If true, prevents other brace newline rules from turning 1977# such code into four lines. 1978nl_namespace_two_to_one_liner = false # true/false 1979 1980# Whether to remove a newline in simple unbraced if statements, turning them 1981# into one-liners, as in 'if(b)\n i++;' => 'if(b) i++;'. 1982nl_create_if_one_liner = false # true/false 1983 1984# Whether to remove a newline in simple unbraced for statements, turning them 1985# into one-liners, as in 'for (...)\n stmt;' => 'for (...) stmt;'. 1986nl_create_for_one_liner = false # true/false 1987 1988# Whether to remove a newline in simple unbraced while statements, turning 1989# them into one-liners, as in 'while (expr)\n stmt;' => 'while (expr) stmt;'. 1990nl_create_while_one_liner = false # true/false 1991 1992# Whether to collapse a function definition whose body (not counting braces) 1993# is only one line so that the entire definition (prototype, braces, body) is 1994# a single line. 1995nl_create_func_def_one_liner = false # true/false 1996 1997# Whether to collapse a function definition whose body (not counting braces) 1998# is only one line so that the entire definition (prototype, braces, body) is 1999# a single line. 2000nl_create_list_one_liner = false # true/false 2001 2002# Whether to split one-line simple unbraced if statements into two lines by 2003# adding a newline, as in 'if(b) <here> i++;'. 2004nl_split_if_one_liner = false # true/false 2005 2006# Whether to split one-line simple unbraced for statements into two lines by 2007# adding a newline, as in 'for (...) <here> stmt;'. 2008nl_split_for_one_liner = false # true/false 2009 2010# Whether to split one-line simple unbraced while statements into two lines by 2011# adding a newline, as in 'while (expr) <here> stmt;'. 2012nl_split_while_one_liner = false # true/false 2013 2014# Don't add a newline before a cpp-comment in a parameter list of a function 2015# call. 2016donot_add_nl_before_cpp_comment = false # true/false 2017 2018# 2019# Blank line options 2020# 2021 2022# The maximum number of consecutive newlines (3 = 2 blank lines). 2023nl_max = 3 # unsigned number 2024 2025# The maximum number of consecutive newlines in a function. 2026nl_max_blank_in_func = 3 # unsigned number 2027 2028# The number of newlines inside an empty function body. 2029# This option overrides eat_blanks_after_open_brace and 2030# eat_blanks_before_close_brace, but is ignored when 2031# nl_collapse_empty_body=true 2032nl_inside_empty_func = 0 # unsigned number 2033 2034# The number of newlines before a function prototype. 2035nl_before_func_body_proto = 0 # unsigned number 2036 2037# The number of newlines before a multi-line function definition. Where 2038# applicable, this option is overridden with eat_blanks_after_open_brace=true 2039nl_before_func_body_def = 2 # unsigned number 2040 2041# The number of newlines before a class constructor/destructor prototype. 2042nl_before_func_class_proto = 0 # unsigned number 2043 2044# The number of newlines before a class constructor/destructor definition. 2045nl_before_func_class_def = 0 # unsigned number 2046 2047# The number of newlines after a function prototype. 2048nl_after_func_proto = 0 # unsigned number 2049 2050# The number of newlines after a function prototype, if not followed by 2051# another function prototype. 2052nl_after_func_proto_group = 2 # unsigned number 2053 2054# The number of newlines after a class constructor/destructor prototype. 2055nl_after_func_class_proto = 0 # unsigned number 2056 2057# The number of newlines after a class constructor/destructor prototype, 2058# if not followed by another constructor/destructor prototype. 2059nl_after_func_class_proto_group = 0 # unsigned number 2060 2061# Whether one-line method definitions inside a class body should be treated 2062# as if they were prototypes for the purposes of adding newlines. 2063# 2064# Requires nl_class_leave_one_liners=true. Overrides nl_before_func_body_def 2065# and nl_before_func_class_def for one-liners. 2066nl_class_leave_one_liner_groups = false # true/false 2067 2068# The number of newlines after '}' of a multi-line function body. 2069nl_after_func_body = 2 # unsigned number 2070 2071# The number of newlines after '}' of a multi-line function body in a class 2072# declaration. Also affects class constructors/destructors. 2073# 2074# Overrides nl_after_func_body. 2075nl_after_func_body_class = 0 # unsigned number 2076 2077# The number of newlines after '}' of a single line function body. Also 2078# affects class constructors/destructors. 2079# 2080# Overrides nl_after_func_body and nl_after_func_body_class. 2081nl_after_func_body_one_liner = 0 # unsigned number 2082 2083# The number of blank lines after a block of variable definitions at the top 2084# of a function body. 2085# 2086# 0: No change (default). 2087nl_func_var_def_blk = 0 # unsigned number 2088 2089# The number of newlines before a block of typedefs. If nl_after_access_spec 2090# is non-zero, that option takes precedence. 2091# 2092# 0: No change (default). 2093nl_typedef_blk_start = 0 # unsigned number 2094 2095# The number of newlines after a block of typedefs. 2096# 2097# 0: No change (default). 2098nl_typedef_blk_end = 0 # unsigned number 2099 2100# The maximum number of consecutive newlines within a block of typedefs. 2101# 2102# 0: No change (default). 2103nl_typedef_blk_in = 0 # unsigned number 2104 2105# The number of newlines before a block of variable definitions not at the top 2106# of a function body. If nl_after_access_spec is non-zero, that option takes 2107# precedence. 2108# 2109# 0: No change (default). 2110nl_var_def_blk_start = 0 # unsigned number 2111 2112# The number of newlines after a block of variable definitions not at the top 2113# of a function body. 2114# 2115# 0: No change (default). 2116nl_var_def_blk_end = 0 # unsigned number 2117 2118# The maximum number of consecutive newlines within a block of variable 2119# definitions. 2120# 2121# 0: No change (default). 2122nl_var_def_blk_in = 0 # unsigned number 2123 2124# The minimum number of newlines before a multi-line comment. 2125# Doesn't apply if after a brace open or another multi-line comment. 2126nl_before_block_comment = 0 # unsigned number 2127 2128# The minimum number of newlines before a single-line C comment. 2129# Doesn't apply if after a brace open or other single-line C comments. 2130nl_before_c_comment = 0 # unsigned number 2131 2132# The minimum number of newlines before a CPP comment. 2133# Doesn't apply if after a brace open or other CPP comments. 2134nl_before_cpp_comment = 0 # unsigned number 2135 2136# Whether to force a newline after a multi-line comment. 2137nl_after_multiline_comment = false # true/false 2138 2139# Whether to force a newline after a label's colon. 2140nl_after_label_colon = true # true/false 2141 2142# The number of newlines after '}' or ';' of a struct/enum/union definition. 2143nl_after_struct = 0 # unsigned number 2144 2145# The number of newlines before a class definition. 2146nl_before_class = 0 # unsigned number 2147 2148# The number of newlines after '}' or ';' of a class definition. 2149nl_after_class = 0 # unsigned number 2150 2151# The number of newlines before a namespace. 2152nl_before_namespace = 0 # unsigned number 2153 2154# The number of newlines after '{' of a namespace. This also adds newlines 2155# before the matching '}'. 2156# 2157# 0: Apply eat_blanks_after_open_brace or eat_blanks_before_close_brace if 2158# applicable, otherwise no change. 2159# 2160# Overrides eat_blanks_after_open_brace and eat_blanks_before_close_brace. 2161nl_inside_namespace = 0 # unsigned number 2162 2163# The number of newlines after '}' of a namespace. 2164nl_after_namespace = 0 # unsigned number 2165 2166# The number of newlines before an access specifier label. This also includes 2167# the Qt-specific 'signals:' and 'slots:'. Will not change the newline count 2168# if after a brace open. 2169# 2170# 0: No change (default). 2171nl_before_access_spec = 0 # unsigned number 2172 2173# The number of newlines after an access specifier label. This also includes 2174# the Qt-specific 'signals:' and 'slots:'. Will not change the newline count 2175# if after a brace open. 2176# 2177# 0: No change (default). 2178# 2179# Overrides nl_typedef_blk_start and nl_var_def_blk_start. 2180nl_after_access_spec = 0 # unsigned number 2181 2182# The number of newlines between a function definition and the function 2183# comment, as in '// comment\n <here> void foo() {...}'. 2184# 2185# 0: No change (default). 2186nl_comment_func_def = 0 # unsigned number 2187 2188# The number of newlines after a try-catch-finally block that isn't followed 2189# by a brace close. 2190# 2191# 0: No change (default). 2192nl_after_try_catch_finally = 0 # unsigned number 2193 2194# (C#) The number of newlines before and after a property, indexer or event 2195# declaration. 2196# 2197# 0: No change (default). 2198nl_around_cs_property = 0 # unsigned number 2199 2200# (C#) The number of newlines between the get/set/add/remove handlers. 2201# 2202# 0: No change (default). 2203nl_between_get_set = 0 # unsigned number 2204 2205# (C#) Add or remove newline between property and the '{'. 2206nl_property_brace = ignore # ignore/add/remove/force 2207 2208# Whether to remove blank lines after '{'. 2209eat_blanks_after_open_brace = false # true/false 2210 2211# Whether to remove blank lines before '}'. 2212eat_blanks_before_close_brace = true # true/false 2213 2214# How aggressively to remove extra newlines not in preprocessor. 2215# 2216# 0: No change (default) 2217# 1: Remove most newlines not handled by other config 2218# 2: Remove all newlines and reformat completely by config 2219nl_remove_extra_newlines = 0 # unsigned number 2220 2221# (Java) Add or remove newline after an annotation statement. Only affects 2222# annotations that are after a newline. 2223nl_after_annotation = ignore # ignore/add/remove/force 2224 2225# (Java) Add or remove newline between two annotations. 2226nl_between_annotation = ignore # ignore/add/remove/force 2227 2228# The number of newlines before a whole-file #ifdef. 2229# 2230# 0: No change (default). 2231nl_before_whole_file_ifdef = 0 # unsigned number 2232 2233# The number of newlines after a whole-file #ifdef. 2234# 2235# 0: No change (default). 2236nl_after_whole_file_ifdef = 0 # unsigned number 2237 2238# The number of newlines before a whole-file #endif. 2239# 2240# 0: No change (default). 2241nl_before_whole_file_endif = 0 # unsigned number 2242 2243# The number of newlines after a whole-file #endif. 2244# 2245# 0: No change (default). 2246nl_after_whole_file_endif = 0 # unsigned number 2247 2248# 2249# Positioning options 2250# 2251 2252# The position of arithmetic operators in wrapped expressions. 2253pos_arith = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2254 2255# The position of assignment in wrapped expressions. Do not affect '=' 2256# followed by '{'. 2257pos_assign = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2258 2259# The position of Boolean operators in wrapped expressions. 2260pos_bool = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2261 2262# The position of comparison operators in wrapped expressions. 2263pos_compare = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2264 2265# The position of conditional operators, as in the '?' and ':' of 2266# 'expr ? stmt : stmt', in wrapped expressions. 2267pos_conditional = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2268 2269# The position of the comma in wrapped expressions. 2270pos_comma = trail # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2271 2272# The position of the comma in enum entries. 2273pos_enum_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2274 2275# The position of the comma in the base class list if there is more than one 2276# line. Affects nl_class_init_args. 2277pos_class_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2278 2279# The position of the comma in the constructor initialization list. 2280# Related to nl_constr_colon, nl_constr_init_args and pos_constr_colon. 2281pos_constr_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2282 2283# The position of trailing/leading class colon, between class and base class 2284# list. Affects nl_class_colon. 2285pos_class_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2286 2287# The position of colons between constructor and member initialization. 2288# Related to nl_constr_colon, nl_constr_init_args and pos_constr_comma. 2289pos_constr_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2290 2291# The position of shift operators in wrapped expressions. 2292pos_shift = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force 2293 2294# 2295# Line splitting options 2296# 2297 2298# Try to limit code width to N columns. 2299code_width = 120 # unsigned number 2300 2301# Whether to fully split long 'for' statements at semi-colons. 2302ls_for_split_full = true # true/false 2303 2304# Whether to fully split long function prototypes/calls at commas. 2305# The option ls_code_width has priority over the option ls_func_split_full. 2306ls_func_split_full = true # true/false 2307 2308# Whether to split lines as close to code_width as possible and ignore some 2309# groupings. 2310# The option ls_code_width has priority over the option ls_func_split_full. 2311ls_code_width = false # true/false 2312 2313# 2314# Code alignment options (not left column spaces/tabs) 2315# 2316 2317# Whether to keep non-indenting tabs. 2318align_keep_tabs = false # true/false 2319 2320# Whether to use tabs for aligning. 2321align_with_tabs = false # true/false 2322 2323# Whether to bump out to the next tab when aligning. 2324align_on_tabstop = false # true/false 2325 2326# Whether to right-align numbers. 2327align_number_right = false # true/false 2328 2329# Whether to keep whitespace not required for alignment. 2330align_keep_extra_space = false # true/false 2331 2332# Whether to align variable definitions in prototypes and functions. 2333align_func_params = true # true/false 2334 2335# The span for aligning parameter definitions in function on parameter name. 2336# 2337# 0: Don't align (default). 2338align_func_params_span = 0 # unsigned number 2339 2340# The threshold for aligning function parameter definitions. 2341# Use a negative number for absolute thresholds. 2342# 2343# 0: No limit (default). 2344align_func_params_thresh = 0 # number 2345 2346# The gap for aligning function parameter definitions. 2347align_func_params_gap = 0 # unsigned number 2348 2349# The span for aligning constructor value. 2350# 2351# 0: Don't align (default). 2352align_constr_value_span = 0 # unsigned number 2353 2354# The threshold for aligning constructor value. 2355# Use a negative number for absolute thresholds. 2356# 2357# 0: No limit (default). 2358align_constr_value_thresh = 0 # number 2359 2360# The gap for aligning constructor value. 2361align_constr_value_gap = 0 # unsigned number 2362 2363# Whether to align parameters in single-line functions that have the same 2364# name. The function names must already be aligned with each other. 2365align_same_func_call_params = false # true/false 2366 2367# The span for aligning function-call parameters for single line functions. 2368# 2369# 0: Don't align (default). 2370align_same_func_call_params_span = 0 # unsigned number 2371 2372# The threshold for aligning function-call parameters for single line 2373# functions. 2374# Use a negative number for absolute thresholds. 2375# 2376# 0: No limit (default). 2377align_same_func_call_params_thresh = 0 # number 2378 2379# The span for aligning variable definitions. 2380# 2381# 0: Don't align (default). 2382align_var_def_span = 0 # unsigned number 2383 2384# How to consider (or treat) the '*' in the alignment of variable definitions. 2385# 2386# 0: Part of the type 'void * foo;' (default) 2387# 1: Part of the variable 'void *foo;' 2388# 2: Dangling 'void *foo;' 2389# Dangling: the '*' will not be taken into account when aligning. 2390align_var_def_star_style = 2 # unsigned number 2391 2392# How to consider (or treat) the '&' in the alignment of variable definitions. 2393# 2394# 0: Part of the type 'long & foo;' (default) 2395# 1: Part of the variable 'long &foo;' 2396# 2: Dangling 'long &foo;' 2397# Dangling: the '&' will not be taken into account when aligning. 2398align_var_def_amp_style = 1 # unsigned number 2399 2400# The threshold for aligning variable definitions. 2401# Use a negative number for absolute thresholds. 2402# 2403# 0: No limit (default). 2404align_var_def_thresh = 0 # number 2405 2406# The gap for aligning variable definitions. 2407align_var_def_gap = 0 # unsigned number 2408 2409# Whether to align the colon in struct bit fields. 2410align_var_def_colon = false # true/false 2411 2412# The gap for aligning the colon in struct bit fields. 2413align_var_def_colon_gap = 0 # unsigned number 2414 2415# Whether to align any attribute after the variable name. 2416align_var_def_attribute = false # true/false 2417 2418# Whether to align inline struct/enum/union variable definitions. 2419align_var_def_inline = false # true/false 2420 2421# The span for aligning on '=' in assignments. 2422# 2423# 0: Don't align (default). 2424align_assign_span = 0 # unsigned number 2425 2426# The span for aligning on '=' in function prototype modifier. 2427# 2428# 0: Don't align (default). 2429align_assign_func_proto_span = 0 # unsigned number 2430 2431# The threshold for aligning on '=' in assignments. 2432# Use a negative number for absolute thresholds. 2433# 2434# 0: No limit (default). 2435align_assign_thresh = 0 # number 2436 2437# How to apply align_assign_span to function declaration "assignments", i.e. 2438# 'virtual void foo() = 0' or '~foo() = {default|delete}'. 2439# 2440# 0: Align with other assignments (default) 2441# 1: Align with each other, ignoring regular assignments 2442# 2: Don't align 2443align_assign_decl_func = 0 # unsigned number 2444 2445# The span for aligning on '=' in enums. 2446# 2447# 0: Don't align (default). 2448align_enum_equ_span = 1 # unsigned number 2449 2450# The threshold for aligning on '=' in enums. 2451# Use a negative number for absolute thresholds. 2452# 2453# 0: no limit (default). 2454align_enum_equ_thresh = 0 # number 2455 2456# The span for aligning class member definitions. 2457# 2458# 0: Don't align (default). 2459align_var_class_span = 0 # unsigned number 2460 2461# The threshold for aligning class member definitions. 2462# Use a negative number for absolute thresholds. 2463# 2464# 0: No limit (default). 2465align_var_class_thresh = 0 # number 2466 2467# The gap for aligning class member definitions. 2468align_var_class_gap = 0 # unsigned number 2469 2470# The span for aligning struct/union member definitions. 2471# 2472# 0: Don't align (default). 2473align_var_struct_span = 1 # unsigned number 2474 2475# The threshold for aligning struct/union member definitions. 2476# Use a negative number for absolute thresholds. 2477# 2478# 0: No limit (default). 2479align_var_struct_thresh = -6 # number 2480 2481# The gap for aligning struct/union member definitions. 2482align_var_struct_gap = 0 # unsigned number 2483 2484# The span for aligning struct initializer values. 2485# 2486# 0: Don't align (default). 2487align_struct_init_span = 1 # unsigned number 2488 2489# The span for aligning single-line typedefs. 2490# 2491# 0: Don't align (default). 2492align_typedef_span = 1 # unsigned number 2493 2494# The minimum space between the type and the synonym of a typedef. 2495align_typedef_gap = 0 # unsigned number 2496 2497# How to align typedef'd functions with other typedefs. 2498# 2499# 0: Don't mix them at all (default) 2500# 1: Align the open parenthesis with the types 2501# 2: Align the function type name with the other type names 2502align_typedef_func = 0 # unsigned number 2503 2504# How to consider (or treat) the '*' in the alignment of typedefs. 2505# 2506# 0: Part of the typedef type, 'typedef int * pint;' (default) 2507# 1: Part of type name: 'typedef int *pint;' 2508# 2: Dangling: 'typedef int *pint;' 2509# Dangling: the '*' will not be taken into account when aligning. 2510align_typedef_star_style = 2 # unsigned number 2511 2512# How to consider (or treat) the '&' in the alignment of typedefs. 2513# 2514# 0: Part of the typedef type, 'typedef int & intref;' (default) 2515# 1: Part of type name: 'typedef int &intref;' 2516# 2: Dangling: 'typedef int &intref;' 2517# Dangling: the '&' will not be taken into account when aligning. 2518align_typedef_amp_style = 1 # unsigned number 2519 2520# The span for aligning comments that end lines. 2521# 2522# 0: Don't align (default). 2523align_right_cmt_span = 2 # unsigned number 2524 2525# Minimum number of columns between preceding text and a trailing comment in 2526# order for the comment to qualify for being aligned. Must be non-zero to have 2527# an effect. 2528align_right_cmt_gap = 0 # unsigned number 2529 2530# If aligning comments, whether to mix with comments after '}' and #endif with 2531# less than three spaces before the comment. 2532align_right_cmt_mix = false # true/false 2533 2534# Whether to only align trailing comments that are at the same brace level. 2535align_right_cmt_same_level = false # true/false 2536 2537# Minimum column at which to align trailing comments. Comments which are 2538# aligned beyond this column, but which can be aligned in a lesser column, 2539# may be "pulled in". 2540# 2541# 0: Ignore (default). 2542align_right_cmt_at_col = 0 # unsigned number 2543 2544# The span for aligning function prototypes. 2545# 2546# 0: Don't align (default). 2547align_func_proto_span = 0 # unsigned number 2548 2549# The threshold for aligning function prototypes. 2550# Use a negative number for absolute thresholds. 2551# 2552# 0: No limit (default). 2553align_func_proto_thresh = 0 # number 2554 2555# Minimum gap between the return type and the function name. 2556align_func_proto_gap = 0 # unsigned number 2557 2558# Whether to align function prototypes on the 'operator' keyword instead of 2559# what follows. 2560align_on_operator = false # true/false 2561 2562# Whether to mix aligning prototype and variable declarations. If true, 2563# align_var_def_XXX options are used instead of align_func_proto_XXX options. 2564align_mix_var_proto = false # true/false 2565 2566# Whether to align single-line functions with function prototypes. 2567# Uses align_func_proto_span. 2568align_single_line_func = false # true/false 2569 2570# Whether to align the open brace of single-line functions. 2571# Requires align_single_line_func=true. Uses align_func_proto_span. 2572align_single_line_brace = false # true/false 2573 2574# Gap for align_single_line_brace. 2575align_single_line_brace_gap = 0 # unsigned number 2576 2577# (OC) The span for aligning Objective-C message specifications. 2578# 2579# 0: Don't align (default). 2580align_oc_msg_spec_span = 0 # unsigned number 2581 2582# Whether to align macros wrapped with a backslash and a newline. This will 2583# not work right if the macro contains a multi-line comment. 2584align_nl_cont = false # true/false 2585 2586# Whether to align macro functions and variables together. 2587align_pp_define_together = false # true/false 2588 2589# The span for aligning on '#define' bodies. 2590# 2591# =0: Don't align (default) 2592# >0: Number of lines (including comments) between blocks 2593align_pp_define_span = 1 # unsigned number 2594 2595# The minimum space between label and value of a preprocessor define. 2596align_pp_define_gap = 0 # unsigned number 2597 2598# Whether to align lines that start with '<<' with previous '<<'. 2599# 2600# Default: true 2601align_left_shift = true # true/false 2602 2603# Whether to align comma-separated statements following '<<' (as used to 2604# initialize Eigen matrices). 2605align_eigen_comma_init = false # true/false 2606 2607# Whether to align text after 'asm volatile ()' colons. 2608align_asm_colon = false # true/false 2609 2610# (OC) Span for aligning parameters in an Objective-C message call 2611# on the ':'. 2612# 2613# 0: Don't align. 2614align_oc_msg_colon_span = 0 # unsigned number 2615 2616# (OC) Whether to always align with the first parameter, even if it is too 2617# short. 2618align_oc_msg_colon_first = false # true/false 2619 2620# (OC) Whether to align parameters in an Objective-C '+' or '-' declaration 2621# on the ':'. 2622align_oc_decl_colon = false # true/false 2623 2624# (OC) Whether to not align parameters in an Objectve-C message call if first 2625# colon is not on next line of the message call (the same way Xcode does 2626# aligment) 2627align_oc_msg_colon_xcode_like = false # true/false 2628 2629# 2630# Comment modification options 2631# 2632 2633# Try to wrap comments at N columns. 2634cmt_width = 120 # unsigned number 2635 2636# How to reflow comments. 2637# 2638# 0: No reflowing (apart from the line wrapping due to cmt_width) (default) 2639# 1: No touching at all 2640# 2: Full reflow (enable cmt_indent_multi for indent with line wrapping due to cmt_width) 2641cmt_reflow_mode = 0 # unsigned number 2642 2643# Path to a file that contains regular expressions describing patterns for which the 2644# end of one line and the beginning of the next will be folded into the same sentence 2645# or paragraph during full comment reflow. The regular expressions are described using 2646# ECMAScript syntax. The syntax for this specification is as follows, where "..." indicates 2647# the custom regular expression and "n" indicates the nth end_of_prev_line_regex 2648# and beg_of_next_line_regex regular expression pair: 2649# 2650# end_of_prev_line_regex[1] = "...$" 2651# beg_of_next_line_regex[1] = "^..." 2652# end_of_prev_line_regex[2] = "...$" 2653# beg_of_next_line_regex[2] = "^..." 2654# . 2655# . 2656# . 2657# end_of_prev_line_regex[n] = "...$" 2658# beg_of_next_line_regex[n] = "^..." 2659# 2660# Note that use of this option overrides the default reflow fold regular expressions, 2661# which are internally defined as follows: 2662# 2663# end_of_prev_line_regex[1] = "[\w,\]\)]$" 2664# beg_of_next_line_regex[1] = "^[\w,\[\(]" 2665# end_of_prev_line_regex[2] = "\.$" 2666# beg_of_next_line_regex[2] = "^[A-Z]" 2667cmt_reflow_fold_regex_file = "" # string 2668 2669# Whether to convert all tabs to spaces in comments. If false, tabs in 2670# comments are left alone, unless used for indenting. 2671cmt_convert_tab_to_spaces = false # true/false 2672 2673# Whether to apply changes to multi-line comments, including cmt_width, 2674# keyword substitution and leading chars. 2675# 2676# Default: true 2677cmt_indent_multi = true # true/false 2678 2679# Whether to align doxygen javadoc-style tags ('@param', '@return', etc.) 2680# and corresponding fields such that groups of consecutive block tags, 2681# parameter names, and descriptions align with one another. Overrides that 2682# which is specified by the cmt_sp_after_star_cont. If cmt_width > 0, it may 2683# be necessary to enable cmt_indent_multi and set cmt_reflow_mode = 2 2684# in order to achieve the desired alignment for line-wrapping. 2685cmt_align_doxygen_javadoc_tags = false # true/false 2686 2687# The number of spaces to insert after the star and before doxygen 2688# javadoc-style tags (@param, @return, etc). Requires enabling 2689# cmt_align_doxygen_javadoc_tags. Overrides that which is specified by the 2690# cmt_sp_after_star_cont. 2691# 2692# Default: 1 2693cmt_sp_before_doxygen_javadoc_tags = 1 # unsigned number 2694 2695# Whether to group c-comments that look like they are in a block. 2696cmt_c_group = false # true/false 2697 2698# Whether to put an empty '/*' on the first line of the combined c-comment. 2699cmt_c_nl_start = false # true/false 2700 2701# Whether to add a newline before the closing '*/' of the combined c-comment. 2702cmt_c_nl_end = false # true/false 2703 2704# Whether to change cpp-comments into c-comments. 2705cmt_cpp_to_c = false # true/false 2706 2707# Whether to group cpp-comments that look like they are in a block. Only 2708# meaningful if cmt_cpp_to_c=true. 2709cmt_cpp_group = false # true/false 2710 2711# Whether to put an empty '/*' on the first line of the combined cpp-comment 2712# when converting to a c-comment. 2713# 2714# Requires cmt_cpp_to_c=true and cmt_cpp_group=true. 2715cmt_cpp_nl_start = false # true/false 2716 2717# Whether to add a newline before the closing '*/' of the combined cpp-comment 2718# when converting to a c-comment. 2719# 2720# Requires cmt_cpp_to_c=true and cmt_cpp_group=true. 2721cmt_cpp_nl_end = false # true/false 2722 2723# Whether to put a star on subsequent comment lines. 2724cmt_star_cont = false # true/false 2725 2726# The number of spaces to insert at the start of subsequent comment lines. 2727cmt_sp_before_star_cont = 0 # unsigned number 2728 2729# The number of spaces to insert after the star on subsequent comment lines. 2730cmt_sp_after_star_cont = 0 # unsigned number 2731 2732# For multi-line comments with a '*' lead, remove leading spaces if the first 2733# and last lines of the comment are the same length. 2734# 2735# Default: true 2736cmt_multi_check_last = true # true/false 2737 2738# For multi-line comments with a '*' lead, remove leading spaces if the first 2739# and last lines of the comment are the same length AND if the length is 2740# bigger as the first_len minimum. 2741# 2742# Default: 4 2743cmt_multi_first_len_minimum = 4 # unsigned number 2744 2745# Path to a file that contains text to insert at the beginning of a file if 2746# the file doesn't start with a C/C++ comment. If the inserted text contains 2747# '$(filename)', that will be replaced with the current file's name. 2748cmt_insert_file_header = "" # string 2749 2750# Path to a file that contains text to insert at the end of a file if the 2751# file doesn't end with a C/C++ comment. If the inserted text contains 2752# '$(filename)', that will be replaced with the current file's name. 2753cmt_insert_file_footer = "" # string 2754 2755# Path to a file that contains text to insert before a function definition if 2756# the function isn't preceded by a C/C++ comment. If the inserted text 2757# contains '$(function)', '$(javaparam)' or '$(fclass)', these will be 2758# replaced with, respectively, the name of the function, the javadoc '@param' 2759# and '@return' stuff, or the name of the class to which the member function 2760# belongs. 2761cmt_insert_func_header = "" # string 2762 2763# Path to a file that contains text to insert before a class if the class 2764# isn't preceded by a C/C++ comment. If the inserted text contains '$(class)', 2765# that will be replaced with the class name. 2766cmt_insert_class_header = "" # string 2767 2768# Path to a file that contains text to insert before an Objective-C message 2769# specification, if the method isn't preceded by a C/C++ comment. If the 2770# inserted text contains '$(message)' or '$(javaparam)', these will be 2771# replaced with, respectively, the name of the function, or the javadoc 2772# '@param' and '@return' stuff. 2773cmt_insert_oc_msg_header = "" # string 2774 2775# Whether a comment should be inserted if a preprocessor is encountered when 2776# stepping backwards from a function name. 2777# 2778# Applies to cmt_insert_oc_msg_header, cmt_insert_func_header and 2779# cmt_insert_class_header. 2780cmt_insert_before_preproc = false # true/false 2781 2782# Whether a comment should be inserted if a function is declared inline to a 2783# class definition. 2784# 2785# Applies to cmt_insert_func_header. 2786# 2787# Default: true 2788cmt_insert_before_inlines = true # true/false 2789 2790# Whether a comment should be inserted if the function is a class constructor 2791# or destructor. 2792# 2793# Applies to cmt_insert_func_header. 2794cmt_insert_before_ctor_dtor = false # true/false 2795 2796# 2797# Code modifying options (non-whitespace) 2798# 2799 2800# Add or remove braces on a single-line 'do' statement. 2801mod_full_brace_do = force # ignore/add/remove/force 2802 2803# Add or remove braces on a single-line 'for' statement. 2804mod_full_brace_for = ignore # ignore/add/remove/force 2805 2806# (Pawn) Add or remove braces on a single-line function definition. 2807mod_full_brace_function = ignore # ignore/add/remove/force 2808 2809# Add or remove braces on a single-line 'if' statement. Braces will not be 2810# removed if the braced statement contains an 'else'. 2811mod_full_brace_if = force # ignore/add/remove/force 2812 2813# Whether to enforce that all blocks of an 'if'/'else if'/'else' chain either 2814# have, or do not have, braces. If true, braces will be added if any block 2815# needs braces, and will only be removed if they can be removed from all 2816# blocks. 2817# 2818# Overrides mod_full_brace_if. 2819mod_full_brace_if_chain = false # true/false 2820 2821# Whether to add braces to all blocks of an 'if'/'else if'/'else' chain. 2822# If true, mod_full_brace_if_chain will only remove braces from an 'if' that 2823# does not have an 'else if' or 'else'. 2824mod_full_brace_if_chain_only = false # true/false 2825 2826# Add or remove braces on single-line 'while' statement. 2827mod_full_brace_while = ignore # ignore/add/remove/force 2828 2829# Add or remove braces on single-line 'using ()' statement. 2830mod_full_brace_using = ignore # ignore/add/remove/force 2831 2832# Don't remove braces around statements that span N newlines 2833mod_full_brace_nl = 0 # unsigned number 2834 2835# Whether to prevent removal of braces from 'if'/'for'/'while'/etc. blocks 2836# which span multiple lines. 2837# 2838# Affects: 2839# mod_full_brace_for 2840# mod_full_brace_if 2841# mod_full_brace_if_chain 2842# mod_full_brace_if_chain_only 2843# mod_full_brace_while 2844# mod_full_brace_using 2845# 2846# Does not affect: 2847# mod_full_brace_do 2848# mod_full_brace_function 2849mod_full_brace_nl_block_rem_mlcond = false # true/false 2850 2851# Add or remove unnecessary parenthesis on 'return' statement. 2852mod_paren_on_return = ignore # ignore/add/remove/force 2853 2854# (Pawn) Whether to change optional semicolons to real semicolons. 2855mod_pawn_semicolon = false # true/false 2856 2857# Whether to fully parenthesize Boolean expressions in 'while' and 'if' 2858# statement, as in 'if (a && b > c)' => 'if (a && (b > c))'. 2859mod_full_paren_if_bool = false # true/false 2860 2861# Whether to remove superfluous semicolons. 2862mod_remove_extra_semicolon = false # true/false 2863 2864# If a function body exceeds the specified number of newlines and doesn't have 2865# a comment after the close brace, a comment will be added. 2866mod_add_long_function_closebrace_comment = 0 # unsigned number 2867 2868# If a namespace body exceeds the specified number of newlines and doesn't 2869# have a comment after the close brace, a comment will be added. 2870mod_add_long_namespace_closebrace_comment = 0 # unsigned number 2871 2872# If a class body exceeds the specified number of newlines and doesn't have a 2873# comment after the close brace, a comment will be added. 2874mod_add_long_class_closebrace_comment = 0 # unsigned number 2875 2876# If a switch body exceeds the specified number of newlines and doesn't have a 2877# comment after the close brace, a comment will be added. 2878mod_add_long_switch_closebrace_comment = 0 # unsigned number 2879 2880# If an #ifdef body exceeds the specified number of newlines and doesn't have 2881# a comment after the #endif, a comment will be added. 2882mod_add_long_ifdef_endif_comment = 0 # unsigned number 2883 2884# If an #ifdef or #else body exceeds the specified number of newlines and 2885# doesn't have a comment after the #else, a comment will be added. 2886mod_add_long_ifdef_else_comment = 0 # unsigned number 2887 2888# Whether to take care of the case by the mod_sort_xx options. 2889mod_sort_case_sensitive = false # true/false 2890 2891# Whether to sort consecutive single-line 'import' statements. 2892mod_sort_import = false # true/false 2893 2894# (C#) Whether to sort consecutive single-line 'using' statements. 2895mod_sort_using = false # true/false 2896 2897# Whether to sort consecutive single-line '#include' statements (C/C++) and 2898# '#import' statements (Objective-C). Be aware that this has the potential to 2899# break your code if your includes/imports have ordering dependencies. 2900mod_sort_include = false # true/false 2901 2902# Whether to prioritize '#include' and '#import' statements that contain 2903# filename without extension when sorting is enabled. 2904mod_sort_incl_import_prioritize_filename = false # true/false 2905 2906# Whether to prioritize '#include' and '#import' statements that does not 2907# contain extensions when sorting is enabled. 2908mod_sort_incl_import_prioritize_extensionless = false # true/false 2909 2910# Whether to prioritize '#include' and '#import' statements that contain 2911# angle over quotes when sorting is enabled. 2912mod_sort_incl_import_prioritize_angle_over_quotes = false # true/false 2913 2914# Whether to ignore file extension in '#include' and '#import' statements 2915# for sorting comparison. 2916mod_sort_incl_import_ignore_extension = false # true/false 2917 2918# Whether to group '#include' and '#import' statements when sorting is enabled. 2919mod_sort_incl_import_grouping_enabled = false # true/false 2920 2921# Whether to move a 'break' that appears after a fully braced 'case' before 2922# the close brace, as in 'case X: { ... } break;' => 'case X: { ... break; }'. 2923mod_move_case_break = false # true/false 2924 2925# Add or remove braces around a fully braced case statement. Will only remove 2926# braces if there are no variable declarations in the block. 2927mod_case_brace = ignore # ignore/add/remove/force 2928 2929# Whether to remove a void 'return;' that appears as the last statement in a 2930# function. 2931mod_remove_empty_return = true # true/false 2932 2933# Add or remove the comma after the last value of an enumeration. 2934mod_enum_last_comma = add # ignore/add/remove/force 2935 2936# (OC) Whether to organize the properties. If true, properties will be 2937# rearranged according to the mod_sort_oc_property_*_weight factors. 2938mod_sort_oc_properties = false # true/false 2939 2940# (OC) Weight of a class property modifier. 2941mod_sort_oc_property_class_weight = 0 # number 2942 2943# (OC) Weight of 'atomic' and 'nonatomic'. 2944mod_sort_oc_property_thread_safe_weight = 0 # number 2945 2946# (OC) Weight of 'readwrite' when organizing properties. 2947mod_sort_oc_property_readwrite_weight = 0 # number 2948 2949# (OC) Weight of a reference type specifier ('retain', 'copy', 'assign', 2950# 'weak', 'strong') when organizing properties. 2951mod_sort_oc_property_reference_weight = 0 # number 2952 2953# (OC) Weight of getter type ('getter=') when organizing properties. 2954mod_sort_oc_property_getter_weight = 0 # number 2955 2956# (OC) Weight of setter type ('setter=') when organizing properties. 2957mod_sort_oc_property_setter_weight = 0 # number 2958 2959# (OC) Weight of nullability type ('nullable', 'nonnull', 'null_unspecified', 2960# 'null_resettable') when organizing properties. 2961mod_sort_oc_property_nullability_weight = 0 # number 2962 2963# 2964# Preprocessor options 2965# 2966 2967# Add or remove indentation of preprocessor directives inside #if blocks 2968# at brace level 0 (file-level). 2969pp_indent = ignore # ignore/add/remove/force 2970 2971# Whether to indent #if/#else/#endif at the brace level. If false, these are 2972# indented from column 1. 2973pp_indent_at_level = false # true/false 2974 2975# Specifies the number of columns to indent preprocessors per level 2976# at brace level 0 (file-level). If pp_indent_at_level=false, also specifies 2977# the number of columns to indent preprocessors per level 2978# at brace level > 0 (function-level). 2979# 2980# Default: 1 2981pp_indent_count = 1 # unsigned number 2982 2983# Add or remove space after # based on pp_level of #if blocks. 2984pp_space = ignore # ignore/add/remove/force 2985 2986# Sets the number of spaces per level added with pp_space. 2987pp_space_count = 0 # unsigned number 2988 2989# The indent for '#region' and '#endregion' in C# and '#pragma region' in 2990# C/C++. Negative values decrease indent down to the first column. 2991pp_indent_region = 0 # number 2992 2993# Whether to indent the code between #region and #endregion. 2994pp_region_indent_code = false # true/false 2995 2996# If pp_indent_at_level=true, sets the indent for #if, #else and #endif when 2997# not at file-level. Negative values decrease indent down to the first column. 2998# 2999# =0: Indent preprocessors using output_tab_size 3000# >0: Column at which all preprocessors will be indented 3001pp_indent_if = 0 # number 3002 3003# Whether to indent the code between #if, #else and #endif. 3004pp_if_indent_code = false # true/false 3005 3006# Whether to indent '#define' at the brace level. If false, these are 3007# indented from column 1. 3008pp_define_at_level = false # true/false 3009 3010# Whether to ignore the '#define' body while formatting. 3011pp_ignore_define_body = false # true/false 3012 3013# Whether to indent case statements between #if, #else, and #endif. 3014# Only applies to the indent of the preprocesser that the case statements 3015# directly inside of. 3016# 3017# Default: true 3018pp_indent_case = true # true/false 3019 3020# Whether to indent whole function definitions between #if, #else, and #endif. 3021# Only applies to the indent of the preprocesser that the function definition 3022# is directly inside of. 3023# 3024# Default: true 3025pp_indent_func_def = true # true/false 3026 3027# Whether to indent extern C blocks between #if, #else, and #endif. 3028# Only applies to the indent of the preprocesser that the extern block is 3029# directly inside of. 3030# 3031# Default: true 3032pp_indent_extern = true # true/false 3033 3034# Whether to indent braces directly inside #if, #else, and #endif. 3035# Only applies to the indent of the preprocesser that the braces are directly 3036# inside of. 3037# 3038# Default: true 3039pp_indent_brace = true # true/false 3040 3041# 3042# Sort includes options 3043# 3044 3045# The regex for include category with priority 0. 3046include_category_0 = "" # string 3047 3048# The regex for include category with priority 1. 3049include_category_1 = "" # string 3050 3051# The regex for include category with priority 2. 3052include_category_2 = "" # string 3053 3054# 3055# Use or Do not Use options 3056# 3057 3058# true: indent_func_call_param will be used (default) 3059# false: indent_func_call_param will NOT be used 3060# 3061# Default: true 3062use_indent_func_call_param = true # true/false 3063 3064# The value of the indentation for a continuation line is calculated 3065# differently if the statement is: 3066# - a declaration: your case with QString fileName ... 3067# - an assignment: your case with pSettings = new QSettings( ... 3068# 3069# At the second case the indentation value might be used twice: 3070# - at the assignment 3071# - at the function call (if present) 3072# 3073# To prevent the double use of the indentation value, use this option with the 3074# value 'true'. 3075# 3076# true: indent_continue will be used only once 3077# false: indent_continue will be used every time (default) 3078use_indent_continue_only_once = false # true/false 3079 3080# The value might be used twice: 3081# - at the assignment 3082# - at the opening brace 3083# 3084# To prevent the double use of the indentation value, use this option with the 3085# value 'true'. 3086# 3087# true: indentation will be used only once 3088# false: indentation will be used every time (default) 3089indent_cpp_lambda_only_once = false # true/false 3090 3091# Whether sp_after_angle takes precedence over sp_inside_fparen. This was the 3092# historic behavior, but is probably not the desired behavior, so this is off 3093# by default. 3094use_sp_after_angle_always = false # true/false 3095 3096# Whether to apply special formatting for Qt SIGNAL/SLOT macros. Essentially, 3097# this tries to format these so that they match Qt's normalized form (i.e. the 3098# result of QMetaObject::normalizedSignature), which can slightly improve the 3099# performance of the QObject::connect call, rather than how they would 3100# otherwise be formatted. 3101# 3102# See options_for_QT.cpp for details. 3103# 3104# Default: true 3105use_options_overriding_for_qt_macros = true # true/false 3106 3107# If true: the form feed character is removed from the list 3108# of whitespace characters. 3109# See https://en.cppreference.com/w/cpp/string/byte/isspace 3110use_form_feed_no_more_as_whitespace_character = false # true/false 3111 3112# 3113# Warn levels - 1: error, 2: warning (default), 3: note 3114# 3115 3116# (C#) Warning is given if doing tab-to-\t replacement and we have found one 3117# in a C# verbatim string literal. 3118# 3119# Default: 2 3120warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number 3121 3122# Limit the number of loops. 3123# Used by uncrustify.cpp to exit from infinite loop. 3124# 0: no limit. 3125debug_max_number_of_loops = 0 # number 3126 3127# Set the number of the line to protocol; 3128# Used in the function prot_the_line if the 2. parameter is zero. 3129# 0: nothing protocol. 3130debug_line_number_to_protocol = 0 # number 3131 3132# Set the number of second(s) before terminating formatting the current file, 3133# 0: no timeout. 3134# only for linux 3135debug_timeout = 0 # number 3136 3137# Meaning of the settings: 3138# Ignore - do not do any changes 3139# Add - makes sure there is 1 or more space/brace/newline/etc 3140# Force - makes sure there is exactly 1 space/brace/newline/etc, 3141# behaves like Add in some contexts 3142# Remove - removes space/brace/newline/etc 3143# 3144# 3145# - Token(s) can be treated as specific type(s) with the 'set' option: 3146# `set tokenType tokenString [tokenString...]` 3147# 3148# Example: 3149# `set BOOL __AND__ __OR__` 3150# 3151# tokenTypes are defined in src/token_enum.h, use them without the 3152# 'CT_' prefix: 'CT_BOOL' => 'BOOL' 3153# 3154# 3155# - Token(s) can be treated as type(s) with the 'type' option. 3156# `type tokenString [tokenString...]` 3157# 3158# Example: 3159# `type int c_uint_8 Rectangle` 3160# 3161# This can also be achieved with `set TYPE int c_uint_8 Rectangle` 3162# 3163# 3164# To embed whitespace in tokenStrings use the '\' escape character, or quote 3165# the tokenStrings. These quotes are supported: "'` 3166# 3167# 3168# - Support for the auto detection of languages through the file ending can be 3169# added using the 'file_ext' command. 3170# `file_ext langType langString [langString..]` 3171# 3172# Example: 3173# `file_ext CPP .ch .cxx .cpp.in` 3174# 3175# langTypes are defined in uncrusify_types.h in the lang_flag_e enum, use 3176# them without the 'LANG_' prefix: 'LANG_CPP' => 'CPP' 3177# 3178# 3179# - Custom macro-based indentation can be set up using 'macro-open', 3180# 'macro-else' and 'macro-close'. 3181# `(macro-open | macro-else | macro-close) tokenString` 3182# 3183# Example: 3184# `macro-open BEGIN_TEMPLATE_MESSAGE_MAP` 3185# `macro-open BEGIN_MESSAGE_MAP` 3186# `macro-close END_MESSAGE_MAP` 3187# 3188# 3189# option(s) with 'not default' value: 0 3190# 3191