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