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