Revert "sq h2"
[metze/wireshark/wip.git] / tools / ws-coding-style.cfg
1 # Ref: https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5924
2 #
3 # FF: uncrustify config file for Wireshark (based on cheese-indent.cfg and
4 # linux.cfg... taken somewhere from the Net)
5 # http://uncrustify.sourceforge.net/
6 # typical usage:
7 #
8 # uncrustify -c ../../tools/ws-coding-style.cfg --replace packet-dccp.c
9
10
11 # The number of columns to indent per level.
12 # Usually 2, 3, 4, or 8.
13 indent_columns = 4        # number, FF: 8 on linux
14
15 # How to use tabs when indenting code
16 # 0=spaces only
17 # 1=indent with tabs, align with spaces
18 # 2=indent and align with tabs
19 indent_with_tabs = 0        # number, FF: spaces only, questionable... as 
20                             # everything about this topic :-)
21
22 # Spaces to indent '{' from level
23 indent_brace = 0        # number
24
25 # Spaces to indent 'case' from 'switch'
26 # Usually 0 or indent_columns.
27 indent_switch_case = 0 #indent_columns # number
28
29 # Add or remove space around arithmetic operator '+', '-', '/', '*', etc
30 sp_arith = force   # ignore/add/remove/force
31
32 # Add or remove space around assignment operator '=', '+=', etc
33 sp_assign = force   # ignore/add/remove/force
34
35 # Add or remove space around assignment '=' in enum
36 sp_enum_assign = force   # ignore/add/remove/force
37
38 # Add or remove space around boolean operators '&&' and '||'
39 sp_bool = force   # ignore/add/remove/force
40
41 # Add or remove space around compare operator '<', '>', '==', etc
42 sp_compare = force   # ignore/add/remove/force
43
44 # Add or remove space inside '(' and ')'
45 sp_inside_paren = remove   # ignore/add/remove/force
46
47 # Add or remove space between nested parens
48 sp_paren_paren = remove   # ignore/add/remove/force
49
50 # Add or remove space before pointer star '*'
51 sp_before_ptr_star = force   # ignore/add/remove/force
52
53 # Add or remove space between pointer stars '*'
54 sp_between_ptr_star = remove   # ignore/add/remove/force
55
56 # Add or remove space after pointer star '*', if followed by a word.
57 sp_after_ptr_star = remove   # ignore/add/remove/force
58
59 # Add or remove space before reference sign '&'
60 sp_before_byref = force   # ignore/add/remove/force
61
62 # Add or remove space after reference sign '&', if followed by a word.
63 sp_after_byref = remove   # ignore/add/remove/force
64
65 # Add or remove space between type and word
66 sp_after_type = force    # ignore/add/remove/force
67
68 # Add or remove space before '(' of 'if', 'for', 'switch', and 'while'
69 sp_before_sparen = force   # ignore/add/remove/force
70
71 # Add or remove space inside if-condition '(' and ')'
72 sp_inside_sparen = remove   # ignore/add/remove/force
73
74 # Add or remove space after ')' of 'if', 'for', 'switch', and 'while'
75 sp_after_sparen = force   # ignore/add/remove/force
76
77 # Add or remove space between ')' and '{' of 'if', 'for', 'switch', and 'while'
78 sp_sparen_brace = force   # ignore/add/remove/force
79
80 # Add or remove space before empty statement ';' on 'if', 'for' and 'while'
81 sp_special_semi = remove   # ignore/add/remove/force
82
83 # Add or remove space before ';'
84 sp_before_semi = remove   # ignore/add/remove/force
85
86 # Add or remove space before ';' in non-empty 'for' statements
87 sp_before_semi_for = remove   # ignore/add/remove/force
88
89 # Add or remove space inside '[' and ']'
90 sp_inside_square = remove   # ignore/add/remove/force
91
92 # Add or remove space before '[' (except '[]')
93 sp_before_square = remove   # ignore/add/remove/force
94
95 # Add or remove space before '[]'
96 sp_before_squares = remove   # ignore/add/remove/force
97
98 # Add or remove space after ','
99 sp_after_comma = force   # ignore/add/remove/force
100
101 # Add or remove space before ','
102 sp_before_comma = remove   # ignore/add/remove/force
103
104 # Add or remove space after C/D cast, ie 'cast(int)a' vs 'cast(int) a' or '(int)a' vs '(int) a'
105 sp_after_cast = force   # ignore/add/remove/force
106
107 # Add or remove spaces inside cast parens
108 sp_inside_paren_cast = remove   # ignore/add/remove/force
109
110 # Add or remove space between 'sizeof' and '('
111 sp_sizeof_paren = force   # ignore/add/remove/force
112
113 # Add or remove space inside '{' and '}'
114 sp_inside_braces = remove   # ignore/add/remove/force
115
116 # Add or remove space inside '{}'
117 sp_inside_braces_empty = remove   # ignore/add/remove/force
118
119 # Add or remove space inside enum '{' and '}'
120 sp_inside_braces_enum = remove   # ignore/add/remove/force
121
122 # Add or remove space inside struct/union '{' and '}'
123 sp_inside_braces_struct = remove   # ignore/add/remove/force
124
125 # Add or remove space between function name and '(' on function declaration
126 sp_func_proto_paren = remove   # ignore/add/remove/force, FF was force
127
128 # Add or remove space between function name and '(' on function definition
129 sp_func_def_paren = remove   # ignore/add/remove/force, FF was force
130
131 # Add or remove space inside empty function '()'
132 sp_inside_fparens = remove   # ignore/add/remove/force
133
134 # Add or remove space inside function '(' and ')'
135 sp_inside_fparen = remove   # ignore/add/remove/force
136
137 # Add or remove space between function name and '(' on function calls
138 sp_func_call_paren = remove   # ignore/add/remove/force, FF: was 'force'
139 sp_func_call_user_paren = remove   # ignore/add/remove/force
140 set func_call_user _ N_
141
142 # Add or remove space between 'return' and '('
143 sp_return_paren = force   # ignore/add/remove/force
144
145 # Add or remove space between 'defined' and '(' in '#if defined (FOO)'
146 sp_defined_paren = force   # ignore/add/remove/force
147
148 # Add or remove space between macro and value
149 sp_macro = force   # ignore/add/remove/force
150
151 # Add or remove space between macro function ')' and value
152 sp_macro_func = force   # ignore/add/remove/force
153
154 # Add or remove space around the ':' in 'b ? t : f'
155 sp_cond_colon = force   # ignore/add/remove/force
156
157 # Add or remove space around the '?' in 'b ? t : f'
158 sp_cond_question = force   # ignore/add/remove/force
159
160 # Add or remove space before a semicolon of an empty part of a for statment.
161 sp_before_semi_for_empty = force    # ignore/add/remove/force
162
163 # How to align the star in variable definitions.
164 #  0=Part of the type
165 #  1=Part of the variable
166 #  2=Dangling
167 align_var_def_star_style = 2        # number (FF: see align_typedef_star_style)
168
169 # How to align the '&' in variable definitions.
170 #  0=Part of the type
171 #  1=Part of the variable
172 #  2=Dangling
173 align_var_def_amp_style = 2        # number
174
175 # Align variable definitions in prototypes and functions
176 align_func_params = true     # false/true
177
178 # Whether to align the colon in struct bit fields
179 align_var_def_colon = true     # false/true
180
181 # Whether to align inline struct/enum/union variable definitions
182 align_var_def_inline = true     # false/true
183
184 # The span for aligning function prototypes (0=don't align)
185 align_func_proto_span = 1        # number
186
187 # The span for aligning on '#define' bodies (0=don't align)
188 align_pp_define_span = 0        # number
189
190 # Controls the positioning of the '*' in typedefs. Just try it.
191 # 0: Align on typdef type, ignore '*'
192 # 1: The '*' is part of type name: typedef int  *pint;
193 # 2: The '*' is part of the type, but dangling: typedef int *pint;
194 align_typedef_star_style = 2        # number
195
196 # Controls the positioning of the '&' in typedefs. Just try it.
197 # 0: Align on typdef type, ignore '&'
198 # 1: The '&' is part of type name: typedef int  &pint;
199 # 2: The '&' is part of the type, but dangling: typedef int &pint;
200 align_typedef_amp_style = 2        # number
201
202 # Whether to align macros wrapped with a backslash and a newline.
203 # This will not work right if the macro contains a multi-line comment.
204 align_nl_cont = true    # false/true
205
206 # The span for aligning struct/union (0=don't align)
207 align_var_struct_span                    = 1        # number
208
209 # The threshold for aligning struct/union member definitions (0=no limit)
210 align_var_struct_thresh                  = 1        # number
211
212 # The gap for aligning struct/union member definitions
213 align_var_struct_gap                     = 1        # number
214
215 # The span for aligning struct initializer values (0=don't align)
216 align_struct_init_span                   = 1        # number
217
218 # The gap for aligning variable definitions
219 align_var_def_gap                        = 1        # number
220
221 # The span for aligning on '=' in assignments (0=don't align)
222 align_assign_span                        = 0        # number
223
224 # The span for aligning on '=' in enums (0=don't align)
225 align_enum_equ_span                      = 0        # number
226
227 # The span for aligning variable definitions (0=don't align)
228 align_var_def_span                       = 0        # number
229
230 # Add or remove newline at the end of the file
231 nl_end_of_file = force   # ignore/add/remove/force
232
233 # The number of newlines at the end of the file (only used if nl_end_of_file is 'add' or 'force')
234 nl_end_of_file_min = 1        # number
235
236 # Add or remove newline between '=' and '{'
237 nl_assign_brace = remove   # ignore/add/remove/force
238
239 # Add or remove newline between 'enum' and '{'
240 nl_enum_brace = force   # ignore/add/remove/force
241
242 # Add or remove newline between 'struct and '{'
243 nl_struct_brace = force   # ignore/add/remove/force
244
245 # Add or remove newline between 'union' and '{'
246 nl_union_brace = force   # ignore/add/remove/force
247
248 # Add or remove newline between 'if' and '{'
249 nl_if_brace = remove   # ignore/add/remove/force, FF: was 'force'
250
251 # Add or remove newline between '}' and 'else'
252 nl_brace_else = remove   # ignore/add/remove/force, FF: was 'force'
253
254 # Add or remove newline between a function call's ')' and '{', as in:
255 # list_for_each(item, &list) { }
256 nl_fcall_brace = force   # ignore/add/remove/force
257
258 # Add or remove newline between 'else if' and '{'
259 # If set to ignore, nl_if_brace is used instead
260 nl_elseif_brace = remove   # ignore/add/remove/force, FF: was 'force'
261
262 # Add or remove newline between 'else' and '{'
263 nl_else_brace = remove   # ignore/add/remove/force, FF: was 'force'
264
265 # Add or remove newline between 'else' and 'if'
266 nl_else_if = remove   # ignore/add/remove/force
267
268 # Add or remove newline between 'for' and '{'
269 nl_for_brace = force   # ignore/add/remove/force
270
271 # Add or remove newline between 'while' and '{'
272 nl_while_brace = remove   # ignore/add/remove/force, FF: was 'force'
273
274 # Add or remove newline between 'do' and '{'
275 nl_do_brace = force   # ignore/add/remove/force
276
277 # Add or remove newline between '}' and 'while' of 'do' statement
278 nl_brace_while = force   # ignore/add/remove/force
279
280 # Add or remove newline between 'switch' and '{'
281 nl_switch_brace = remove   # ignore/add/remove/force
282
283 # Add or remove newline between return type and function name in definition
284 nl_func_type_name = force   # ignore/add/remove/force
285
286 # Add or remove newline between return type and function name in a prototype
287 nl_func_proto_type_name = remove   # ignore/add/remove/force
288
289 # Add or remove newline between a function name and the opening '('
290 nl_func_paren = remove   # ignore/add/remove/force
291
292 # Add or remove newline after '(' in a function declaration
293 nl_func_decl_start = remove   # ignore/add/remove/force
294
295 # Add or remove newline after each ',' in a function declaration
296 nl_func_decl_args = ignore   # ignore/add/remove/force
297
298 # Add or remove newline before the ')' in a function declaration
299 nl_func_decl_end = remove   # ignore/add/remove/force
300
301 # Add or remove newline between function signature and '{'
302 nl_fdef_brace = force   # ignore/add/remove/force
303
304 # The number of newlines after '}' of a multi-line function body
305 nl_after_func_body = 2        # number
306
307 # The number of newlines after '}' of a single line function body
308 nl_after_func_body_one_liner = 2        # number
309
310 # The number of newlines after a block of variable definitions
311 nl_func_var_def_blk = 1        # number
312
313 # The minimum number of newlines before a multi-line comment.
314 # Doesn't apply if after a brace open or another multi-line comment.
315 nl_before_block_comment = 2        # number
316
317 # The minimum number of newlines before a single-line C comment.
318 # Doesn't apply if after a brace open or other single-line C comments.
319 nl_before_c_comment = 2        # number
320
321 # The minimum number of newlines before a CPP comment.
322 # Doesn't apply if after a brace open or other CPP comments.
323 nl_before_cpp_comment = 2        # number
324
325 # Don't touch one-line braced assignments - 'foo_t f = { 1, 2 };'
326 nl_assign_leave_one_liners = true     # false/true
327
328 # Whether to not put blanks after '#ifxx', '#elxx', or before '#endif'
329 nl_squeeze_ifdef = true    # false/true
330
331 # Whether to remove blank lines after '{'
332 eat_blanks_after_open_brace = true    # false/true
333
334 # Whether to remove blank lines before '}'
335 eat_blanks_before_close_brace = true    # false/true
336
337 # Whether to put a star on subsequent comment lines
338 cmt_star_cont = true    # false/true
339
340 # Whether to group c-comments that look like they are in a block
341 cmt_c_group = true    # false/true
342
343 # Whether to group cpp-comments that look like they are in a block
344 cmt_cpp_group = false    # false/true
345
346 # Whether to change cpp-comments into c-comments
347 cmt_cpp_to_c = false    # false/true
348
349 # If pp_indent_at_level=false, specifies the number of columns to indent per
350 # level. Default=1.
351 pp_indent_count = indent_columns        # number
352
353 # Add or remove indent of preprocessor directives
354 pp_indent = remove    # ignore/add/remove/force FF: was 'force'
355
356 # Try to limit code width to N number of columns
357 code_width = 80        # number
358
359 # Whether to fully split long function protos/calls at commas
360 ls_func_split_full = false    # false/true, FF: was 'true'
361