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