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