dcba6bbeddd0c59f49960d629fd278f51d05840f
[xonotic/xonotic-data.pk3dir.git] / qcsrc / uncrustify.cfg
1 # Uncrustify 0.60
2
3 #
4 # General options
5 #
6
7 # The type of line endings
8 # WARNING: Best is not unique (auto lf)
9 newlines                                 = auto     # auto/lf/crlf/cr
10
11 # The original size of tabs in the input
12 input_tab_size                           = 4        # number
13
14 # The size of tabs in the output (only used if align_with_tabs=true)
15 output_tab_size                          = 4        # number
16
17 # The ASCII value of the string escape char, usually 92 (\) or 94 (^). (Pawn)
18 string_escape_char                       = 92       # number #ignore
19
20 # Alternate string escape char for Pawn. Only works right before the quote char.
21 string_escape_char2                      = 0        # number #ignore
22
23 # Allow interpreting '>=' and '>>=' as part of a template in 'void f(list<list<B>>=val);'.
24 # If true (default), 'assert(x<0 && y>=3)' will be broken.
25 # Improvements to template detection may make this option obsolete.
26 # WARNING: Code doesn't seem to use this feature - delete from the config?
27 tok_split_gte                            = false    # false/true
28
29 # Control what to do with the UTF-8 BOM (recommend 'remove')
30 utf8_bom                                 = remove   # ignore/add/remove/force #force
31
32 # If the file contains bytes with values between 128 and 255, but is not UTF-8, then output as UTF-8
33 utf8_byte                                = true     # false/true #force
34
35 # Force the output encoding to UTF-8
36 utf8_force                               = true     # false/true #force
37
38 #
39 # Indenting
40 #
41
42 # The number of columns to indent per level.
43 # Usually 2, 3, 4, or 8.
44 indent_columns                           = 4        # number
45
46 # The continuation indent. If non-zero, this overrides the indent of '(' and '=' continuation indents.
47 # For FreeBSD, this is set to 4. Negative value is absolute and not increased for each ( level
48 indent_continue                          = indent_columns # number
49
50 # How to use tabs when indenting code
51 # 0=spaces only
52 # 1=indent with tabs to brace level, align with spaces
53 # 2=indent and align with tabs, using spaces when not on a tabstop
54 indent_with_tabs                         = 1        # number #force
55
56 # Comments that are not a brace level are indented with tabs on a tabstop.
57 # Requires indent_with_tabs=2. If false, will use spaces.
58 indent_cmt_with_tabs                     = false    # false/true
59
60 # Whether to indent strings broken by '\' so that they line up
61 # WARNING: Code doesn't seem to use this feature - delete from the config?
62 indent_align_string                      = false    # false/true
63
64 # The number of spaces to indent multi-line XML strings.
65 # Requires indent_align_string=True
66 # WARNING: Code doesn't seem to use this feature - delete from the config?
67 indent_xml_string                        = 0        # number
68
69 # Spaces to indent '{' from level
70 indent_brace                             = 0        # number
71
72 # Whether braces are indented to the body level
73 indent_braces                            = false    # false/true
74
75 # Disabled indenting function braces if indent_braces is true
76 # WARNING: Code doesn't seem to use this feature - delete from the config?
77 indent_braces_no_func                    = false    # false/true
78
79 # Disabled indenting class braces if indent_braces is true
80 # WARNING: Code doesn't seem to use this feature - delete from the config?
81 indent_braces_no_class                   = false    # false/true
82
83 # Disabled indenting struct braces if indent_braces is true
84 # WARNING: Code doesn't seem to use this feature - delete from the config?
85 indent_braces_no_struct                  = false    # false/true
86
87 # Indent based on the size of the brace parent, i.e. 'if' => 3 spaces, 'for' => 4 spaces, etc.
88 indent_brace_parent                      = false    # false/true
89
90 # Whether the 'namespace' body is indented
91 # WARNING: Code doesn't seem to use this feature - delete from the config?
92 indent_namespace                         = false    # false/true
93
94 # The number of spaces to indent a namespace block
95 # WARNING: Code doesn't seem to use this feature - delete from the config?
96 indent_namespace_level                   = 0        # number
97
98 # If the body of the namespace is longer than this number, it won't be indented.
99 # Requires indent_namespace=true. Default=0 (no limit)
100 # WARNING: Code doesn't seem to use this feature - delete from the config?
101 indent_namespace_limit                   = 0        # number
102
103 # Whether the 'extern "C"' body is indented
104 # WARNING: Code doesn't seem to use this feature - delete from the config?
105 indent_extern                            = false    # false/true
106
107 # Whether the 'class' body is indented
108 # WARNING: Code doesn't seem to use this feature - delete from the config?
109 indent_class                             = false    # false/true
110
111 # Whether to indent the stuff after a leading class colon
112 # WARNING: Code doesn't seem to use this feature - delete from the config?
113 indent_class_colon                       = false    # false/true
114
115 # Virtual indent from the ':' for member initializers. Default is 2
116 # WARNING: Code doesn't seem to use this feature - delete from the config?
117 indent_ctor_init_leading                 = 0        # number
118
119 # Additional indenting for constructor initializer list
120 # WARNING: Code doesn't seem to use this feature - delete from the config?
121 indent_ctor_init                         = 0        # number
122
123 # False=treat 'else\nif' as 'else if' for indenting purposes
124 # True=indent the 'if' one level
125 indent_else_if                           = true     # false/true
126
127 # Amount to indent variable declarations after a open brace. neg=relative, pos=absolute
128 indent_var_def_blk                       = 0        # number
129
130 # Indent continued variable declarations instead of aligning.
131 # WARNING: Code doesn't seem to use this feature - delete from the config?
132 indent_var_def_cont                      = false    # false/true
133
134 # True:  force indentation of function definition to start in column 1
135 # False: use the default behavior
136 indent_func_def_force_col1               = false    # false/true
137
138 # True:  indent continued function call parameters one indent level
139 # False: align parameters under the open paren
140 indent_func_call_param                   = true     # false/true
141
142 # Same as indent_func_call_param, but for function defs
143 indent_func_def_param                    = true     # false/true
144
145 # Same as indent_func_call_param, but for function protos
146 indent_func_proto_param                  = true     # false/true
147
148 # Same as indent_func_call_param, but for class declarations
149 # WARNING: Code doesn't seem to use this feature - delete from the config?
150 indent_func_class_param                  = false    # false/true
151
152 # Same as indent_func_call_param, but for class variable constructors
153 # WARNING: Code doesn't seem to use this feature - delete from the config?
154 indent_func_ctor_var_param               = false    # false/true
155
156 # Same as indent_func_call_param, but for templates
157 # WARNING: Code doesn't seem to use this feature - delete from the config?
158 indent_template_param                    = false    # false/true
159
160 # Double the indent for indent_func_xxx_param options
161 indent_func_param_double                 = false    # false/true
162
163 # Indentation column for standalone 'const' function decl/proto qualifier
164 # WARNING: Code doesn't seem to use this feature - delete from the config?
165 indent_func_const                        = 0        # number
166
167 # Indentation column for standalone 'throw' function decl/proto qualifier
168 # WARNING: Code doesn't seem to use this feature - delete from the config?
169 indent_func_throw                        = 0        # number
170
171 # The number of spaces to indent a continued '->' or '.'
172 # Usually set to 0, 1, or indent_columns.
173 indent_member                            = 0        # number
174
175 # Spaces to indent single line ('//') comments on lines before code
176 indent_sing_line_comments                = 0        # number
177
178 # If set, will indent trailing single line ('//') comments relative
179 # to the code instead of trying to keep the same absolute column
180 indent_relative_single_line_comments     = true    # false/true #force
181
182 # Spaces to indent 'case' from 'switch'
183 # Usually 0 or indent_columns.
184 indent_switch_case                       = indent_columns # number
185
186 # Spaces to shift the 'case' line, without affecting any other lines
187 # Usually 0.
188 indent_case_shift                        = 0        # number
189
190 # Spaces to indent '{' from 'case'.
191 # By default, the brace will appear under the 'c' in case.
192 # Usually set to 0 or indent_columns.
193 indent_case_brace                        = 0        # number
194
195 # Whether to indent comments found in first column
196 indent_col1_comment                      = false    # false/true
197
198 # How to indent goto labels
199 #  >0 : absolute column where 1 is the leftmost column
200 #  <=0 : subtract from brace indent
201 # WARNING: Code doesn't seem to use this feature - delete from the config?
202 indent_label                             = 0        # number
203
204 # Same as indent_label, but for access specifiers that are followed by a colon
205 # WARNING: Code doesn't seem to use this feature - delete from the config?
206 indent_access_spec                       = 0        # number
207
208 # Indent the code after an access specifier by one level.
209 # If set, this option forces 'indent_access_spec=0'
210 # WARNING: Code doesn't seem to use this feature - delete from the config?
211 indent_access_spec_body                  = false    # false/true
212
213 # If an open paren is followed by a newline, indent the next line so that it lines up after the open paren (not recommended)
214 # WARNING: Code doesn't seem to use this feature - delete from the config?
215 indent_paren_nl                          = false    # false/true
216
217 # Controls the indent of a close paren after a newline.
218 # 0: Indent to body level
219 # 1: Align under the open paren
220 # 2: Indent to the brace level
221 indent_paren_close                       = 1        # number #force
222
223 # Controls the indent of a comma when inside a paren.If TRUE, aligns under the open paren
224 # WARNING: Code doesn't seem to use this feature - delete from the config?
225 indent_comma_paren                       = false    # false/true
226
227 # Controls the indent of a BOOL operator when inside a paren.If TRUE, aligns under the open paren
228 # WARNING: Code doesn't seem to use this feature - delete from the config?
229 indent_bool_paren                        = false    # false/true
230
231 # If 'indent_bool_paren' is true, controls the indent of the first expression. If TRUE, aligns the first expression to the following ones
232 # WARNING: Code doesn't seem to use this feature - delete from the config?
233 indent_first_bool_expr                   = false    # false/true
234
235 # If an open square is followed by a newline, indent the next line so that it lines up after the open square (not recommended)
236 # WARNING: Code doesn't seem to use this feature - delete from the config?
237 indent_square_nl                         = false    # false/true
238
239 # Don't change the relative indent of ESQL/C 'EXEC SQL' bodies
240 # WARNING: Code doesn't seem to use this feature - delete from the config?
241 indent_preserve_sql                      = false    # false/true
242
243 # Align continued statements at the '='. Default=True
244 # If FALSE or the '=' is followed by a newline, the next line is indent one tab.
245 # WARNING: Code doesn't seem to use this feature - delete from the config?
246 indent_align_assign                      = false    # false/true
247
248 # Indent OC blocks at brace level instead of usual rules.
249 indent_oc_block                          = false    # false/true #ignore
250
251 # Indent OC blocks in a message relative to the parameter name.
252 # 0=use indent_oc_block rules, 1+=spaces to indent #ignore
253 indent_oc_block_msg                      = 0        # number #ignore
254
255 # Minimum indent for subsequent parameters
256 indent_oc_msg_colon                      = 0        # number #ignore
257
258 #
259 # Spacing options
260 #
261
262 # Add or remove space around arithmetic operator '+', '-', '/', '*', etc
263 sp_arith                                 = ignore   # ignore/add/remove/force #force
264
265 # Add or remove space around assignment operator '=', '+=', etc
266 # NOTE: is 44 worse than ignore
267 sp_assign                                = add      # ignore/add/remove/force
268
269 # Add or remove space around '=' in C++11 lambda capture specifications. Overrides sp_assign
270 # WARNING: Code doesn't seem to use this feature - delete from the config?
271 sp_cpp_lambda_assign                     = ignore   # ignore/add/remove/force
272
273 # Add or remove space after the capture specification in C++11 lambda.
274 # WARNING: Code doesn't seem to use this feature - delete from the config?
275 sp_cpp_lambda_paren                      = ignore   # ignore/add/remove/force
276
277 # Add or remove space around assignment operator '=' in a prototype
278 # WARNING: Code doesn't seem to use this feature - delete from the config?
279 sp_assign_default                        = ignore   # ignore/add/remove/force
280
281 # Add or remove space before assignment operator '=', '+=', etc. Overrides sp_assign.
282 sp_before_assign                         = ignore   # ignore/add/remove/force #force
283
284 # Add or remove space after assignment operator '=', '+=', etc. Overrides sp_assign.
285 sp_after_assign                          = ignore   # ignore/add/remove/force #force
286
287 # Add or remove space around assignment '=' in enum
288 # WARNING: Code doesn't seem to use this feature - delete from the config?
289 sp_enum_assign                           = ignore   # ignore/add/remove/force
290
291 # Add or remove space before assignment '=' in enum. Overrides sp_enum_assign.
292 sp_enum_before_assign                    = ignore   # ignore/add/remove/force #force
293
294 # Add or remove space after assignment '=' in enum. Overrides sp_enum_assign.
295 sp_enum_after_assign                     = ignore   # ignore/add/remove/force #force
296
297 # Add or remove space around preprocessor '##' concatenation operator. Default=Add
298 # NOTE: is 4 worse than ignore
299 sp_pp_concat                             = remove   # ignore/add/remove/force
300
301 # Add or remove space after preprocessor '#' stringify operator. Also affects the '#@' charizing operator.
302 sp_pp_stringify                          = remove   # ignore/add/remove/force
303
304 # Add or remove space before preprocessor '#' stringify operator as in '#define x(y) L#y'.
305 sp_before_pp_stringify                   = add      # ignore/add/remove/force
306
307 # Add or remove space around boolean operators '&&' and '||'
308 # NOTE: is 2 worse than ignore
309 sp_bool                                  = add      # ignore/add/remove/force
310
311 # Add or remove space around compare operator '<', '>', '==', etc
312 # NOTE: is 196 worse than ignore
313 sp_compare                               = add      # ignore/add/remove/force
314
315 # Add or remove space inside '(' and ')'
316 # NOTE: is 10 worse than ignore
317 sp_inside_paren                          = remove   # ignore/add/remove/force
318
319 # Add or remove space between nested parens
320 # NOTE: is 14 worse than ignore
321 sp_paren_paren                           = remove   # ignore/add/remove/force
322
323 # Whether to balance spaces inside nested parens
324 sp_balance_nested_parens                 = false    # false/true
325
326 # Add or remove space between ')' and '{'
327 # WARNING: Code doesn't seem to use this feature - delete from the config?
328 sp_paren_brace                           = ignore   # ignore/add/remove/force
329
330 # Add or remove space before pointer star '*'
331 # WARNING: Code doesn't seem to use this feature - delete from the config?
332 sp_before_ptr_star                       = ignore   # ignore/add/remove/force
333
334 # Add or remove space before pointer star '*' that isn't followed by a variable name
335 # If set to 'ignore', sp_before_ptr_star is used instead.
336 sp_before_unnamed_ptr_star               = add      # ignore/add/remove/force
337
338 # Add or remove space between pointer stars '*'
339 # WARNING: Code doesn't seem to use this feature - delete from the config?
340 sp_between_ptr_star                      = ignore   # ignore/add/remove/force
341
342 # Add or remove space after pointer star '*', if followed by a word.
343 sp_after_ptr_star                        = add      # ignore/add/remove/force
344
345 # Add or remove space after a pointer star '*', if followed by a func proto/def.
346 sp_after_ptr_star_func                   = add      # ignore/add/remove/force
347
348 # Add or remove space after a pointer star '*', if followed by an open paren (function types).
349 # WARNING: Code doesn't seem to use this feature - delete from the config?
350 sp_ptr_star_paren                        = ignore   # ignore/add/remove/force
351
352 # Add or remove space before a pointer star '*', if followed by a func proto/def.
353 sp_before_ptr_star_func                  = add      # ignore/add/remove/force
354
355 # Add or remove space before a reference sign '&'
356 # WARNING: Code doesn't seem to use this feature - delete from the config?
357 sp_before_byref                          = ignore   # ignore/add/remove/force
358
359 # Add or remove space before a reference sign '&' that isn't followed by a variable name
360 # If set to 'ignore', sp_before_byref is used instead.
361 # WARNING: Code doesn't seem to use this feature - delete from the config?
362 sp_before_unnamed_byref                  = ignore   # ignore/add/remove/force
363
364 # Add or remove space after reference sign '&', if followed by a word.
365 # WARNING: Code doesn't seem to use this feature - delete from the config?
366 sp_after_byref                           = ignore   # ignore/add/remove/force
367
368 # Add or remove space after a reference sign '&', if followed by a func proto/def.
369 # WARNING: Code doesn't seem to use this feature - delete from the config?
370 sp_after_byref_func                      = ignore   # ignore/add/remove/force
371
372 # Add or remove space before a reference sign '&', if followed by a func proto/def.
373 # WARNING: Code doesn't seem to use this feature - delete from the config?
374 sp_before_byref_func                     = ignore   # ignore/add/remove/force
375
376 # Add or remove space between type and word. Default=Force
377 sp_after_type                            = add      # ignore/add/remove/force
378
379 # Add or remove space before the paren in the D constructs 'template Foo(' and 'class Foo('.
380 # WARNING: Code doesn't seem to use this feature - delete from the config?
381 sp_before_template_paren                 = ignore   # ignore/add/remove/force
382
383 # Add or remove space in 'template <' vs 'template<'.
384 # If set to ignore, sp_before_angle is used.
385 # WARNING: Code doesn't seem to use this feature - delete from the config?
386 sp_template_angle                        = ignore   # ignore/add/remove/force
387
388 # Add or remove space before '<>'
389 # WARNING: Code doesn't seem to use this feature - delete from the config?
390 sp_before_angle                          = ignore   # ignore/add/remove/force
391
392 # Add or remove space inside '<' and '>'
393 # WARNING: Code doesn't seem to use this feature - delete from the config?
394 sp_inside_angle                          = ignore   # ignore/add/remove/force
395
396 # Add or remove space after '<>'
397 # WARNING: Code doesn't seem to use this feature - delete from the config?
398 sp_after_angle                           = ignore   # ignore/add/remove/force
399
400 # Add or remove space between '<>' and '(' as found in 'new List<byte>();'
401 # WARNING: Code doesn't seem to use this feature - delete from the config?
402 sp_angle_paren                           = ignore   # ignore/add/remove/force
403
404 # Add or remove space between '<>' and a word as in 'List<byte> m;'
405 # WARNING: Code doesn't seem to use this feature - delete from the config?
406 sp_angle_word                            = ignore   # ignore/add/remove/force
407
408 # Add or remove space between '>' and '>' in '>>' (template stuff C++/C# only). Default=Add
409 # WARNING: Code doesn't seem to use this feature - delete from the config?
410 sp_angle_shift                           = ignore   # ignore/add/remove/force
411
412 # Permit removal of the space between '>>' in 'foo<bar<int> >' (C++11 only). Default=False
413 # sp_angle_shift cannot remove the space without this option.
414 # WARNING: Code doesn't seem to use this feature - delete from the config?
415 sp_permit_cpp11_shift                    = false    # false/true
416
417 # Add or remove space before '(' of 'if', 'for', 'switch', and 'while'
418 sp_before_sparen                         = remove   # ignore/add/remove/force #force
419
420 # Add or remove space inside if-condition '(' and ')'
421 # NOTE: is 42 worse than ignore
422 sp_inside_sparen                         = remove   # ignore/add/remove/force
423
424 # Add or remove space before if-condition ')'. Overrides sp_inside_sparen.
425 sp_inside_sparen_close                   = ignore   # ignore/add/remove/force #force
426
427 # Add or remove space before if-condition '('. Overrides sp_inside_sparen.
428 sp_inside_sparen_open                    = ignore   # ignore/add/remove/force #force
429
430 # Add or remove space after ')' of 'if', 'for', 'switch', and 'while'
431 # WARNING: Code doesn't seem to use this feature - delete from the config?
432 sp_after_sparen                          = ignore   # ignore/add/remove/force
433
434 # Add or remove space between ')' and '{' of 'if', 'for', 'switch', and 'while'
435 sp_sparen_brace                          = add      # ignore/add/remove/force
436
437 # Add or remove space between 'invariant' and '(' in the D language.
438 sp_invariant_paren                       = ignore   # ignore/add/remove/force #ignore
439
440 # Add or remove space after the ')' in 'invariant (C) c' in the D language.
441 sp_after_invariant_paren                 = ignore   # ignore/add/remove/force #ignore
442
443 # Add or remove space before empty statement ';' on 'if', 'for' and 'while'
444 # WARNING: Code doesn't seem to use this feature - delete from the config?
445 sp_special_semi                          = ignore   # ignore/add/remove/force
446
447 # Add or remove space before ';'. Default=Remove
448 # NOTE: is 2 worse than ignore
449 sp_before_semi                           = remove   # ignore/add/remove/force
450
451 # Add or remove space before ';' in non-empty 'for' statements
452 sp_before_semi_for                       = remove   # ignore/add/remove/force
453
454 # Add or remove space before a semicolon of an empty part of a for statement.
455 sp_before_semi_for_empty                 = add      # ignore/add/remove/force
456
457 # Add or remove space after ';', except when followed by a comment. Default=Add
458 # NOTE: is 56 worse than ignore
459 sp_after_semi                            = add      # ignore/add/remove/force
460
461 # Add or remove space after ';' in non-empty 'for' statements. Default=Force
462 sp_after_semi_for                        = add      # ignore/add/remove/force
463
464 # Add or remove space after the final semicolon of an empty part of a for statement: for ( ; ; <here> ).
465 sp_after_semi_for_empty                  = add      # ignore/add/remove/force
466
467 # Add or remove space before '[' (except '[]')
468 sp_before_square                         = remove   # ignore/add/remove/force
469
470 # Add or remove space before '[]'
471 # WARNING: Code doesn't seem to use this feature - delete from the config?
472 sp_before_squares                        = ignore   # ignore/add/remove/force
473
474 # Add or remove space inside a non-empty '[' and ']'
475 sp_inside_square                         = remove   # ignore/add/remove/force
476
477 # Add or remove space after ','
478 # NOTE: is 742 worse than ignore
479 sp_after_comma                           = add      # ignore/add/remove/force #force
480
481 # Add or remove space before ','
482 # NOTE: is 58 worse than ignore
483 sp_before_comma                          = remove   # ignore/add/remove/force
484
485 # Add or remove space between an open paren and comma: '(,' vs '( ,'
486 # WARNING: Code doesn't seem to use this feature - delete from the config?
487 sp_paren_comma                           = ignore   # ignore/add/remove/force
488
489 # Add or remove space before the variadic '...' when preceded by a non-punctuator
490 # WARNING: Code doesn't seem to use this feature - delete from the config?
491 sp_before_ellipsis                       = ignore   # ignore/add/remove/force
492
493 # Add or remove space after class ':'
494 # WARNING: Code doesn't seem to use this feature - delete from the config?
495 sp_after_class_colon                     = ignore   # ignore/add/remove/force
496
497 # Add or remove space before class ':'
498 # WARNING: Code doesn't seem to use this feature - delete from the config?
499 sp_before_class_colon                    = ignore   # ignore/add/remove/force
500
501 # Add or remove space before case ':'. Default=Remove
502 sp_before_case_colon                     = remove   # ignore/add/remove/force
503
504 # Add or remove space between 'operator' and operator sign
505 # WARNING: Code doesn't seem to use this feature - delete from the config?
506 sp_after_operator                        = ignore   # ignore/add/remove/force
507
508 # Add or remove space between the operator symbol and the open paren, as in 'operator ++('
509 # WARNING: Code doesn't seem to use this feature - delete from the config?
510 sp_after_operator_sym                    = ignore   # ignore/add/remove/force
511
512 # Add or remove space after C/D cast, i.e. 'cast(int)a' vs 'cast(int) a' or '(int)a' vs '(int) a'
513 # WARNING: Code doesn't seem to use this feature - delete from the config?
514 sp_after_cast                            = ignore   # ignore/add/remove/force
515
516 # Add or remove spaces inside cast parens
517 sp_inside_paren_cast                     = remove   # ignore/add/remove/force
518
519 # Add or remove space between the type and open paren in a C++ cast, i.e. 'int(exp)' vs 'int (exp)'
520 sp_cpp_cast_paren                        = remove   # ignore/add/remove/force
521
522 # Add or remove space between 'sizeof' and '('
523 # WARNING: Code doesn't seem to use this feature - delete from the config?
524 sp_sizeof_paren                          = ignore   # ignore/add/remove/force
525
526 # Add or remove space after the tag keyword (Pawn)
527 sp_after_tag                             = ignore   # ignore/add/remove/force #ignore
528
529 # Add or remove space inside enum '{' and '}'
530 # WARNING: Code doesn't seem to use this feature - delete from the config?
531 sp_inside_braces_enum                    = ignore   # ignore/add/remove/force
532
533 # Add or remove space inside struct/union '{' and '}'
534 # WARNING: Code doesn't seem to use this feature - delete from the config?
535 sp_inside_braces_struct                  = ignore   # ignore/add/remove/force
536
537 # Add or remove space inside '{' and '}'
538 sp_inside_braces                         = add      # ignore/add/remove/force
539
540 # Add or remove space inside '{}'
541 # NOTE: is 10 worse than ignore
542 sp_inside_braces_empty                   = remove   # ignore/add/remove/force
543
544 # Add or remove space between return type and function name
545 # A minimum of 1 is forced except for pointer return types.
546 sp_type_func                             = add      # ignore/add/remove/force
547
548 # Add or remove space between function name and '(' on function declaration
549 # NOTE: is 30 worse than ignore
550 sp_func_proto_paren                      = remove   # ignore/add/remove/force
551
552 # Add or remove space between function name and '(' on function definition
553 # NOTE: is 400 worse than ignore
554 sp_func_def_paren                        = remove   # ignore/add/remove/force
555
556 # Add or remove space inside empty function '()'
557 sp_inside_fparens                        = remove   # ignore/add/remove/force
558
559 # Add or remove space inside function '(' and ')'
560 # NOTE: is 78 worse than ignore
561 sp_inside_fparen                         = remove   # ignore/add/remove/force
562
563 # Add or remove space inside the first parens in the function type: 'void (*x)(...)'
564 # WARNING: Code doesn't seem to use this feature - delete from the config?
565 sp_inside_tparen                         = ignore   # ignore/add/remove/force
566
567 # Add or remove between the parens in the function type: 'void (*x)(...)'
568 # WARNING: Code doesn't seem to use this feature - delete from the config?
569 sp_after_tparen_close                    = ignore   # ignore/add/remove/force
570
571 # Add or remove space between ']' and '(' when part of a function call.
572 # WARNING: Code doesn't seem to use this feature - delete from the config?
573 sp_square_fparen                         = ignore   # ignore/add/remove/force
574
575 # Add or remove space between ')' and '{' of function
576 sp_fparen_brace                          = add      # ignore/add/remove/force
577
578 # Add or remove space between function name and '(' on function calls
579 # NOTE: is 940 worse than ignore
580 sp_func_call_paren                       = remove   # ignore/add/remove/force
581
582 # Add or remove space between function name and '()' on function calls without parameters.
583 # If set to 'ignore' (the default), sp_func_call_paren is used.
584 sp_func_call_paren_empty                 = remove   # ignore/add/remove/force
585
586 # Add or remove space between the user function name and '(' on function calls
587 # You need to set a keyword to be a user function, like this: 'set func_call_user _' in the config file.
588 sp_func_call_user_paren                  = remove   # ignore/add/remove/force
589
590 # Add or remove space between a constructor/destructor and the open paren
591 sp_func_class_paren                      = remove   # ignore/add/remove/force
592
593 # Add or remove space between 'return' and '('
594 # WARNING: Code doesn't seem to use this feature - delete from the config?
595 sp_return_paren                          = ignore   # ignore/add/remove/force
596
597 # Add or remove space between '__attribute__' and '('
598 # WARNING: Code doesn't seem to use this feature - delete from the config?
599 sp_attribute_paren                       = ignore   # ignore/add/remove/force
600
601 # Add or remove space between 'defined' and '(' in '#if defined (FOO)'
602 # WARNING: Code doesn't seem to use this feature - delete from the config?
603 sp_defined_paren                         = ignore   # ignore/add/remove/force
604
605 # Add or remove space between 'throw' and '(' in 'throw (something)'
606 # WARNING: Code doesn't seem to use this feature - delete from the config?
607 sp_throw_paren                           = ignore   # ignore/add/remove/force
608
609 # Add or remove space between 'throw' and anything other than '(' as in '@throw [...];'
610 # WARNING: Code doesn't seem to use this feature - delete from the config?
611 sp_after_throw                           = ignore   # ignore/add/remove/force
612
613 # Add or remove space between 'catch' and '(' in 'catch (something) { }'
614 # If set to ignore, sp_before_sparen is used.
615 # WARNING: Code doesn't seem to use this feature - delete from the config?
616 sp_catch_paren                           = ignore   # ignore/add/remove/force
617
618 # Add or remove space between 'version' and '(' in 'version (something) { }' (D language)
619 # If set to ignore, sp_before_sparen is used.
620 sp_version_paren                         = ignore   # ignore/add/remove/force #ignore
621
622 # Add or remove space between 'scope' and '(' in 'scope (something) { }' (D language)
623 # If set to ignore, sp_before_sparen is used.
624 sp_scope_paren                           = ignore   # ignore/add/remove/force #ignore
625
626 # Add or remove space between macro and value
627 sp_macro                                 = remove   # ignore/add/remove/force #force
628
629 # Add or remove space between macro function ')' and value
630 sp_macro_func                            = remove   # ignore/add/remove/force #force
631
632 # Add or remove space between 'else' and '{' if on the same line
633 sp_else_brace                            = add      # ignore/add/remove/force
634
635 # Add or remove space between '}' and 'else' if on the same line
636 # WARNING: Code doesn't seem to use this feature - delete from the config?
637 sp_brace_else                            = ignore   # ignore/add/remove/force
638
639 # Add or remove space between '}' and the name of a typedef on the same line
640 sp_brace_typedef                         = add      # ignore/add/remove/force
641
642 # Add or remove space between 'catch' and '{' if on the same line
643 # WARNING: Code doesn't seem to use this feature - delete from the config?
644 sp_catch_brace                           = ignore   # ignore/add/remove/force
645
646 # Add or remove space between '}' and 'catch' if on the same line
647 # WARNING: Code doesn't seem to use this feature - delete from the config?
648 sp_brace_catch                           = ignore   # ignore/add/remove/force
649
650 # Add or remove space between 'finally' and '{' if on the same line
651 # WARNING: Code doesn't seem to use this feature - delete from the config?
652 sp_finally_brace                         = ignore   # ignore/add/remove/force
653
654 # Add or remove space between '}' and 'finally' if on the same line
655 # WARNING: Code doesn't seem to use this feature - delete from the config?
656 sp_brace_finally                         = ignore   # ignore/add/remove/force
657
658 # Add or remove space between 'try' and '{' if on the same line
659 # WARNING: Code doesn't seem to use this feature - delete from the config?
660 sp_try_brace                             = ignore   # ignore/add/remove/force
661
662 # Add or remove space between get/set and '{' if on the same line
663 # WARNING: Code doesn't seem to use this feature - delete from the config?
664 sp_getset_brace                          = ignore   # ignore/add/remove/force
665
666 # Add or remove space before the '::' operator
667 # WARNING: Code doesn't seem to use this feature - delete from the config?
668 sp_before_dc                             = ignore   # ignore/add/remove/force
669
670 # Add or remove space after the '::' operator
671 # WARNING: Code doesn't seem to use this feature - delete from the config?
672 sp_after_dc                              = ignore   # ignore/add/remove/force
673
674 # Add or remove around the D named array initializer ':' operator
675 sp_d_array_colon                         = ignore   # ignore/add/remove/force #ignore
676
677 # Add or remove space after the '!' (not) operator. Default=Remove
678 sp_not                                   = remove   # ignore/add/remove/force
679
680 # Add or remove space after the '~' (invert) operator. Default=Remove
681 sp_inv                                   = remove   # ignore/add/remove/force
682
683 # Add or remove space after the '&' (address-of) operator. Default=Remove
684 # This does not affect the spacing after a '&' that is part of a type.
685 # WARNING: Code doesn't seem to use this feature - delete from the config?
686 sp_addr                                  = ignore   # ignore/add/remove/force
687
688 # Add or remove space around the '.' or '->' operators. Default=Remove
689 # NOTE: is 28 worse than ignore
690 sp_member                                = remove   # ignore/add/remove/force
691
692 # Add or remove space after the '*' (dereference) operator. Default=Remove
693 # This does not affect the spacing after a '*' that is part of a type.
694 # WARNING: Code doesn't seem to use this feature - delete from the config?
695 sp_deref                                 = ignore   # ignore/add/remove/force
696
697 # Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'. Default=Remove
698 # NOTE: is 4 worse than ignore
699 sp_sign                                  = remove   # ignore/add/remove/force
700
701 # Add or remove space before or after '++' and '--', as in '(--x)' or 'y++;'. Default=Remove
702 sp_incdec                                = remove   # ignore/add/remove/force
703
704 # Add or remove space before a backslash-newline at the end of a line. Default=Add
705 sp_before_nl_cont                        = add      # ignore/add/remove/force #force
706
707 # Add or remove space after the scope '+' or '-', as in '-(void) foo;' or '+(int) bar;'
708 sp_after_oc_scope                        = ignore   # ignore/add/remove/force #ignore
709
710 # Add or remove space after the colon in message specs
711 # '-(int) f:(int) x;' vs '-(int) f: (int) x;'
712 sp_after_oc_colon                        = ignore   # ignore/add/remove/force #ignore
713
714 # Add or remove space before the colon in message specs
715 # '-(int) f: (int) x;' vs '-(int) f : (int) x;'
716 sp_before_oc_colon                       = ignore   # ignore/add/remove/force #ignore
717
718 # Add or remove space after the colon in immutable dictionary expression
719 # 'NSDictionary *test = @{@"foo" :@"bar"};'
720 sp_after_oc_dict_colon                   = ignore   # ignore/add/remove/force #ignore
721
722 # Add or remove space before the colon in immutable dictionary expression
723 # 'NSDictionary *test = @{@"foo" :@"bar"};'
724 sp_before_oc_dict_colon                  = ignore   # ignore/add/remove/force #ignore
725
726 # Add or remove space after the colon in message specs
727 # '[object setValue:1];' vs '[object setValue: 1];'
728 sp_after_send_oc_colon                   = ignore   # ignore/add/remove/force #ignore
729
730 # Add or remove space before the colon in message specs
731 # '[object setValue:1];' vs '[object setValue :1];'
732 sp_before_send_oc_colon                  = ignore   # ignore/add/remove/force #ignore
733
734 # Add or remove space after the (type) in message specs
735 # '-(int)f: (int) x;' vs '-(int)f: (int)x;'
736 sp_after_oc_type                         = ignore   # ignore/add/remove/force #ignore
737
738 # Add or remove space after the first (type) in message specs
739 # '-(int) f:(int)x;' vs '-(int)f:(int)x;'
740 sp_after_oc_return_type                  = ignore   # ignore/add/remove/force #ignore
741
742 # Add or remove space between '@selector' and '('
743 # '@selector(msgName)' vs '@selector (msgName)'
744 # Also applies to @protocol() constructs
745 sp_after_oc_at_sel                       = ignore   # ignore/add/remove/force #ignore
746
747 # Add or remove space between '@selector(x)' and the following word
748 # '@selector(foo) a:' vs '@selector(foo)a:'
749 sp_after_oc_at_sel_parens                = ignore   # ignore/add/remove/force #ignore
750
751 # Add or remove space inside '@selector' parens
752 # '@selector(foo)' vs '@selector( foo )'
753 # Also applies to @protocol() constructs
754 sp_inside_oc_at_sel_parens               = ignore   # ignore/add/remove/force #ignore
755
756 # Add or remove space before a block pointer caret
757 # '^int (int arg){...}' vs. ' ^int (int arg){...}'
758 sp_before_oc_block_caret                 = ignore   # ignore/add/remove/force #ignore
759
760 # Add or remove space after a block pointer caret
761 # '^int (int arg){...}' vs. '^ int (int arg){...}'
762 sp_after_oc_block_caret                  = ignore   # ignore/add/remove/force #ignore
763
764 # Add or remove space between the receiver and selector in a message.
765 # '[receiver selector ...]'
766 sp_after_oc_msg_receiver                 = ignore   # ignore/add/remove/force #ignore
767
768 # Add or remove space after @property.
769 sp_after_oc_property                     = ignore   # ignore/add/remove/force #ignore
770
771 # Add or remove space around the ':' in 'b ? t : f'
772 sp_cond_colon                            = add      # ignore/add/remove/force
773
774 # Add or remove space around the '?' in 'b ? t : f'
775 sp_cond_question                         = add      # ignore/add/remove/force
776
777 # Fix the spacing between 'case' and the label. Only 'ignore' and 'force' make sense here.
778 # WARNING: Code doesn't seem to use this feature - delete from the config?
779 sp_case_label                            = ignore   # ignore/add/remove/force
780
781 # Control the space around the D '..' operator.
782 # WARNING: Code doesn't seem to use this feature - delete from the config?
783 sp_range                                 = ignore   # ignore/add/remove/force
784
785 # Control the spacing after ':' in 'for (TYPE VAR : EXPR)' (Java)
786 # WARNING: Code doesn't seem to use this feature - delete from the config?
787 sp_after_for_colon                       = ignore   # ignore/add/remove/force
788
789 # Control the spacing before ':' in 'for (TYPE VAR : EXPR)' (Java)
790 # WARNING: Code doesn't seem to use this feature - delete from the config?
791 sp_before_for_colon                      = ignore   # ignore/add/remove/force
792
793 # Control the spacing in 'extern (C)' (D)
794 # WARNING: Code doesn't seem to use this feature - delete from the config?
795 sp_extern_paren                          = ignore   # ignore/add/remove/force
796
797 # Control the space after the opening of a C++ comment '// A' vs '//A'
798 sp_cmt_cpp_start                         = add      # ignore/add/remove/force #force
799
800 # Controls the spaces between #else or #endif and a trailing comment
801 # WARNING: Code doesn't seem to use this feature - delete from the config?
802 sp_endif_cmt                             = ignore   # ignore/add/remove/force
803
804 # Controls the spaces after 'new', 'delete', and 'delete[]'
805 # WARNING: Code doesn't seem to use this feature - delete from the config?
806 sp_after_new                             = ignore   # ignore/add/remove/force
807
808 # Controls the spaces before a trailing or embedded comment
809 sp_before_tr_emb_cmt                     = force    # ignore/add/remove/force #force
810
811 # Number of spaces before a trailing or embedded comment
812 sp_num_before_tr_emb_cmt                 = 2        # number #force
813
814 # Control space between a Java annotation and the open paren.
815 # WARNING: Code doesn't seem to use this feature - delete from the config?
816 sp_annotation_paren                      = ignore   # ignore/add/remove/force
817
818 #
819 # Code alignment (not left column spaces/tabs)
820 #
821
822 # Whether to keep non-indenting tabs
823 align_keep_tabs                          = false    # false/true #force
824
825 # Whether to use tabs for aligning
826 # WARNING: Code doesn't seem to use this feature - delete from the config?
827 align_with_tabs                          = false    # false/true
828
829 # Whether to bump out to the next tab when aligning
830 align_on_tabstop                         = false    # false/true
831
832 # Whether to left-align numbers
833 # WARNING: Code doesn't seem to use this feature - delete from the config?
834 align_number_left                        = false    # false/true
835
836 # Align variable definitions in prototypes and functions
837 # WARNING: Code doesn't seem to use this feature - delete from the config?
838 align_func_params                        = false    # false/true
839
840 # Align parameters in single-line functions that have the same name.
841 # The function names must already be aligned with each other.
842 align_same_func_call_params              = false    # false/true
843
844 # The span for aligning variable definitions (0=don't align)
845 align_var_def_span                       = 0        # number
846
847 # How to align the star in variable definitions.
848 #  0=Part of the type     'void *   foo;'
849 #  1=Part of the variable 'void     *foo;'
850 #  2=Dangling             'void    *foo;'
851 # WARNING: Code doesn't seem to use this feature - delete from the config?
852 align_var_def_star_style                 = 0        # number
853
854 # How to align the '&' in variable definitions.
855 #  0=Part of the type
856 #  1=Part of the variable
857 #  2=Dangling
858 # WARNING: Code doesn't seem to use this feature - delete from the config?
859 align_var_def_amp_style                  = 0        # number
860
861 # The threshold for aligning variable definitions (0=no limit)
862 # WARNING: Code doesn't seem to use this feature - delete from the config?
863 align_var_def_thresh                     = 0        # number
864
865 # The gap for aligning variable definitions
866 # WARNING: Code doesn't seem to use this feature - delete from the config?
867 align_var_def_gap                        = 0        # number
868
869 # Whether to align the colon in struct bit fields
870 # WARNING: Code doesn't seem to use this feature - delete from the config?
871 align_var_def_colon                      = false    # false/true
872
873 # Whether to align any attribute after the variable name
874 # WARNING: Code doesn't seem to use this feature - delete from the config?
875 align_var_def_attribute                  = false    # false/true
876
877 # Whether to align inline struct/enum/union variable definitions
878 # WARNING: Code doesn't seem to use this feature - delete from the config?
879 align_var_def_inline                     = false    # false/true
880
881 # The span for aligning on '=' in assignments (0=don't align)
882 align_assign_span                        = 0        # number
883
884 # The threshold for aligning on '=' in assignments (0=no limit)
885 # WARNING: Code doesn't seem to use this feature - delete from the config?
886 align_assign_thresh                      = 0        # number
887
888 # The span for aligning on '=' in enums (0=don't align)
889 # WARNING: Code doesn't seem to use this feature - delete from the config?
890 align_enum_equ_span                      = 0        # number
891
892 # The threshold for aligning on '=' in enums (0=no limit)
893 # WARNING: Code doesn't seem to use this feature - delete from the config?
894 align_enum_equ_thresh                    = 0        # number
895
896 # The span for aligning struct/union (0=don't align)
897 align_var_struct_span                    = 0        # number
898
899 # The threshold for aligning struct/union member definitions (0=no limit)
900 # WARNING: Code doesn't seem to use this feature - delete from the config?
901 align_var_struct_thresh                  = 0        # number
902
903 # The gap for aligning struct/union member definitions
904 # WARNING: Code doesn't seem to use this feature - delete from the config?
905 align_var_struct_gap                     = 0        # number
906
907 # The span for aligning struct initializer values (0=don't align)
908 align_struct_init_span                   = 0        # number
909
910 # The minimum space between the type and the synonym of a typedef
911 # WARNING: Code doesn't seem to use this feature - delete from the config?
912 align_typedef_gap                        = 0        # number
913
914 # The span for aligning single-line typedefs (0=don't align)
915 # WARNING: Code doesn't seem to use this feature - delete from the config?
916 align_typedef_span                       = 0        # number
917
918 # How to align typedef'd functions with other typedefs
919 # 0: Don't mix them at all
920 # 1: align the open paren with the types
921 # 2: align the function type name with the other type names
922 # WARNING: Code doesn't seem to use this feature - delete from the config?
923 align_typedef_func                       = 0        # number
924
925 # Controls the positioning of the '*' in typedefs. Just try it.
926 # 0: Align on typedef type, ignore '*'
927 # 1: The '*' is part of type name: typedef int  *pint;
928 # 2: The '*' is part of the type, but dangling: typedef int *pint;
929 # WARNING: Code doesn't seem to use this feature - delete from the config?
930 align_typedef_star_style                 = 0        # number
931
932 # Controls the positioning of the '&' in typedefs. Just try it.
933 # 0: Align on typedef type, ignore '&'
934 # 1: The '&' is part of type name: typedef int  &pint;
935 # 2: The '&' is part of the type, but dangling: typedef int &pint;
936 # WARNING: Code doesn't seem to use this feature - delete from the config?
937 align_typedef_amp_style                  = 0        # number
938
939 # The span for aligning comments that end lines (0=don't align)
940 align_right_cmt_span                     = 2        # number
941
942 # If aligning comments, mix with comments after '}' and #endif with less than 3 spaces before the comment
943 align_right_cmt_mix                      = false    # false/true
944
945 # If a trailing comment is more than this number of columns away from the text it follows,
946 # it will qualify for being aligned. This has to be > 0 to do anything.
947 # WARNING: Best is not unique (0 1)
948 align_right_cmt_gap                      = 0        # number
949
950 # Align trailing comment at or beyond column N; 'pulls in' comments as a bonus side effect (0=ignore)
951 # WARNING: Best is not unique (1 2)
952 align_right_cmt_at_col                   = 0        # number
953
954 # The span for aligning function prototypes (0=don't align)
955 align_func_proto_span                    = 0        # number
956
957 # Minimum gap between the return type and the function name.
958 # WARNING: Code doesn't seem to use this feature - delete from the config?
959 align_func_proto_gap                     = 0        # number
960
961 # Align function protos on the 'operator' keyword instead of what follows
962 # WARNING: Code doesn't seem to use this feature - delete from the config?
963 align_on_operator                        = false    # false/true
964
965 # Whether to mix aligning prototype and variable declarations.
966 # If true, align_var_def_XXX options are used instead of align_func_proto_XXX options.
967 # WARNING: Code doesn't seem to use this feature - delete from the config?
968 align_mix_var_proto                      = false    # false/true
969
970 # Align single-line functions with function prototypes, uses align_func_proto_span
971 # WARNING: Code doesn't seem to use this feature - delete from the config?
972 align_single_line_func                   = false    # false/true
973
974 # Aligning the open brace of single-line functions.
975 # Requires align_single_line_func=true, uses align_func_proto_span
976 # WARNING: Code doesn't seem to use this feature - delete from the config?
977 align_single_line_brace                  = false    # false/true
978
979 # Gap for align_single_line_brace.
980 # WARNING: Code doesn't seem to use this feature - delete from the config?
981 align_single_line_brace_gap              = 0        # number
982
983 # The span for aligning ObjC msg spec (0=don't align)
984 align_oc_msg_spec_span                   = 0        # number #ignore
985
986 # Whether to align macros wrapped with a backslash and a newline.
987 # This will not work right if the macro contains a multi-line comment.
988 align_nl_cont                            = false    # false/true
989
990 # # Align macro functions and variables together
991 # WARNING: Code doesn't seem to use this feature - delete from the config?
992 align_pp_define_together                 = false    # false/true
993
994 # The minimum space between label and value of a preprocessor define
995 # WARNING: Code doesn't seem to use this feature - delete from the config?
996 align_pp_define_gap                      = 0        # number
997
998 # The span for aligning on '#define' bodies (0=don't align)
999 align_pp_define_span                     = 0        # number
1000
1001 # Align lines that start with '<<' with previous '<<'. Default=true
1002 # WARNING: Code doesn't seem to use this feature - delete from the config?
1003 align_left_shift                         = false    # false/true
1004
1005 # Span for aligning parameters in an Obj-C message call on the ':' (0=don't align)
1006 align_oc_msg_colon_span                  = 0        # number #ignore
1007
1008 # If true, always align with the first parameter, even if it is too short.
1009 align_oc_msg_colon_first                 = false    # false/true #ignore
1010
1011 # Aligning parameters in an Obj-C '+' or '-' declaration on the ':'
1012 align_oc_decl_colon                      = false    # false/true #ignore
1013
1014 #
1015 # Newline adding and removing options
1016 #
1017
1018 # Whether to collapse empty blocks between '{' and '}'
1019 nl_collapse_empty_body                   = false    # false/true
1020
1021 # Don't split one-line braced assignments - 'foo_t f = { 1, 2 };'
1022 # WARNING: Code doesn't seem to use this feature - delete from the config?
1023 nl_assign_leave_one_liners               = false    # false/true
1024
1025 # Don't split one-line braced statements inside a class xx { } body
1026 # WARNING: Code doesn't seem to use this feature - delete from the config?
1027 nl_class_leave_one_liners                = false    # false/true
1028
1029 # Don't split one-line enums: 'enum foo { BAR = 15 };'
1030 # WARNING: Code doesn't seem to use this feature - delete from the config?
1031 nl_enum_leave_one_liners                 = false    # false/true
1032
1033 # Don't split one-line get or set functions
1034 # WARNING: Code doesn't seem to use this feature - delete from the config?
1035 nl_getset_leave_one_liners               = false    # false/true
1036
1037 # Don't split one-line function definitions - 'int foo() { return 0; }'
1038 nl_func_leave_one_liners                 = true     # false/true
1039
1040 # Don't split one-line if/else statements - 'if(a) b++;'
1041 nl_if_leave_one_liners                   = true     # false/true
1042
1043 # Don't split one-line OC messages
1044 nl_oc_msg_leave_one_liner                = false    # false/true #ignore
1045
1046 # Add or remove newlines at the start of the file
1047 nl_start_of_file                         = remove   # ignore/add/remove/force #force
1048
1049 # The number of newlines at the start of the file (only used if nl_start_of_file is 'add' or 'force'
1050 nl_start_of_file_min                     = 0        # number #force
1051
1052 # Add or remove newline at the end of the file
1053 nl_end_of_file                           = add      # ignore/add/remove/force #force
1054
1055 # The number of newlines at the end of the file (only used if nl_end_of_file is 'add' or 'force')
1056 nl_end_of_file_min                       = 1        # number #force
1057
1058 # Add or remove newline between '=' and '{'
1059 # WARNING: Code doesn't seem to use this feature - delete from the config?
1060 nl_assign_brace                          = ignore   # ignore/add/remove/force
1061
1062 # Add or remove newline between '=' and '[' (D only)
1063 # WARNING: Code doesn't seem to use this feature - delete from the config?
1064 nl_assign_square                         = ignore   # ignore/add/remove/force
1065
1066 # Add or remove newline after '= [' (D only). Will also affect the newline before the ']'
1067 # WARNING: Code doesn't seem to use this feature - delete from the config?
1068 nl_after_square_assign                   = ignore   # ignore/add/remove/force
1069
1070 # The number of blank lines after a block of variable definitions at the top of a function body
1071 # 0 = No change (default)
1072 nl_func_var_def_blk                      = 0        # number #force
1073
1074 # The number of newlines before a block of typedefs
1075 # 0 = No change (default)
1076 nl_typedef_blk_start                     = 0        # number #force
1077
1078 # The number of newlines after a block of typedefs
1079 # 0 = No change (default)
1080 nl_typedef_blk_end                       = 0        # number #force
1081
1082 # The maximum consecutive newlines within a block of typedefs
1083 # 0 = No change (default)
1084 # WARNING: Best is not unique (0 2)
1085 nl_typedef_blk_in                        = 0        # number
1086
1087 # The number of newlines before a block of variable definitions not at the top of a function body
1088 # 0 = No change (default)
1089 # WARNING: Best is not unique (0 1)
1090 nl_var_def_blk_start                     = 0        # number
1091
1092 # The number of newlines after a block of variable definitions not at the top of a function body
1093 # 0 = No change (default)
1094 # WARNING: Best is not unique (0 1)
1095 nl_var_def_blk_end                       = 0        # number
1096
1097 # The maximum consecutive newlines within a block of variable definitions
1098 # 0 = No change (default)
1099 # WARNING: Best is not unique (0 3)
1100 nl_var_def_blk_in                        = 0        # number
1101
1102 # Add or remove newline between a function call's ')' and '{', as in:
1103 # list_for_each(item, &list) { }
1104 # NOTE: is 28 worse than ignore
1105 nl_fcall_brace                           = add      # ignore/add/remove/force
1106
1107 # Add or remove newline between 'enum' and '{'
1108 # WARNING: Code doesn't seem to use this feature - delete from the config?
1109 nl_enum_brace                            = ignore   # ignore/add/remove/force
1110
1111 # Add or remove newline between 'struct and '{'
1112 nl_struct_brace                          = add      # ignore/add/remove/force
1113
1114 # Add or remove newline between 'union' and '{'
1115 # WARNING: Code doesn't seem to use this feature - delete from the config?
1116 nl_union_brace                           = ignore   # ignore/add/remove/force
1117
1118 # Add or remove newline between 'if' and '{'
1119 # NOTE: is 245 worse than ignore
1120 nl_if_brace                              = add      # ignore/add/remove/force
1121
1122 # Add or remove newline between '}' and 'else'
1123 nl_brace_else                            = add      # ignore/add/remove/force
1124
1125 # Add or remove newline between 'else if' and '{'
1126 # If set to ignore, nl_if_brace is used instead
1127 nl_elseif_brace                          = add      # ignore/add/remove/force
1128
1129 # Add or remove newline between 'else' and '{'
1130 nl_else_brace                            = add      # ignore/add/remove/force
1131
1132 # Add or remove newline between 'else' and 'if'
1133 nl_else_if                               = remove   # ignore/add/remove/force
1134
1135 # Add or remove newline between '}' and 'finally'
1136 # WARNING: Code doesn't seem to use this feature - delete from the config?
1137 nl_brace_finally                         = ignore   # ignore/add/remove/force
1138
1139 # Add or remove newline between 'finally' and '{'
1140 # WARNING: Code doesn't seem to use this feature - delete from the config?
1141 nl_finally_brace                         = ignore   # ignore/add/remove/force
1142
1143 # Add or remove newline between 'try' and '{'
1144 # WARNING: Code doesn't seem to use this feature - delete from the config?
1145 nl_try_brace                             = ignore   # ignore/add/remove/force
1146
1147 # Add or remove newline between get/set and '{'
1148 # WARNING: Code doesn't seem to use this feature - delete from the config?
1149 nl_getset_brace                          = ignore   # ignore/add/remove/force
1150
1151 # Add or remove newline between 'for' and '{'
1152 # NOTE: is 93 worse than ignore
1153 nl_for_brace                             = add      # ignore/add/remove/force
1154
1155 # Add or remove newline between 'catch' and '{'
1156 # WARNING: Code doesn't seem to use this feature - delete from the config?
1157 nl_catch_brace                           = ignore   # ignore/add/remove/force
1158
1159 # Add or remove newline between '}' and 'catch'
1160 # WARNING: Code doesn't seem to use this feature - delete from the config?
1161 nl_brace_catch                           = ignore   # ignore/add/remove/force
1162
1163 # Add or remove newline between 'while' and '{'
1164 # NOTE: is 21 worse than ignore
1165 nl_while_brace                           = add      # ignore/add/remove/force
1166
1167 # Add or remove newline between 'scope (x)' and '{' (D)
1168 # WARNING: Code doesn't seem to use this feature - delete from the config?
1169 nl_scope_brace                           = ignore   # ignore/add/remove/force
1170
1171 # Add or remove newline between 'unittest' and '{' (D)
1172 # WARNING: Code doesn't seem to use this feature - delete from the config?
1173 nl_unittest_brace                        = ignore   # ignore/add/remove/force
1174
1175 # Add or remove newline between 'version (x)' and '{' (D)
1176 # WARNING: Code doesn't seem to use this feature - delete from the config?
1177 nl_version_brace                         = ignore   # ignore/add/remove/force
1178
1179 # Add or remove newline between 'using' and '{'
1180 # WARNING: Code doesn't seem to use this feature - delete from the config?
1181 nl_using_brace                           = ignore   # ignore/add/remove/force
1182
1183 # Add or remove newline between two open or close braces.
1184 # Due to general newline/brace handling, REMOVE may not work.
1185 nl_brace_brace                           = remove   # ignore/add/remove/force
1186
1187 # Add or remove newline between 'do' and '{'
1188 # NOTE: is 3 worse than ignore
1189 nl_do_brace                              = add      # ignore/add/remove/force
1190
1191 # Add or remove newline between '}' and 'while' of 'do' statement
1192 nl_brace_while                           = add      # ignore/add/remove/force #force
1193
1194 # Add or remove newline between 'switch' and '{'
1195 # NOTE: is 21 worse than ignore
1196 nl_switch_brace                          = add      # ignore/add/remove/force
1197
1198 # Add a newline between ')' and '{' if the ')' is on a different line than the if/for/etc.
1199 # Overrides nl_for_brace, nl_if_brace, nl_switch_brace, nl_while_switch, and nl_catch_brace.
1200 # WARNING: Code doesn't seem to use this feature - delete from the config?
1201 nl_multi_line_cond                       = false    # false/true
1202
1203 # Force a newline in a define after the macro name for multi-line defines.
1204 nl_multi_line_define                     = false    # false/true
1205
1206 # Whether to put a newline before 'case' statement
1207 nl_before_case                           = false    # false/true
1208
1209 # Add or remove newline between ')' and 'throw'
1210 # WARNING: Code doesn't seem to use this feature - delete from the config?
1211 nl_before_throw                          = ignore   # ignore/add/remove/force
1212
1213 # Whether to put a newline after 'case' statement
1214 nl_after_case                            = false    # false/true
1215
1216 # Add or remove a newline between a case ':' and '{'. Overrides nl_after_case.
1217 # NOTE: is 27 worse than ignore
1218 nl_case_colon_brace                      = add      # ignore/add/remove/force
1219
1220 # Newline between namespace and {
1221 # WARNING: Code doesn't seem to use this feature - delete from the config?
1222 nl_namespace_brace                       = ignore   # ignore/add/remove/force
1223
1224 # Add or remove newline between 'template<>' and whatever follows.
1225 # WARNING: Code doesn't seem to use this feature - delete from the config?
1226 nl_template_class                        = ignore   # ignore/add/remove/force
1227
1228 # Add or remove newline between 'class' and '{'
1229 # WARNING: Code doesn't seem to use this feature - delete from the config?
1230 nl_class_brace                           = ignore   # ignore/add/remove/force
1231
1232 # Add or remove newline after each ',' in the constructor member initialization
1233 # WARNING: Code doesn't seem to use this feature - delete from the config?
1234 nl_class_init_args                       = ignore   # ignore/add/remove/force
1235
1236 # Add or remove newline between return type and function name in a function definition
1237 nl_func_type_name                        = remove   # ignore/add/remove/force
1238
1239 # Add or remove newline between return type and function name inside a class {}
1240 # Uses nl_func_type_name or nl_func_proto_type_name if set to ignore.
1241 # WARNING: Code doesn't seem to use this feature - delete from the config?
1242 nl_func_type_name_class                  = ignore   # ignore/add/remove/force
1243
1244 # Add or remove newline between function scope and name in a definition
1245 # Controls the newline after '::' in 'void A::f() { }'
1246 # WARNING: Code doesn't seem to use this feature - delete from the config?
1247 nl_func_scope_name                       = ignore   # ignore/add/remove/force
1248
1249 # Add or remove newline between return type and function name in a prototype
1250 # NOTE: is 6 worse than ignore
1251 nl_func_proto_type_name                  = remove   # ignore/add/remove/force
1252
1253 # Add or remove newline between a function name and the opening '('
1254 nl_func_paren                            = remove   # ignore/add/remove/force
1255
1256 # Add or remove newline between a function name and the opening '(' in the definition
1257 nl_func_def_paren                        = remove   # ignore/add/remove/force
1258
1259 # Add or remove newline after '(' in a function declaration
1260 # NOTE: is 6 worse than ignore
1261 nl_func_decl_start                       = remove   # ignore/add/remove/force
1262
1263 # Add or remove newline after '(' in a function definition
1264 # NOTE: is 23 worse than ignore
1265 nl_func_def_start                        = remove   # ignore/add/remove/force
1266
1267 # Overrides nl_func_decl_start when there is only one parameter.
1268 nl_func_decl_start_single                = ignore   # ignore/add/remove/force #force
1269
1270 # Overrides nl_func_def_start when there is only one parameter.
1271 nl_func_def_start_single                 = ignore   # ignore/add/remove/force #force
1272
1273 # Add or remove newline after each ',' in a function declaration
1274 # NOTE: is 38 worse than ignore
1275 nl_func_decl_args                        = remove   # ignore/add/remove/force
1276
1277 # Add or remove newline after each ',' in a function definition
1278 # NOTE: is 37 worse than ignore
1279 nl_func_def_args                         = remove   # ignore/add/remove/force
1280
1281 # Add or remove newline before the ')' in a function declaration
1282 nl_func_decl_end                         = remove   # ignore/add/remove/force
1283
1284 # Add or remove newline before the ')' in a function definition
1285 nl_func_def_end                          = remove   # ignore/add/remove/force
1286
1287 # Overrides nl_func_decl_end when there is only one parameter.
1288 nl_func_decl_end_single                  = ignore   # ignore/add/remove/force #force
1289
1290 # Overrides nl_func_def_end when there is only one parameter.
1291 nl_func_def_end_single                   = ignore   # ignore/add/remove/force #force
1292
1293 # Add or remove newline between '()' in a function declaration.
1294 nl_func_decl_empty                       = remove   # ignore/add/remove/force
1295
1296 # Add or remove newline between '()' in a function definition.
1297 nl_func_def_empty                        = remove   # ignore/add/remove/force
1298
1299 # Whether to put each OC message parameter on a separate line
1300 # See nl_oc_msg_leave_one_liner #ignore
1301 nl_oc_msg_args                           = false    # false/true #ignore
1302
1303 # Add or remove newline between function signature and '{'
1304 # NOTE: is 156 worse than ignore
1305 nl_fdef_brace                            = add      # ignore/add/remove/force
1306
1307 # Add or remove a newline between the return keyword and return expression.
1308 # NOTE: is 15 worse than ignore
1309 nl_return_expr                           = remove   # ignore/add/remove/force
1310
1311 # Whether to put a newline after semicolons, except in 'for' statements
1312 nl_after_semicolon                       = false    # false/true
1313
1314 # Whether to put a newline after brace open.
1315 # This also adds a newline before the matching brace close.
1316 nl_after_brace_open                      = false    # false/true
1317
1318 # If nl_after_brace_open and nl_after_brace_open_cmt are true, a newline is
1319 # placed between the open brace and a trailing single-line comment.
1320 # WARNING: Code doesn't seem to use this feature - delete from the config?
1321 nl_after_brace_open_cmt                  = false    # false/true
1322
1323 # Whether to put a newline after a virtual brace open with a non-empty body.
1324 # These occur in un-braced if/while/do/for statement bodies.
1325 nl_after_vbrace_open                     = false    # false/true
1326
1327 # Whether to put a newline after a virtual brace open with an empty body.
1328 # These occur in un-braced if/while/do/for statement bodies.
1329 # WARNING: Code doesn't seem to use this feature - delete from the config?
1330 nl_after_vbrace_open_empty               = false    # false/true
1331
1332 # Whether to put a newline after a brace close.
1333 # Does not apply if followed by a necessary ';'.
1334 nl_after_brace_close                     = false    # false/true
1335
1336 # Whether to put a newline after a virtual brace close.
1337 # Would add a newline before return in: 'if (foo) a++; return;'
1338 nl_after_vbrace_close                    = false    # false/true
1339
1340 # Control the newline between the close brace and 'b' in: 'struct { int a; } b;'
1341 # Affects enums, unions, and structures. If set to ignore, uses nl_after_brace_close
1342 nl_brace_struct_var                      = remove   # ignore/add/remove/force
1343
1344 # Whether to alter newlines in '#define' macros
1345 nl_define_macro                          = false    # false/true
1346
1347 # Whether to not put blanks after '#ifxx', '#elxx', or before '#endif'
1348 nl_squeeze_ifdef                         = false    # false/true
1349
1350 # Add or remove blank line before 'if'
1351 nl_before_if                             = ignore   # ignore/add/remove/force #force
1352
1353 # Add or remove blank line after 'if' statement
1354 nl_after_if                              = ignore   # ignore/add/remove/force #force
1355
1356 # Add or remove blank line before 'for'
1357 nl_before_for                            = ignore   # ignore/add/remove/force #force
1358
1359 # Add or remove blank line after 'for' statement
1360 nl_after_for                             = ignore   # ignore/add/remove/force #force
1361
1362 # Add or remove blank line before 'while'
1363 nl_before_while                          = ignore   # ignore/add/remove/force #force
1364
1365 # Add or remove blank line after 'while' statement
1366 nl_after_while                           = ignore   # ignore/add/remove/force #force
1367
1368 # Add or remove blank line before 'switch'
1369 nl_before_switch                         = ignore   # ignore/add/remove/force #force
1370
1371 # Add or remove blank line after 'switch' statement
1372 nl_after_switch                          = ignore   # ignore/add/remove/force #force
1373
1374 # Add or remove blank line before 'do'
1375 nl_before_do                             = ignore   # ignore/add/remove/force #force
1376
1377 # Add or remove blank line after 'do/while' statement
1378 nl_after_do                              = ignore   # ignore/add/remove/force #force
1379
1380 # Whether to double-space commented-entries in struct/enum
1381 # WARNING: Code doesn't seem to use this feature - delete from the config?
1382 nl_ds_struct_enum_cmt                    = false    # false/true
1383
1384 # Whether to double-space before the close brace of a struct/union/enum
1385 # (lower priority than 'eat_blanks_before_close_brace')
1386 # WARNING: Code doesn't seem to use this feature - delete from the config?
1387 nl_ds_struct_enum_close_brace            = false    # false/true
1388
1389 # Add or remove a newline around a class colon.
1390 # Related to pos_class_colon, nl_class_init_args, and pos_comma.
1391 # WARNING: Code doesn't seem to use this feature - delete from the config?
1392 nl_class_colon                           = ignore   # ignore/add/remove/force
1393
1394 # Change simple unbraced if statements into a one-liner
1395 # 'if(b)\n i++;' => 'if(b) i++;'
1396 nl_create_if_one_liner                   = false    # false/true
1397
1398 # Change simple unbraced for statements into a one-liner
1399 # 'for (i=0;i<5;i++)\n foo(i);' => 'for (i=0;i<5;i++) foo(i);'
1400 nl_create_for_one_liner                  = false    # false/true
1401
1402 # Change simple unbraced while statements into a one-liner
1403 # 'while (i<5)\n foo(i++);' => 'while (i<5) foo(i++);'
1404 nl_create_while_one_liner                = false    # false/true
1405
1406 #
1407 # Positioning options
1408 #
1409
1410 # The position of arithmetic operators in wrapped expressions
1411 pos_arith                                = join     # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1412
1413 # The position of assignment in wrapped expressions.
1414 # Do not affect '=' followed by '{'
1415 pos_assign                               = join     # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1416
1417 # The position of boolean operators in wrapped expressions
1418 pos_bool                                 = join     # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1419
1420 # The position of comparison operators in wrapped expressions
1421 # WARNING: Best is not unique (join lead)
1422 pos_compare                              = ignore   # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1423
1424 # The position of conditional (b ? t : f) operators in wrapped expressions
1425 # NOTE: is 4 worse than ignore
1426 pos_conditional                          = trail    # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1427
1428 # The position of the comma in wrapped expressions
1429 # NOTE: is 2 worse than ignore
1430 pos_comma                                = trail    # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1431
1432 # The position of the comma in the constructor initialization list
1433 # WARNING: Code doesn't seem to use this feature - delete from the config?
1434 pos_class_comma                          = ignore   # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1435
1436 # The position of colons between constructor and member initialization
1437 # WARNING: Code doesn't seem to use this feature - delete from the config?
1438 pos_class_colon                          = ignore   # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force
1439
1440 #
1441 # Line Splitting options
1442 #
1443
1444 # Try to limit code width to N number of columns
1445 code_width                               = 0        # number
1446
1447 # Whether to fully split long 'for' statements at semi-colons
1448 # WARNING: Code doesn't seem to use this feature - delete from the config?
1449 ls_for_split_full                        = false    # false/true
1450
1451 # Whether to fully split long function protos/calls at commas
1452 # WARNING: Code doesn't seem to use this feature - delete from the config?
1453 ls_func_split_full                       = false    # false/true
1454
1455 # Whether to split lines as close to code_width as possible and ignore some groupings
1456 # WARNING: Code doesn't seem to use this feature - delete from the config?
1457 ls_code_width                            = false    # false/true
1458
1459 #
1460 # Blank line options
1461 #
1462
1463 # The maximum consecutive newlines
1464 nl_max                                   = 3        # number #force
1465
1466 # The number of newlines after a function prototype, if followed by another function prototype
1467 # WARNING: Best is not unique (0 1)
1468 nl_after_func_proto                      = 0        # number
1469
1470 # The number of newlines after a function prototype, if not followed by another function prototype
1471 # WARNING: Best is not unique (0 1)
1472 nl_after_func_proto_group                = 0        # number
1473
1474 # The number of newlines after '}' of a multi-line function body
1475 nl_after_func_body                       = 0        # number
1476
1477 # The number of newlines after '}' of a multi-line function body in a class declaration
1478 # WARNING: Code doesn't seem to use this feature - delete from the config?
1479 nl_after_func_body_class                 = 0        # number
1480
1481 # The number of newlines after '}' of a single line function body
1482 # WARNING: Best is not unique (0 1)
1483 nl_after_func_body_one_liner             = 0        # number
1484
1485 # The minimum number of newlines before a multi-line comment.
1486 # Doesn't apply if after a brace open or another multi-line comment.
1487 # WARNING: Best is not unique (0 1)
1488 nl_before_block_comment                  = 0        # number
1489
1490 # The minimum number of newlines before a single-line C comment.
1491 # Doesn't apply if after a brace open or other single-line C comments.
1492 # WARNING: Best is not unique (0 1)
1493 nl_before_c_comment                      = 0        # number
1494
1495 # The minimum number of newlines before a CPP comment.
1496 # Doesn't apply if after a brace open or other CPP comments.
1497 # WARNING: Best is not unique (0 1)
1498 nl_before_cpp_comment                    = 0        # number
1499
1500 # Whether to force a newline after a multi-line comment.
1501 # WARNING: Code doesn't seem to use this feature - delete from the config?
1502 nl_after_multiline_comment               = false    # false/true
1503
1504 # The number of newlines after '}' or ';' of a struct/enum/union definition
1505 # WARNING: Code doesn't seem to use this feature - delete from the config?
1506 nl_after_struct                          = 0        # number
1507
1508 # The number of newlines after '}' or ';' of a class definition
1509 # WARNING: Code doesn't seem to use this feature - delete from the config?
1510 nl_after_class                           = 0        # number
1511
1512 # The number of newlines before a 'private:', 'public:', 'protected:', 'signals:', or 'slots:' label.
1513 # Will not change the newline count if after a brace open.
1514 # 0 = No change.
1515 # WARNING: Code doesn't seem to use this feature - delete from the config?
1516 nl_before_access_spec                    = 0        # number
1517
1518 # The number of newlines after a 'private:', 'public:', 'protected:', 'signals:', or 'slots:' label.
1519 # 0 = No change.
1520 # WARNING: Code doesn't seem to use this feature - delete from the config?
1521 nl_after_access_spec                     = 0        # number
1522
1523 # The number of newlines between a function def and the function comment.
1524 # 0 = No change.
1525 nl_comment_func_def                      = 0        # number
1526
1527 # The number of newlines after a try-catch-finally block that isn't followed by a brace close.
1528 # 0 = No change.
1529 # WARNING: Code doesn't seem to use this feature - delete from the config?
1530 nl_after_try_catch_finally               = 0        # number
1531
1532 # The number of newlines before and after a property, indexer or event decl.
1533 # 0 = No change.
1534 # WARNING: Code doesn't seem to use this feature - delete from the config?
1535 nl_around_cs_property                    = 0        # number
1536
1537 # The number of newlines between the get/set/add/remove handlers in C#.
1538 # 0 = No change.
1539 # WARNING: Code doesn't seem to use this feature - delete from the config?
1540 nl_between_get_set                       = 0        # number
1541
1542 # Add or remove newline between C# property and the '{'
1543 # WARNING: Code doesn't seem to use this feature - delete from the config?
1544 nl_property_brace                        = ignore   # ignore/add/remove/force
1545
1546 # Whether to remove blank lines after '{'
1547 eat_blanks_after_open_brace              = true     # false/true #force
1548
1549 # Whether to remove blank lines before '}'
1550 eat_blanks_before_close_brace            = true     # false/true #force
1551
1552 # How aggressively to remove extra newlines not in preproc.
1553 # 0: No change
1554 # 1: Remove most newlines not handled by other config
1555 # 2: Remove all newlines and reformat completely by config
1556 # ERROR: nl_remove_extra_newlines = 1 crashes with status 139.
1557 # ERROR: nl_remove_extra_newlines = 2 crashes with status 139.
1558 # WARNING: Best is not unique (0 indent_columns)
1559 nl_remove_extra_newlines                 = 0        # number
1560
1561 # Whether to put a blank line before 'return' statements, unless after an open brace.
1562 nl_before_return                         = false    # false/true #force
1563
1564 # Whether to put a blank line after 'return' statements, unless followed by a close brace.
1565 nl_after_return                          = false    # false/true #force
1566
1567 # Whether to put a newline after a Java annotation statement.
1568 # Only affects annotations that are after a newline.
1569 # WARNING: Code doesn't seem to use this feature - delete from the config?
1570 nl_after_annotation                      = ignore   # ignore/add/remove/force
1571
1572 # Controls the newline between two annotations.
1573 # WARNING: Code doesn't seem to use this feature - delete from the config?
1574 nl_between_annotation                    = ignore   # ignore/add/remove/force
1575
1576 #
1577 # Code modifying options (non-whitespace)
1578 #
1579
1580 # Add or remove braces on single-line 'do' statement
1581 mod_full_brace_do                        = add      # ignore/add/remove/force
1582
1583 # Add or remove braces on single-line 'for' statement
1584 # NOTE: is 5 worse than ignore
1585 mod_full_brace_for                       = remove   # ignore/add/remove/force
1586
1587 # Add or remove braces on single-line function definitions. (Pawn)
1588 mod_full_brace_function                  = ignore   # ignore/add/remove/force #ignore
1589
1590 # Add or remove braces on single-line 'if' statement. Will not remove the braces if they contain an 'else'.
1591 mod_full_brace_if                        = add      # ignore/add/remove/force
1592
1593 # Make all if/elseif/else statements in a chain be braced or not. Overrides mod_full_brace_if.
1594 # If any must be braced, they are all braced.  If all can be unbraced, then the braces are removed.
1595 mod_full_brace_if_chain                  = true     # false/true #force
1596
1597 # Don't remove braces around statements that span N newlines
1598 mod_full_brace_nl                        = 2        # number #force
1599
1600 # Add or remove braces on single-line 'while' statement
1601 mod_full_brace_while                     = remove   # ignore/add/remove/force
1602
1603 # Add or remove braces on single-line 'using ()' statement
1604 # WARNING: Code doesn't seem to use this feature - delete from the config?
1605 mod_full_brace_using                     = ignore   # ignore/add/remove/force
1606
1607 # Add or remove unnecessary paren on 'return' statement
1608 # NOTE: is 42 worse than ignore
1609 mod_paren_on_return                      = remove   # ignore/add/remove/force
1610
1611 # Whether to change optional semicolons to real semicolons
1612 # WARNING: Code doesn't seem to use this feature - delete from the config?
1613 mod_pawn_semicolon                       = false    # false/true
1614
1615 # Add parens on 'while' and 'if' statement around bools
1616 mod_full_paren_if_bool                   = false    # false/true
1617
1618 # Whether to remove superfluous semicolons
1619 mod_remove_extra_semicolon               = false    # false/true
1620
1621 # If a function body exceeds the specified number of newlines and doesn't have a comment after
1622 # the close brace, a comment will be added.
1623 mod_add_long_function_closebrace_comment = 0        # number
1624
1625 # If a switch body exceeds the specified number of newlines and doesn't have a comment after
1626 # the close brace, a comment will be added.
1627 mod_add_long_switch_closebrace_comment   = 0        # number
1628
1629 # If an #ifdef body exceeds the specified number of newlines and doesn't have a comment after
1630 # the #endif, a comment will be added.
1631 mod_add_long_ifdef_endif_comment         = 0        # number
1632
1633 # If an #ifdef or #else body exceeds the specified number of newlines and doesn't have a comment after
1634 # the #else, a comment will be added.
1635 mod_add_long_ifdef_else_comment          = 0        # number
1636
1637 # If TRUE, will sort consecutive single-line 'import' statements [Java, D]
1638 # WARNING: Code doesn't seem to use this feature - delete from the config?
1639 mod_sort_import                          = false    # false/true
1640
1641 # If TRUE, will sort consecutive single-line 'using' statements [C#]
1642 # WARNING: Code doesn't seem to use this feature - delete from the config?
1643 mod_sort_using                           = false    # false/true
1644
1645 # If TRUE, will sort consecutive single-line '#include' statements [C/C++] and '#import' statements [Obj-C]
1646 # This is generally a bad idea, as it may break your code.
1647 mod_sort_include                         = false    # false/true
1648
1649 # If TRUE, it will move a 'break' that appears after a fully braced 'case' before the close brace.
1650 # WARNING: Code doesn't seem to use this feature - delete from the config?
1651 mod_move_case_break                      = false    # false/true
1652
1653 # Will add or remove the braces around a fully braced case statement.
1654 # Will only remove the braces if there are no variable declarations in the block.
1655 # NOTE: is 581 worse than ignore
1656 mod_case_brace                           = remove   # ignore/add/remove/force
1657
1658 # If TRUE, it will remove a void 'return;' that appears as the last statement in a function.
1659 mod_remove_empty_return                  = true     # false/true #force
1660
1661 #
1662 # Comment modifications
1663 #
1664
1665 # Try to wrap comments at cmt_width columns
1666 cmt_width                                = 0        # number
1667
1668 # Set the comment reflow mode (default: 0)
1669 # 0: no reflowing (apart from the line wrapping due to cmt_width)
1670 # 1: no touching at all
1671 # 2: full reflow
1672 # WARNING: Code doesn't seem to use this feature - delete from the config?
1673 cmt_reflow_mode                          = 0        # number
1674
1675 # If false, disable all multi-line comment changes, including cmt_width. keyword substitution, and leading chars.
1676 # Default is true.
1677 cmt_indent_multi                         = false    # false/true
1678
1679 # Whether to group c-comments that look like they are in a block
1680 cmt_c_group                              = false    # false/true
1681
1682 # Whether to put an empty '/*' on the first line of the combined c-comment
1683 # WARNING: Code doesn't seem to use this feature - delete from the config?
1684 cmt_c_nl_start                           = false    # false/true
1685
1686 # Whether to put a newline before the closing '*/' of the combined c-comment
1687 # WARNING: Code doesn't seem to use this feature - delete from the config?
1688 cmt_c_nl_end                             = false    # false/true
1689
1690 # Whether to group cpp-comments that look like they are in a block
1691 # WARNING: Code doesn't seem to use this feature - delete from the config?
1692 cmt_cpp_group                            = false    # false/true
1693
1694 # Whether to put an empty '/*' on the first line of the combined cpp-comment
1695 # WARNING: Code doesn't seem to use this feature - delete from the config?
1696 cmt_cpp_nl_start                         = false    # false/true
1697
1698 # Whether to put a newline before the closing '*/' of the combined cpp-comment
1699 # WARNING: Code doesn't seem to use this feature - delete from the config?
1700 cmt_cpp_nl_end                           = false    # false/true
1701
1702 # Whether to change cpp-comments into c-comments
1703 cmt_cpp_to_c                             = false    # false/true
1704
1705 # Whether to put a star on subsequent comment lines
1706 # WARNING: Code doesn't seem to use this feature - delete from the config?
1707 cmt_star_cont                            = false    # false/true
1708
1709 # The number of spaces to insert at the start of subsequent comment lines
1710 # WARNING: Code doesn't seem to use this feature - delete from the config?
1711 cmt_sp_before_star_cont                  = 0        # number
1712
1713 # The number of spaces to insert after the star on subsequent comment lines
1714 # WARNING: Code doesn't seem to use this feature - delete from the config?
1715 cmt_sp_after_star_cont                   = 0        # number
1716
1717 # For multi-line comments with a '*' lead, remove leading spaces if the first and last lines of
1718 # the comment are the same length. Default=True
1719 # WARNING: Code doesn't seem to use this feature - delete from the config?
1720 cmt_multi_check_last                     = false    # false/true
1721
1722 # The filename that contains text to insert at the head of a file if the file doesn't start with a C/C++ comment.
1723 # Will substitute $(filename) with the current file's name.
1724 # WARNING: unsupported string
1725 cmt_insert_file_header                   = ""         # string
1726
1727 # The filename that contains text to insert at the end of a file if the file doesn't end with a C/C++ comment.
1728 # Will substitute $(filename) with the current file's name.
1729 # WARNING: unsupported string
1730 cmt_insert_file_footer                   = ""         # string
1731
1732 # The filename that contains text to insert before a function implementation if the function isn't preceded with a C/C++ comment.
1733 # Will substitute $(function) with the function name and $(javaparam) with the javadoc @param and @return stuff.
1734 # Will also substitute $(fclass) with the class name: void CFoo::Bar() { ... }
1735 # WARNING: unsupported string
1736 cmt_insert_func_header                   = ""         # string
1737
1738 # The filename that contains text to insert before a class if the class isn't preceded with a C/C++ comment.
1739 # Will substitute $(class) with the class name.
1740 # WARNING: unsupported string
1741 cmt_insert_class_header                  = ""         # string
1742
1743 # The filename that contains text to insert before a Obj-C message specification if the method isn't preceeded with a C/C++ comment.
1744 # Will substitute $(message) with the function name and $(javaparam) with the javadoc @param and @return stuff.
1745 cmt_insert_oc_msg_header                 = ""         # string #ignore
1746
1747 # If a preprocessor is encountered when stepping backwards from a function name, then
1748 # this option decides whether the comment should be inserted.
1749 # Affects cmt_insert_oc_msg_header, cmt_insert_func_header and cmt_insert_class_header. #ignore
1750 # WARNING: Code doesn't seem to use this feature - delete from the config?
1751 cmt_insert_before_preproc                = false    # false/true
1752
1753 #
1754 # Preprocessor options
1755 #
1756
1757 # Control indent of preprocessors inside #if blocks at brace level 0
1758 # WARNING: Indifferent... please decide manually.
1759 pp_indent                                = ignore   # ignore/add/remove/force
1760
1761 # Whether to indent #if/#else/#endif at the brace level (true) or from column 1 (false)
1762 pp_indent_at_level                       = false    # false/true
1763
1764 # If pp_indent_at_level=false, specifies the number of columns to indent per level. Default=1.
1765 # WARNING: Code doesn't seem to use this feature - delete from the config?
1766 pp_indent_count                          = 0        # number
1767
1768 # Add or remove space after # based on pp_level of #if blocks
1769 # NOTE: is 28 worse than ignore
1770 pp_space                                 = remove   # ignore/add/remove/force
1771
1772 # Sets the number of spaces added with pp_space
1773 # WARNING: Code doesn't seem to use this feature - delete from the config?
1774 pp_space_count                           = 0        # number
1775
1776 # The indent for #region and #endregion in C# and '#pragma region' in C/C++
1777 # WARNING: Code doesn't seem to use this feature - delete from the config?
1778 pp_indent_region                         = 0        # number
1779
1780 # Whether to indent the code between #region and #endregion
1781 # WARNING: Code doesn't seem to use this feature - delete from the config?
1782 pp_region_indent_code                    = false    # false/true
1783
1784 # If pp_indent_at_level=true, sets the indent for #if, #else, and #endif when not at file-level
1785 # WARNING: Code doesn't seem to use this feature - delete from the config?
1786 pp_indent_if                             = 0        # number
1787
1788 # Control whether to indent the code between #if, #else and #endif when not at file-level
1789 pp_if_indent_code                        = false    # false/true
1790
1791 # Whether to indent '#define' at the brace level (true) or from column 1 (false)
1792 pp_define_at_level                       = true     # false/true
1793
1794 # You can force a token to be a type with the 'type' option.
1795 # Example:
1796 # type myfoo1 myfoo2
1797
1798 type void
1799 type float
1800 type vector
1801 type entity
1802 type string
1803 type .void
1804 type .float
1805 type .vector
1806 type .entity
1807 type .string
1808
1809 #
1810 # You can create custom macro-based indentation using macro-open,
1811 # macro-else and macro-close.
1812 # Example:
1813 # macro-open  BEGIN_TEMPLATE_MESSAGE_MAP
1814 # macro-open  BEGIN_MESSAGE_MAP
1815 # macro-close END_MESSAGE_MAP
1816 #
1817 # You can assign any keyword to any type with the set option.
1818 # set func_call_user _ N_
1819
1820 # menu QC OO
1821 macro-open CLASS
1822 macro-else EXTENDS
1823 macro-close ENDCLASS
1824
1825 # translations
1826 set func_call_user _
1827
1828 #
1829 # The full syntax description of all custom definition config entries
1830 # is shown below:
1831 #
1832 # define custom tokens as:
1833 # - embed whitespace in token using '' escape character, or
1834 #   put token in quotes
1835 # - these: ' " and ` are recognized as quote delimiters
1836 #
1837 # type token1 token2 token3 ...
1838 #             ^ optionally specify multiple tokens on a single line
1839 # define def_token output_token
1840 #                  ^ output_token is optional, then NULL is assumed
1841 # macro-open token
1842 # macro-close token
1843 # macro-else token
1844 # set id token1 token2 ...
1845 #               ^ optionally specify multiple tokens on a single line
1846 #     ^ id is one of the names in token_enum.h sans the CT_ prefix,
1847 #       e.g. PP_PRAGMA
1848 #
1849 # all tokens are separated by any mix of ',' commas, '=' equal signs
1850 # and whitespace (space, tab)
1851 #