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