Advertisement
Guest User

Untitled

a guest
Feb 21st, 2019
77
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 107.98 KB | None | 0 0
  1. # Uncrustify-0.68_f
  2.  
  3. #
  4. # General options
  5. #
  6.  
  7. # The type of line endings.
  8. #
  9. # Default: auto
  10. newlines = lf # lf/crlf/cr/auto
  11.  
  12. # The original size of tabs in the input.
  13. #
  14. # Default: 8
  15. input_tab_size = 8 # unsigned number
  16.  
  17. # The size of tabs in the output (only used if align_with_tabs=true).
  18. #
  19. # Default: 8
  20. output_tab_size = 4 # unsigned number
  21.  
  22. # The ASCII value of the string escape char, usually 92 (\) or (Pawn) 94 (^).
  23. #
  24. # Default: 92
  25. string_escape_char = 92 # unsigned number
  26.  
  27. # Alternate string escape char (usually only used for Pawn).
  28. # Only works right before the quote char.
  29. string_escape_char2 = 0 # unsigned number
  30.  
  31. # Replace tab characters found in string literals with the escape sequence \t
  32. # instead.
  33. string_replace_tab_chars = false # true/false
  34.  
  35. # Allow interpreting '>=' and '>>=' as part of a template in code like
  36. # 'void f(list<list<B>>=val);'. If true, 'assert(x<0 && y>=3)' will be broken.
  37. # Improvements to template detection may make this option obsolete.
  38. tok_split_gte = false # true/false
  39.  
  40. # Specify the marker used in comments to disable processing of part of the
  41. # file.
  42. #
  43. # Default: *INDENT-OFF*
  44. disable_processing_cmt = " *INDENT-OFF*" # string
  45.  
  46. # Specify the marker used in comments to (re)enable processing in a file.
  47. #
  48. # Default: *INDENT-ON*
  49. enable_processing_cmt = " *INDENT-ON*" # string
  50.  
  51. # Enable parsing of digraphs.
  52. enable_digraphs = false # true/false
  53.  
  54. # Add or remove the UTF-8 BOM (recommend 'remove').
  55. utf8_bom = ignore # ignore/add/remove/force
  56.  
  57. # If the file contains bytes with values between 128 and 255, but is not
  58. # UTF-8, then output as UTF-8.
  59. utf8_byte = true # true/false
  60.  
  61. # Force the output encoding to UTF-8.
  62. utf8_force = false # true/false
  63.  
  64. #
  65. # Spacing options
  66. #
  67.  
  68. # Add or remove space around non-assignment symbolic operators ('+', '/', '%',
  69. # '<<', and so forth).
  70. sp_arith = add # ignore/add/remove/force
  71.  
  72. # Add or remove space around arithmetic operators '+' and '-'.
  73. #
  74. # Overrides sp_arith.
  75. sp_arith_additive = ignore # ignore/add/remove/force
  76.  
  77. # Add or remove space around assignment operator '=', '+=', etc.
  78. sp_assign = ignore # ignore/add/remove/force
  79.  
  80. # Add or remove space around '=' in C++11 lambda capture specifications.
  81. #
  82. # Overrides sp_assign.
  83. sp_cpp_lambda_assign = ignore # ignore/add/remove/force
  84.  
  85. # Add or remove space after the capture specification in C++11 lambda.
  86. sp_cpp_lambda_paren = ignore # ignore/add/remove/force
  87.  
  88. # Add or remove space around assignment operator '=' in a prototype.
  89. sp_assign_default = ignore # ignore/add/remove/force
  90.  
  91. # Add or remove space before assignment operator '=', '+=', etc.
  92. #
  93. # Overrides sp_assign.
  94. sp_before_assign = ignore # ignore/add/remove/force
  95.  
  96. # Add or remove space after assignment operator '=', '+=', etc.
  97. #
  98. # Overrides sp_assign.
  99. sp_after_assign = ignore # ignore/add/remove/force
  100.  
  101. # Add or remove space in 'NS_ENUM ('.
  102. sp_enum_paren = ignore # ignore/add/remove/force
  103.  
  104. # Add or remove space around assignment '=' in enum.
  105. sp_enum_assign = ignore # ignore/add/remove/force
  106.  
  107. # Add or remove space before assignment '=' in enum.
  108. #
  109. # Overrides sp_enum_assign.
  110. sp_enum_before_assign = add # ignore/add/remove/force
  111.  
  112. # Add or remove space after assignment '=' in enum.
  113. #
  114. # Overrides sp_enum_assign.
  115. sp_enum_after_assign = add # ignore/add/remove/force
  116.  
  117. # Add or remove space around assignment ':' in enum.
  118. sp_enum_colon = ignore # ignore/add/remove/force
  119.  
  120. # Add or remove space around preprocessor '##' concatenation operator.
  121. #
  122. # Default: add
  123. sp_pp_concat = add # ignore/add/remove/force
  124.  
  125. # Add or remove space after preprocessor '#' stringify operator.
  126. # Also affects the '#@' charizing operator.
  127. sp_pp_stringify = ignore # ignore/add/remove/force
  128.  
  129. # Add or remove space before preprocessor '#' stringify operator
  130. # as in '#define x(y) L#y'.
  131. sp_before_pp_stringify = ignore # ignore/add/remove/force
  132.  
  133. # Add or remove space around boolean operators '&&' and '||'.
  134. sp_bool = add # ignore/add/remove/force
  135.  
  136. # Add or remove space around compare operator '<', '>', '==', etc.
  137. sp_compare = add # ignore/add/remove/force
  138.  
  139. # Add or remove space inside '(' and ')'.
  140. sp_inside_paren = remove # ignore/add/remove/force
  141.  
  142. # Add or remove space between nested parentheses, i.e. '((' vs. ') )'.
  143. sp_paren_paren = remove # ignore/add/remove/force
  144.  
  145. # Add or remove space between back-to-back parentheses, i.e. ')(' vs. ') ('.
  146. sp_cparen_oparen = ignore # ignore/add/remove/force
  147.  
  148. # Whether to balance spaces inside nested parentheses.
  149. sp_balance_nested_parens = false # true/false
  150.  
  151. # Add or remove space between ')' and '{'.
  152. sp_paren_brace = add # ignore/add/remove/force
  153.  
  154. # Add or remove space between nested braces, i.e. '{{' vs '{ {'.
  155. sp_brace_brace = ignore # ignore/add/remove/force
  156.  
  157. # Add or remove space before pointer star '*'.
  158. sp_before_ptr_star = add # ignore/add/remove/force
  159.  
  160. # Add or remove space before pointer star '*' that isn't followed by a
  161. # variable name. If set to 'ignore', sp_before_ptr_star is used instead.
  162. sp_before_unnamed_ptr_star = add # ignore/add/remove/force
  163.  
  164. # Add or remove space between pointer stars '*'.
  165. sp_between_ptr_star = ignore # ignore/add/remove/force
  166.  
  167. # Add or remove space after pointer star '*', if followed by a word.
  168. sp_after_ptr_star = remove # ignore/add/remove/force
  169.  
  170. # Add or remove space after pointer caret '^', if followed by a word.
  171. sp_after_ptr_block_caret = ignore # ignore/add/remove/force
  172.  
  173. # Add or remove space after pointer star '*', if followed by a qualifier.
  174. sp_after_ptr_star_qualifier = add # ignore/add/remove/force
  175.  
  176. # Add or remove space after a pointer star '*', if followed by a function
  177. # prototype or function definition.
  178. sp_after_ptr_star_func = add # ignore/add/remove/force
  179.  
  180. # Add or remove space after a pointer star '*', if followed by an open
  181. # parenthesis, as in 'void* (*)().
  182. sp_ptr_star_paren = add # ignore/add/remove/force
  183.  
  184. # Add or remove space before a pointer star '*', if followed by a function
  185. # prototype or function definition.
  186. sp_before_ptr_star_func = ignore # ignore/add/remove/force
  187.  
  188. # Add or remove space before a reference sign '&'.
  189. sp_before_byref = add # ignore/add/remove/force
  190.  
  191. # Add or remove space before a reference sign '&' that isn't followed by a
  192. # variable name. If set to 'ignore', sp_before_byref is used instead.
  193. sp_before_unnamed_byref = ignore # ignore/add/remove/force
  194.  
  195. # Add or remove space after reference sign '&', if followed by a word.
  196. sp_after_byref = remove # ignore/add/remove/force
  197.  
  198. # Add or remove space after a reference sign '&', if followed by a function
  199. # prototype or function definition.
  200. sp_after_byref_func = add # ignore/add/remove/force
  201.  
  202. # Add or remove space before a reference sign '&', if followed by a function
  203. # prototype or function definition.
  204. sp_before_byref_func = ignore # ignore/add/remove/force
  205.  
  206. # Add or remove space between type and word.
  207. #
  208. # Default: force
  209. sp_after_type = force # ignore/add/remove/force
  210.  
  211. # Add or remove space between 'decltype(...)' and word.
  212. sp_after_decltype = ignore # ignore/add/remove/force
  213.  
  214. # (D) Add or remove space before the parenthesis in the D constructs
  215. # 'template Foo(' and 'class Foo('.
  216. sp_before_template_paren = ignore # ignore/add/remove/force
  217.  
  218. # Add or remove space between 'template' and '<'.
  219. # If set to ignore, sp_before_angle is used.
  220. sp_template_angle = remove # ignore/add/remove/force
  221.  
  222. # Add or remove space before '<'.
  223. sp_before_angle = ignore # ignore/add/remove/force
  224.  
  225. # Add or remove space inside '<' and '>'.
  226. sp_inside_angle = ignore # ignore/add/remove/force
  227.  
  228. # Add or remove space between '>' and ':'.
  229. sp_angle_colon = ignore # ignore/add/remove/force
  230.  
  231. # Add or remove space after '<>'.
  232. sp_after_angle = ignore # ignore/add/remove/force
  233.  
  234. # Add or remove space between '>' and '(' as found in 'new List<byte>(foo);'.
  235. sp_angle_paren = ignore # ignore/add/remove/force
  236.  
  237. # Add or remove space between '>' and '()' as found in 'new List<byte>();'.
  238. sp_angle_paren_empty = ignore # ignore/add/remove/force
  239.  
  240. # Add or remove space between '>' and a word as in 'List<byte> m;' or
  241. # 'template <typename T> static ...'.
  242. sp_angle_word = ignore # ignore/add/remove/force
  243.  
  244. # Add or remove space between '>' and '>' in '>>' (template stuff).
  245. #
  246. # Default: add
  247. sp_angle_shift = add # ignore/add/remove/force
  248.  
  249. # (C++11) Permit removal of the space between '>>' in 'foo<bar<int> >'. Note
  250. # that sp_angle_shift cannot remove the space without this option.
  251. sp_permit_cpp11_shift = false # true/false
  252.  
  253. # Add or remove space before '(' of control statements ('if', 'for', 'switch',
  254. # 'while', etc.).
  255. sp_before_sparen = add # ignore/add/remove/force
  256.  
  257. # Add or remove space inside '(' and ')' of control statements.
  258. sp_inside_sparen = remove # ignore/add/remove/force
  259.  
  260. # Add or remove space after '(' of control statements.
  261. #
  262. # Overrides sp_inside_sparen.
  263. sp_inside_sparen_open = ignore # ignore/add/remove/force
  264.  
  265. # Add or remove space before ')' of control statements.
  266. #
  267. # Overrides sp_inside_sparen.
  268. sp_inside_sparen_close = ignore # ignore/add/remove/force
  269.  
  270. # Add or remove space after ')' of control statements.
  271. sp_after_sparen = ignore # ignore/add/remove/force
  272.  
  273. # Add or remove space between ')' and '{' of of control statements.
  274. sp_sparen_brace = add # ignore/add/remove/force
  275.  
  276. # (D) Add or remove space between 'invariant' and '('.
  277. sp_invariant_paren = ignore # ignore/add/remove/force
  278.  
  279. # (D) Add or remove space after the ')' in 'invariant (C) c'.
  280. sp_after_invariant_paren = ignore # ignore/add/remove/force
  281.  
  282. # Add or remove space before empty statement ';' on 'if', 'for' and 'while'.
  283. sp_special_semi = ignore # ignore/add/remove/force
  284.  
  285. # Add or remove space before ';'.
  286. #
  287. # Default: remove
  288. sp_before_semi = remove # ignore/add/remove/force
  289.  
  290. # Add or remove space before ';' in non-empty 'for' statements.
  291. sp_before_semi_for = ignore # ignore/add/remove/force
  292.  
  293. # Add or remove space before a semicolon of an empty part of a for statement.
  294. sp_before_semi_for_empty = ignore # ignore/add/remove/force
  295.  
  296. # Add or remove space after ';', except when followed by a comment.
  297. #
  298. # Default: add
  299. sp_after_semi = add # ignore/add/remove/force
  300.  
  301. # Add or remove space after ';' in non-empty 'for' statements.
  302. #
  303. # Default: force
  304. sp_after_semi_for = force # ignore/add/remove/force
  305.  
  306. # Add or remove space after the final semicolon of an empty part of a for
  307. # statement, as in 'for ( ; ; <here> )'.
  308. sp_after_semi_for_empty = ignore # ignore/add/remove/force
  309.  
  310. # Add or remove space before '[' (except '[]').
  311. sp_before_square = remove # ignore/add/remove/force
  312.  
  313. # Add or remove space before '[]'.
  314. sp_before_squares = remove # ignore/add/remove/force
  315.  
  316. # Add or remove space before C++17 structured bindings.
  317. sp_cpp_before_struct_binding = ignore # ignore/add/remove/force
  318.  
  319. # Add or remove space inside a non-empty '[' and ']'.
  320. sp_inside_square = remove # ignore/add/remove/force
  321.  
  322. # (OC) Add or remove space inside a non-empty Objective-C boxed array '@[' and
  323. # ']'. If set to ignore, sp_inside_square is used.
  324. sp_inside_square_oc_array = remove # ignore/add/remove/force
  325.  
  326. # Add or remove space after ',', i.e. 'a,b' vs. 'a, b'.
  327. sp_after_comma = add # ignore/add/remove/force
  328.  
  329. # Add or remove space before ','.
  330. #
  331. # Default: remove
  332. sp_before_comma = remove # ignore/add/remove/force
  333.  
  334. # (C#) Add or remove space between ',' and ']' in multidimensional array type
  335. # like 'int[,,]'.
  336. sp_after_mdatype_commas = remove # ignore/add/remove/force
  337.  
  338. # (C#) Add or remove space between '[' and ',' in multidimensional array type
  339. # like 'int[,,]'.
  340. sp_before_mdatype_commas = remove # ignore/add/remove/force
  341.  
  342. # (C#) Add or remove space between ',' in multidimensional array type
  343. # like 'int[,,]'.
  344. sp_between_mdatype_commas = ignore # ignore/add/remove/force
  345.  
  346. # Add or remove space between an open parenthesis and comma,
  347. # i.e. '(,' vs. '( ,'.
  348. #
  349. # Default: force
  350. sp_paren_comma = force # ignore/add/remove/force
  351.  
  352. # Add or remove space before the variadic '...' when preceded by a
  353. # non-punctuator.
  354. sp_before_ellipsis = ignore # ignore/add/remove/force
  355.  
  356. # Add or remove space between a type and '...'.
  357. sp_type_ellipsis = ignore # ignore/add/remove/force
  358.  
  359. # Add or remove space between ')' and '...'.
  360. sp_paren_ellipsis = ignore # ignore/add/remove/force
  361.  
  362. # Add or remove space after class ':'.
  363. sp_after_class_colon = ignore # ignore/add/remove/force
  364.  
  365. # Add or remove space before class ':'.
  366. sp_before_class_colon = ignore # ignore/add/remove/force
  367.  
  368. # Add or remove space after class constructor ':'.
  369. sp_after_constr_colon = ignore # ignore/add/remove/force
  370.  
  371. # Add or remove space before class constructor ':'.
  372. sp_before_constr_colon = ignore # ignore/add/remove/force
  373.  
  374. # Add or remove space before case ':'.
  375. #
  376. # Default: remove
  377. sp_before_case_colon = remove # ignore/add/remove/force
  378.  
  379. # Add or remove space between 'operator' and operator sign.
  380. sp_after_operator = remove # ignore/add/remove/force
  381.  
  382. # Add or remove space between the operator symbol and the open parenthesis, as
  383. # in 'operator ++('.
  384. sp_after_operator_sym = ignore # ignore/add/remove/force
  385.  
  386. # Overrides sp_after_operator_sym when the operator has no arguments, as in
  387. # 'operator *()'.
  388. sp_after_operator_sym_empty = ignore # ignore/add/remove/force
  389.  
  390. # Add or remove space after C/D cast, i.e. 'cast(int)a' vs. 'cast(int) a' or
  391. # '(int)a' vs. '(int) a'.
  392. sp_after_cast = remove # ignore/add/remove/force
  393.  
  394. # Add or remove spaces inside cast parentheses.
  395. sp_inside_paren_cast = remove # ignore/add/remove/force
  396.  
  397. # Add or remove space between the type and open parenthesis in a C++ cast,
  398. # i.e. 'int(exp)' vs. 'int (exp)'.
  399. sp_cpp_cast_paren = remove # ignore/add/remove/force
  400.  
  401. # Add or remove space between 'sizeof' and '('.
  402. sp_sizeof_paren = remove # ignore/add/remove/force
  403.  
  404. # Add or remove space between 'sizeof' and '...'.
  405. sp_sizeof_ellipsis = ignore # ignore/add/remove/force
  406.  
  407. # Add or remove space between 'sizeof...' and '('.
  408. sp_sizeof_ellipsis_paren = ignore # ignore/add/remove/force
  409.  
  410. # Add or remove space between 'decltype' and '('.
  411. sp_decltype_paren = ignore # ignore/add/remove/force
  412.  
  413. # (Pawn) Add or remove space after the tag keyword.
  414. sp_after_tag = ignore # ignore/add/remove/force
  415.  
  416. # Add or remove space inside enum '{' and '}'.
  417. sp_inside_braces_enum = ignore # ignore/add/remove/force
  418.  
  419. # Add or remove space inside struct/union '{' and '}'.
  420. sp_inside_braces_struct = ignore # ignore/add/remove/force
  421.  
  422. # (OC) Add or remove space inside Objective-C boxed dictionary '{' and '}'
  423. sp_inside_braces_oc_dict = ignore # ignore/add/remove/force
  424.  
  425. # Add or remove space after open brace in an unnamed temporary
  426. # direct-list-initialization.
  427. sp_after_type_brace_init_lst_open = ignore # ignore/add/remove/force
  428.  
  429. # Add or remove space before close brace in an unnamed temporary
  430. # direct-list-initialization.
  431. sp_before_type_brace_init_lst_close = ignore # ignore/add/remove/force
  432.  
  433. # Add or remove space inside an unnamed temporary direct-list-initialization.
  434. sp_inside_type_brace_init_lst = ignore # ignore/add/remove/force
  435.  
  436. # Add or remove space inside '{' and '}'.
  437. sp_inside_braces = ignore # ignore/add/remove/force
  438.  
  439. # Add or remove space inside '{}'.
  440. sp_inside_braces_empty = ignore # ignore/add/remove/force
  441.  
  442. # Add or remove space between return type and function name. A minimum of 1
  443. # is forced except for pointer return types.
  444. sp_type_func = ignore # ignore/add/remove/force
  445.  
  446. # Add or remove space between type and open brace of an unnamed temporary
  447. # direct-list-initialization.
  448. sp_type_brace_init_lst = ignore # ignore/add/remove/force
  449.  
  450. # Add or remove space between function name and '(' on function declaration.
  451. sp_func_proto_paren = ignore # ignore/add/remove/force
  452.  
  453. # Add or remove space between function name and '()' on function declaration
  454. # without parameters.
  455. sp_func_proto_paren_empty = ignore # ignore/add/remove/force
  456.  
  457. # Add or remove space between function name and '(' on function definition.
  458. sp_func_def_paren = ignore # ignore/add/remove/force
  459.  
  460. # Add or remove space between function name and '()' on function definition
  461. # without parameters.
  462. sp_func_def_paren_empty = ignore # ignore/add/remove/force
  463.  
  464. # Add or remove space inside empty function '()'.
  465. sp_inside_fparens = ignore # ignore/add/remove/force
  466.  
  467. # Add or remove space inside function '(' and ')'.
  468. sp_inside_fparen = ignore # ignore/add/remove/force
  469.  
  470. # Add or remove space inside the first parentheses in a function type, as in
  471. # 'void (*x)(...)'.
  472. sp_inside_tparen = ignore # ignore/add/remove/force
  473.  
  474. # Add or remove space between the ')' and '(' in a function type, as in
  475. # 'void (*x)(...)'.
  476. sp_after_tparen_close = ignore # ignore/add/remove/force
  477.  
  478. # Add or remove space between ']' and '(' when part of a function call.
  479. sp_square_fparen = ignore # ignore/add/remove/force
  480.  
  481. # Add or remove space between ')' and '{' of function.
  482. sp_fparen_brace = ignore # ignore/add/remove/force
  483.  
  484. # Add or remove space between ')' and '{' of s function call in object
  485. # initialization.
  486. #
  487. # Overrides sp_fparen_brace.
  488. sp_fparen_brace_initializer = ignore # ignore/add/remove/force
  489.  
  490. # (Java) Add or remove space between ')' and '{{' of double brace initializer.
  491. sp_fparen_dbrace = ignore # ignore/add/remove/force
  492.  
  493. # Add or remove space between function name and '(' on function calls.
  494. sp_func_call_paren = ignore # ignore/add/remove/force
  495.  
  496. # Add or remove space between function name and '()' on function calls without
  497. # parameters. If set to 'ignore' (the default), sp_func_call_paren is used.
  498. sp_func_call_paren_empty = ignore # ignore/add/remove/force
  499.  
  500. # Add or remove space between the user function name and '(' on function
  501. # calls. You need to set a keyword to be a user function in the config file,
  502. # like:
  503. # set func_call_user tr _ i18n
  504. sp_func_call_user_paren = ignore # ignore/add/remove/force
  505.  
  506. # Add or remove space inside user function '(' and ')'.
  507. sp_func_call_user_inside_fparen = ignore # ignore/add/remove/force
  508.  
  509. # Add or remove space between nested parentheses with user functions,
  510. # i.e. '((' vs. '( ('.
  511. sp_func_call_user_paren_paren = ignore # ignore/add/remove/force
  512.  
  513. # Add or remove space between a constructor/destructor and the open
  514. # parenthesis.
  515. sp_func_class_paren = ignore # ignore/add/remove/force
  516.  
  517. # Add or remove space between a constructor without parameters or destructor
  518. # and '()'.
  519. sp_func_class_paren_empty = ignore # ignore/add/remove/force
  520.  
  521. # Add or remove space between 'return' and '('.
  522. sp_return_paren = add # ignore/add/remove/force
  523.  
  524. # Add or remove space between 'return' and '{'.
  525. sp_return_brace = add # ignore/add/remove/force
  526.  
  527. # Add or remove space between '__attribute__' and '('.
  528. sp_attribute_paren = ignore # ignore/add/remove/force
  529.  
  530. # Add or remove space between 'defined' and '(' in '#if defined (FOO)'.
  531. sp_defined_paren = ignore # ignore/add/remove/force
  532.  
  533. # Add or remove space between 'throw' and '(' in 'throw (something)'.
  534. sp_throw_paren = ignore # ignore/add/remove/force
  535.  
  536. # Add or remove space between 'throw' and anything other than '(' as in
  537. # '@throw [...];'.
  538. sp_after_throw = ignore # ignore/add/remove/force
  539.  
  540. # Add or remove space between 'catch' and '(' in 'catch (something) { }'.
  541. # If set to ignore, sp_before_sparen is used.
  542. sp_catch_paren = ignore # ignore/add/remove/force
  543.  
  544. # (OC) Add or remove space between '@catch' and '('
  545. # in '@catch (something) { }'. If set to ignore, sp_catch_paren is used.
  546. sp_oc_catch_paren = ignore # ignore/add/remove/force
  547.  
  548. # (D) Add or remove space between 'version' and '('
  549. # in 'version (something) { }'. If set to ignore, sp_before_sparen is used.
  550. sp_version_paren = ignore # ignore/add/remove/force
  551.  
  552. # (D) Add or remove space between 'scope' and '('
  553. # in 'scope (something) { }'. If set to ignore, sp_before_sparen is used.
  554. sp_scope_paren = ignore # ignore/add/remove/force
  555.  
  556. # Add or remove space between 'super' and '(' in 'super (something)'.
  557. #
  558. # Default: remove
  559. sp_super_paren = remove # ignore/add/remove/force
  560.  
  561. # Add or remove space between 'this' and '(' in 'this (something)'.
  562. #
  563. # Default: remove
  564. sp_this_paren = remove # ignore/add/remove/force
  565.  
  566. # Add or remove space between a macro name and its definition.
  567. sp_macro = ignore # ignore/add/remove/force
  568.  
  569. # Add or remove space between a macro function ')' and its definition.
  570. sp_macro_func = ignore # ignore/add/remove/force
  571.  
  572. # Add or remove space between 'else' and '{' if on the same line.
  573. sp_else_brace = add # ignore/add/remove/force
  574.  
  575. # Add or remove space between '}' and 'else' if on the same line.
  576. sp_brace_else = add # ignore/add/remove/force
  577.  
  578. # Add or remove space between '}' and the name of a typedef on the same line.
  579. sp_brace_typedef = ignore # ignore/add/remove/force
  580.  
  581. # Add or remove space before the '{' of a 'catch' statement, if the '{' and
  582. # 'catch' are on the same line, as in 'catch (decl) <here> {'.
  583. sp_catch_brace = add # ignore/add/remove/force
  584.  
  585. # (OC) Add or remove space before the '{' of a '@catch' statement, if the '{'
  586. # and '@catch' are on the same line, as in '@catch (decl) <here> {'.
  587. # If set to ignore, sp_catch_brace is used.
  588. sp_oc_catch_brace = add # ignore/add/remove/force
  589.  
  590. # Add or remove space between '}' and 'catch' if on the same line.
  591. sp_brace_catch = add # ignore/add/remove/force
  592.  
  593. # (OC) Add or remove space between '}' and '@catch' if on the same line.
  594. # If set to ignore, sp_brace_catch is used.
  595. sp_oc_brace_catch = add # ignore/add/remove/force
  596.  
  597. # Add or remove space between 'finally' and '{' if on the same line.
  598. sp_finally_brace = add # ignore/add/remove/force
  599.  
  600. # Add or remove space between '}' and 'finally' if on the same line.
  601. sp_brace_finally = add # ignore/add/remove/force
  602.  
  603. # Add or remove space between 'try' and '{' if on the same line.
  604. sp_try_brace = add # ignore/add/remove/force
  605.  
  606. # Add or remove space between get/set and '{' if on the same line.
  607. sp_getset_brace = add # ignore/add/remove/force
  608.  
  609. # Add or remove space between a variable and '{' for C++ uniform
  610. # initialization.
  611. #
  612. # Default: add
  613. sp_word_brace = add # ignore/add/remove/force
  614.  
  615. # Add or remove space between a variable and '{' for a namespace.
  616. #
  617. # Default: add
  618. sp_word_brace_ns = add # ignore/add/remove/force
  619.  
  620. # Add or remove space before the '::' operator.
  621. sp_before_dc = ignore # ignore/add/remove/force
  622.  
  623. # Add or remove space after the '::' operator.
  624. sp_after_dc = ignore # ignore/add/remove/force
  625.  
  626. # (D) Add or remove around the D named array initializer ':' operator.
  627. sp_d_array_colon = ignore # ignore/add/remove/force
  628.  
  629. # Add or remove space after the '!' (not) unary operator.
  630. #
  631. # Default: remove
  632. sp_not = remove # ignore/add/remove/force
  633.  
  634. # Add or remove space after the '~' (invert) unary operator.
  635. #
  636. # Default: remove
  637. sp_inv = remove # ignore/add/remove/force
  638.  
  639. # Add or remove space after the '&' (address-of) unary operator. This does not
  640. # affect the spacing after a '&' that is part of a type.
  641. #
  642. # Default: remove
  643. sp_addr = remove # ignore/add/remove/force
  644.  
  645. # Add or remove space around the '.' or '->' operators.
  646. #
  647. # Default: remove
  648. sp_member = remove # ignore/add/remove/force
  649.  
  650. # Add or remove space after the '*' (dereference) unary operator. This does
  651. # not affect the spacing after a '*' that is part of a type.
  652. #
  653. # Default: remove
  654. sp_deref = remove # ignore/add/remove/force
  655.  
  656. # Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'.
  657. #
  658. # Default: remove
  659. sp_sign = remove # ignore/add/remove/force
  660.  
  661. # Add or remove space between '++' and '--' the word to which it is being
  662. # applied, as in '(--x)' or 'y++;'.
  663. #
  664. # Default: remove
  665. sp_incdec = remove # ignore/add/remove/force
  666.  
  667. # Add or remove space before a backslash-newline at the end of a line.
  668. #
  669. # Default: add
  670. sp_before_nl_cont = add # ignore/add/remove/force
  671.  
  672. # (OC) Add or remove space after the scope '+' or '-', as in '-(void) foo;'
  673. # or '+(int) bar;'.
  674. sp_after_oc_scope = ignore # ignore/add/remove/force
  675.  
  676. # (OC) Add or remove space after the colon in message specs,
  677. # i.e. '-(int) f:(int) x;' vs. '-(int) f: (int) x;'.
  678. sp_after_oc_colon = ignore # ignore/add/remove/force
  679.  
  680. # (OC) Add or remove space before the colon in message specs,
  681. # i.e. '-(int) f: (int) x;' vs. '-(int) f : (int) x;'.
  682. sp_before_oc_colon = ignore # ignore/add/remove/force
  683.  
  684. # (OC) Add or remove space after the colon in immutable dictionary expression
  685. # 'NSDictionary *test = @{@"foo" :@"bar"};'.
  686. sp_after_oc_dict_colon = ignore # ignore/add/remove/force
  687.  
  688. # (OC) Add or remove space before the colon in immutable dictionary expression
  689. # 'NSDictionary *test = @{@"foo" :@"bar"};'.
  690. sp_before_oc_dict_colon = ignore # ignore/add/remove/force
  691.  
  692. # (OC) Add or remove space after the colon in message specs,
  693. # i.e. '[object setValue:1];' vs. '[object setValue: 1];'.
  694. sp_after_send_oc_colon = ignore # ignore/add/remove/force
  695.  
  696. # (OC) Add or remove space before the colon in message specs,
  697. # i.e. '[object setValue:1];' vs. '[object setValue :1];'.
  698. sp_before_send_oc_colon = ignore # ignore/add/remove/force
  699.  
  700. # (OC) Add or remove space after the (type) in message specs,
  701. # i.e. '-(int)f: (int) x;' vs. '-(int)f: (int)x;'.
  702. sp_after_oc_type = ignore # ignore/add/remove/force
  703.  
  704. # (OC) Add or remove space after the first (type) in message specs,
  705. # i.e. '-(int) f:(int)x;' vs. '-(int)f:(int)x;'.
  706. sp_after_oc_return_type = ignore # ignore/add/remove/force
  707.  
  708. # (OC) Add or remove space between '@selector' and '(',
  709. # i.e. '@selector(msgName)' vs. '@selector (msgName)'.
  710. # Also applies to '@protocol()' constructs.
  711. sp_after_oc_at_sel = ignore # ignore/add/remove/force
  712.  
  713. # (OC) Add or remove space between '@selector(x)' and the following word,
  714. # i.e. '@selector(foo) a:' vs. '@selector(foo)a:'.
  715. sp_after_oc_at_sel_parens = ignore # ignore/add/remove/force
  716.  
  717. # (OC) Add or remove space inside '@selector' parentheses,
  718. # i.e. '@selector(foo)' vs. '@selector( foo )'.
  719. # Also applies to '@protocol()' constructs.
  720. sp_inside_oc_at_sel_parens = ignore # ignore/add/remove/force
  721.  
  722. # (OC) Add or remove space before a block pointer caret,
  723. # i.e. '^int (int arg){...}' vs. ' ^int (int arg){...}'.
  724. sp_before_oc_block_caret = ignore # ignore/add/remove/force
  725.  
  726. # (OC) Add or remove space after a block pointer caret,
  727. # i.e. '^int (int arg){...}' vs. '^ int (int arg){...}'.
  728. sp_after_oc_block_caret = ignore # ignore/add/remove/force
  729.  
  730. # (OC) Add or remove space between the receiver and selector in a message,
  731. # as in '[receiver selector ...]'.
  732. sp_after_oc_msg_receiver = ignore # ignore/add/remove/force
  733.  
  734. # (OC) Add or remove space after '@property'.
  735. sp_after_oc_property = ignore # ignore/add/remove/force
  736.  
  737. # (OC) Add or remove space between '@synchronized' and the open parenthesis,
  738. # i.e. '@synchronized(foo)' vs. '@synchronized (foo)'.
  739. sp_after_oc_synchronized = ignore # ignore/add/remove/force
  740.  
  741. # Add or remove space around the ':' in 'b ? t : f'.
  742. sp_cond_colon = ignore # ignore/add/remove/force
  743.  
  744. # Add or remove space before the ':' in 'b ? t : f'.
  745. #
  746. # Overrides sp_cond_colon.
  747. sp_cond_colon_before = ignore # ignore/add/remove/force
  748.  
  749. # Add or remove space after the ':' in 'b ? t : f'.
  750. #
  751. # Overrides sp_cond_colon.
  752. sp_cond_colon_after = ignore # ignore/add/remove/force
  753.  
  754. # Add or remove space around the '?' in 'b ? t : f'.
  755. sp_cond_question = ignore # ignore/add/remove/force
  756.  
  757. # Add or remove space before the '?' in 'b ? t : f'.
  758. #
  759. # Overrides sp_cond_question.
  760. sp_cond_question_before = ignore # ignore/add/remove/force
  761.  
  762. # Add or remove space after the '?' in 'b ? t : f'.
  763. #
  764. # Overrides sp_cond_question.
  765. sp_cond_question_after = ignore # ignore/add/remove/force
  766.  
  767. # In the abbreviated ternary form '(a ?: b)', add or remove space between '?'
  768. # and ':'.
  769. #
  770. # Overrides all other sp_cond_* options.
  771. sp_cond_ternary_short = ignore # ignore/add/remove/force
  772.  
  773. # Fix the spacing between 'case' and the label. Only 'ignore' and 'force' make
  774. # sense here.
  775. sp_case_label = ignore # ignore/add/remove/force
  776.  
  777. # (D) Add or remove space around the D '..' operator.
  778. sp_range = ignore # ignore/add/remove/force
  779.  
  780. # Add or remove space after ':' in a Java/C++11 range-based 'for',
  781. # as in 'for (Type var : expr)'.
  782. sp_after_for_colon = ignore # ignore/add/remove/force
  783.  
  784. # Add or remove space before ':' in a Java/C++11 range-based 'for',
  785. # as in 'for (Type var : expr)'.
  786. sp_before_for_colon = ignore # ignore/add/remove/force
  787.  
  788. # (D) Add or remove space between 'extern' and '(' as in 'extern (C)'.
  789. sp_extern_paren = ignore # ignore/add/remove/force
  790.  
  791. # Add or remove space after the opening of a C++ comment,
  792. # i.e. '// A' vs. '//A'.
  793. sp_cmt_cpp_start = ignore # ignore/add/remove/force
  794.  
  795. # If true, space is added with sp_cmt_cpp_start will be added after doxygen
  796. # sequences like '///', '///<', '//!' and '//!<'.
  797. sp_cmt_cpp_doxygen = false # true/false
  798.  
  799. # If true, space is added with sp_cmt_cpp_start will be added after Qt
  800. # translator or meta-data comments like '//:', '//=', and '//~'.
  801. sp_cmt_cpp_qttr = false # true/false
  802.  
  803. # Add or remove space between #else or #endif and a trailing comment.
  804. sp_endif_cmt = ignore # ignore/add/remove/force
  805.  
  806. # Add or remove space after 'new', 'delete' and 'delete[]'.
  807. sp_after_new = ignore # ignore/add/remove/force
  808.  
  809. # Add or remove space between 'new' and '(' in 'new()'.
  810. sp_between_new_paren = ignore # ignore/add/remove/force
  811.  
  812. # Add or remove space between ')' and type in 'new(foo) BAR'.
  813. sp_after_newop_paren = ignore # ignore/add/remove/force
  814.  
  815. # Add or remove space inside parenthesis of the new operator
  816. # as in 'new(foo) BAR'.
  817. sp_inside_newop_paren = ignore # ignore/add/remove/force
  818.  
  819. # Add or remove space after the open parenthesis of the new operator,
  820. # as in 'new(foo) BAR'.
  821. #
  822. # Overrides sp_inside_newop_paren.
  823. sp_inside_newop_paren_open = ignore # ignore/add/remove/force
  824.  
  825. # Add or remove space before the close parenthesis of the new operator,
  826. # as in 'new(foo) BAR'.
  827. #
  828. # Overrides sp_inside_newop_paren.
  829. sp_inside_newop_paren_close = ignore # ignore/add/remove/force
  830.  
  831. # Add or remove space before a trailing or embedded comment.
  832. sp_before_tr_emb_cmt = ignore # ignore/add/remove/force
  833.  
  834. # Number of spaces before a trailing or embedded comment.
  835. sp_num_before_tr_emb_cmt = 0 # unsigned number
  836.  
  837. # (Java) Add or remove space between an annotation and the open parenthesis.
  838. sp_annotation_paren = ignore # ignore/add/remove/force
  839.  
  840. # If true, vbrace tokens are dropped to the previous token and skipped.
  841. sp_skip_vbrace_tokens = false # true/false
  842.  
  843. # Add or remove space after 'noexcept'.
  844. sp_after_noexcept = ignore # ignore/add/remove/force
  845.  
  846. # If true, a <TAB> is inserted after #define.
  847. force_tab_after_define = false # true/false
  848.  
  849. #
  850. # Indenting options
  851. #
  852.  
  853. # The number of columns to indent per level. Usually 2, 3, 4, or 8.
  854. #
  855. # Default: 8
  856. indent_columns = 4 # unsigned number
  857.  
  858. # The continuation indent. If non-zero, this overrides the indent of '(' and
  859. # '=' continuation indents. Negative values are OK; negative value is absolute
  860. # and not increased for each '(' level.
  861. #
  862. # For FreeBSD, this is set to 4.
  863. indent_continue = 0 # number
  864.  
  865. # The continuation indent, only for class header line(s). If non-zero, this
  866. # overrides the indent of 'class' continuation indents.
  867. indent_continue_class_head = 0 # unsigned number
  868.  
  869. # Whether to indent empty lines (i.e. lines which contain only spaces before
  870. # the newline character).
  871. indent_single_newlines = false # true/false
  872.  
  873. # The continuation indent for func_*_param if they are true. If non-zero, this
  874. # overrides the indent.
  875. indent_param = 0 # unsigned number
  876.  
  877. # How to use tabs when indenting code.
  878. #
  879. # 0: Spaces only
  880. # 1: Indent with tabs to brace level, align with spaces (default)
  881. # 2: Indent and align with tabs, using spaces when not on a tabstop
  882. #
  883. # Default: 1
  884. indent_with_tabs = 0 # unsigned number
  885.  
  886. # Whether to indent comments that are not at a brace level with tabs on a
  887. # tabstop. Requires indent_with_tabs=2. If false, will use spaces.
  888. indent_cmt_with_tabs = false # true/false
  889.  
  890. # Whether to indent strings broken by '\' so that they line up.
  891. indent_align_string = true # true/false
  892.  
  893. # The number of spaces to indent multi-line XML strings.
  894. # Requires indent_align_string=true.
  895. indent_xml_string = 0 # unsigned number
  896.  
  897. # Spaces to indent '{' from level.
  898. indent_brace = 0 # unsigned number
  899.  
  900. # Whether braces are indented to the body level.
  901. indent_braces = false # true/false
  902.  
  903. # Whether to disable indenting function braces if indent_braces=true.
  904. indent_braces_no_func = false # true/false
  905.  
  906. # Whether to disable indenting class braces if indent_braces=true.
  907. indent_braces_no_class = false # true/false
  908.  
  909. # Whether to disable indenting struct braces if indent_braces=true.
  910. indent_braces_no_struct = false # true/false
  911.  
  912. # Whether to indent based on the size of the brace parent,
  913. # i.e. 'if' → 3 spaces, 'for' → 4 spaces, etc.
  914. indent_brace_parent = false # true/false
  915.  
  916. # Whether to indent based on the open parenthesis instead of the open brace
  917. # in '({\n'.
  918. indent_paren_open_brace = false # true/false
  919.  
  920. # (C#) Whether to indent the brace of a C# delegate by another level.
  921. indent_cs_delegate_brace = false # true/false
  922.  
  923. # (C#) Whether to indent a C# delegate (to handle delegates with no brace) by
  924. # another level.
  925. indent_cs_delegate_body = false # true/false
  926.  
  927. # Whether to indent the body of a 'namespace'.
  928. indent_namespace = false # true/false
  929.  
  930. # Whether to indent only the first namespace, and not any nested namespaces.
  931. # Requires indent_namespace=true.
  932. indent_namespace_single_indent = false # true/false
  933.  
  934. # The number of spaces to indent a namespace block.
  935. indent_namespace_level = 0 # unsigned number
  936.  
  937. # If the body of the namespace is longer than this number, it won't be
  938. # indented. Requires indent_namespace=true. 0 means no limit.
  939. indent_namespace_limit = 0 # unsigned number
  940.  
  941. # Whether the 'extern "C"' body is indented.
  942. indent_extern = false # true/false
  943.  
  944. # Whether the 'class' body is indented.
  945. indent_class = true # true/false
  946.  
  947. # Whether to indent the stuff after a leading base class colon.
  948. indent_class_colon = false # true/false
  949.  
  950. # Whether to indent based on a class colon instead of the stuff after the
  951. # colon. Requires indent_class_colon=true.
  952. indent_class_on_colon = false # true/false
  953.  
  954. # Whether to indent the stuff after a leading class initializer colon.
  955. indent_constr_colon = false # true/false
  956.  
  957. # Virtual indent from the ':' for member initializers.
  958. #
  959. # Default: 2
  960. indent_ctor_init_leading = 2 # unsigned number
  961.  
  962. # Additional indent for constructor initializer list.
  963. # Negative values decrease indent down to the first column.
  964. indent_ctor_init = 0 # number
  965.  
  966. # Whether to indent 'if' following 'else' as a new block under the 'else'.
  967. # If false, 'else\nif' is treated as 'else if' for indenting purposes.
  968. indent_else_if = false # true/false
  969.  
  970. # Amount to indent variable declarations after a open brace.
  971. #
  972. # <0: Relative
  973. # ≥0: Absolute
  974. indent_var_def_blk = 0 # number
  975.  
  976. # Whether to indent continued variable declarations instead of aligning.
  977. indent_var_def_cont = false # true/false
  978.  
  979. # Whether to indent continued shift expressions ('<<' and '>>') instead of
  980. # aligning. Set align_left_shift=false when enabling this.
  981. indent_shift = false # true/false
  982.  
  983. # Whether to force indentation of function definitions to start in column 1.
  984. indent_func_def_force_col1 = false # true/false
  985.  
  986. # Whether to indent continued function call parameters one indent level,
  987. # rather than aligning parameters under the open parenthesis.
  988. indent_func_call_param = false # true/false
  989.  
  990. # Same as indent_func_call_param, but for function definitions.
  991. indent_func_def_param = false # true/false
  992.  
  993. # Same as indent_func_call_param, but for function prototypes.
  994. indent_func_proto_param = false # true/false
  995.  
  996. # Same as indent_func_call_param, but for class declarations.
  997. indent_func_class_param = false # true/false
  998.  
  999. # Same as indent_func_call_param, but for class variable constructors.
  1000. indent_func_ctor_var_param = false # true/false
  1001.  
  1002. # Same as indent_func_call_param, but for template parameter lists.
  1003. indent_template_param = false # true/false
  1004.  
  1005. # Double the indent for indent_func_xxx_param options.
  1006. # Use both values of the options indent_columns and indent_param.
  1007. indent_func_param_double = false # true/false
  1008.  
  1009. # Indentation column for standalone 'const' qualifier on a function
  1010. # prototype.
  1011. indent_func_const = 0 # unsigned number
  1012.  
  1013. # Indentation column for standalone 'throw' qualifier on a function
  1014. # prototype.
  1015. indent_func_throw = 0 # unsigned number
  1016.  
  1017. # The number of spaces to indent a continued '->' or '.'.
  1018. # Usually set to 0, 1, or indent_columns.
  1019. indent_member = 0 # unsigned number
  1020.  
  1021. # Whether lines broken at '.' or '->' should be indented by a single indent.
  1022. # The indent_member option will not be effective if this is set to true.
  1023. indent_member_single = false # true/false
  1024.  
  1025. # Spaces to indent single line ('//') comments on lines before code.
  1026. indent_sing_line_comments = 0 # unsigned number
  1027.  
  1028. # Whether to indent trailing single line ('//') comments relative to the code
  1029. # instead of trying to keep the same absolute column.
  1030. indent_relative_single_line_comments = false # true/false
  1031.  
  1032. # Spaces to indent 'case' from 'switch'. Usually 0 or indent_columns.
  1033. indent_switch_case = 4 # unsigned number
  1034.  
  1035. # Whether to indent preprocessor statements inside of switch statements.
  1036. #
  1037. # Default: true
  1038. indent_switch_pp = true # true/false
  1039.  
  1040. # Spaces to shift the 'case' line, without affecting any other lines.
  1041. # Usually 0.
  1042. indent_case_shift = 0 # unsigned number
  1043.  
  1044. # Spaces to indent '{' from 'case'. By default, the brace will appear under
  1045. # the 'c' in case. Usually set to 0 or indent_columns. Negative values are OK.
  1046. indent_case_brace = 0 # number
  1047.  
  1048. # Whether to indent comments found in first column.
  1049. indent_col1_comment = false # true/false
  1050.  
  1051. # How to indent goto labels.
  1052. #
  1053. # >0: Absolute column where 1 is the leftmost column
  1054. # ≤0: Subtract from brace indent
  1055. #
  1056. # Default: 1
  1057. indent_label = 1 # number
  1058.  
  1059. # Same as indent_label, but for access specifiers that are followed by a
  1060. # colon.
  1061. #
  1062. # Default: 1
  1063. indent_access_spec = 1 # number
  1064.  
  1065. # Whether to indent the code after an access specifier by one level.
  1066. # If true, this option forces 'indent_access_spec=0'.
  1067. indent_access_spec_body = false # true/false
  1068.  
  1069. # If an open parenthesis is followed by a newline, whether to indent the next
  1070. # line so that it lines up after the open parenthesis (not recommended).
  1071. indent_paren_nl = false # true/false
  1072.  
  1073. # How to indent a close parenthesis after a newline.
  1074. #
  1075. # 0: Indent to body level (default)
  1076. # 1: Align under the open parenthesis
  1077. # 2: Indent to the brace level
  1078. indent_paren_close = 2 # unsigned number
  1079.  
  1080. # Whether to indent the open parenthesis of a function definition,
  1081. # if the parenthesis is on its own line.
  1082. indent_paren_after_func_def = false # true/false
  1083.  
  1084. # Whether to indent the open parenthesis of a function declaration,
  1085. # if the parenthesis is on its own line.
  1086. indent_paren_after_func_decl = false # true/false
  1087.  
  1088. # Whether to indent the open parenthesis of a function call,
  1089. # if the parenthesis is on its own line.
  1090. indent_paren_after_func_call = false # true/false
  1091.  
  1092. # Whether to indent a comma when inside a parenthesis.
  1093. # If true, aligns under the open parenthesis.
  1094. indent_comma_paren = false # true/false
  1095.  
  1096. # Whether to indent a Boolean operator when inside a parenthesis.
  1097. # If true, aligns under the open parenthesis.
  1098. indent_bool_paren = false # true/false
  1099.  
  1100. # Whether to indent a semicolon when inside a for parenthesis.
  1101. # If true, aligns under the open for parenthesis.
  1102. indent_semicolon_for_paren = false # true/false
  1103.  
  1104. # Whether to align the first expression to following ones
  1105. # if indent_bool_paren=true.
  1106. indent_first_bool_expr = false # true/false
  1107.  
  1108. # Whether to align the first expression to following ones
  1109. # if indent_semicolon_for_paren=true.
  1110. indent_first_for_expr = false # true/false
  1111.  
  1112. # If an open square is followed by a newline, whether to indent the next line
  1113. # so that it lines up after the open square (not recommended).
  1114. indent_square_nl = false # true/false
  1115.  
  1116. # (ESQL/C) Whether to preserve the relative indent of 'EXEC SQL' bodies.
  1117. indent_preserve_sql = false # true/false
  1118.  
  1119. # Whether to align continued statements at the '='. If false or if the '=' is
  1120. # followed by a newline, the next line is indent one tab.
  1121. #
  1122. # Default: true
  1123. indent_align_assign = true # true/false
  1124.  
  1125. # Whether to align continued statements at the '('. If false or the '(' is not
  1126. # followed by a newline, the next line indent is one tab.
  1127. #
  1128. # Default: true
  1129. indent_align_paren = true # true/false
  1130.  
  1131. # (OC) Whether to indent Objective-C blocks at brace level instead of usual
  1132. # rules.
  1133. indent_oc_block = true # true/false
  1134.  
  1135. # (OC) Indent for Objective-C blocks in a message relative to the parameter
  1136. # name.
  1137. #
  1138. # =0: Use indent_oc_block rules
  1139. # >0: Use specified number of spaces to indent
  1140. indent_oc_block_msg = 0 # unsigned number
  1141.  
  1142. # (OC) Minimum indent for subsequent parameters
  1143. indent_oc_msg_colon = 0 # unsigned number
  1144.  
  1145. # (OC) Whether to prioritize aligning with initial colon (and stripping spaces
  1146. # from lines, if necessary).
  1147. #
  1148. # Default: true
  1149. indent_oc_msg_prioritize_first_colon = true # true/false
  1150.  
  1151. # (OC) Whether to indent blocks the way that Xcode does by default
  1152. # (from the keyword if the parameter is on its own line; otherwise, from the
  1153. # previous indentation level). Requires indent_oc_block_msg=true.
  1154. indent_oc_block_msg_xcode_style = false # true/false
  1155.  
  1156. # (OC) Whether to indent blocks from where the brace is, relative to a
  1157. # message keyword. Requires indent_oc_block_msg=true.
  1158. indent_oc_block_msg_from_keyword = false # true/false
  1159.  
  1160. # (OC) Whether to indent blocks from where the brace is, relative to a message
  1161. # colon. Requires indent_oc_block_msg=true.
  1162. indent_oc_block_msg_from_colon = false # true/false
  1163.  
  1164. # (OC) Whether to indent blocks from where the block caret is.
  1165. # Requires indent_oc_block_msg=true.
  1166. indent_oc_block_msg_from_caret = false # true/false
  1167.  
  1168. # (OC) Whether to indent blocks from where the brace caret is.
  1169. # Requires indent_oc_block_msg=true.
  1170. indent_oc_block_msg_from_brace = false # true/false
  1171.  
  1172. # When indenting after virtual brace open and newline add further spaces to
  1173. # reach this minimum indent.
  1174. indent_min_vbrace_open = 0 # unsigned number
  1175.  
  1176. # Whether to add further spaces after regular indent to reach next tabstop
  1177. # when identing after virtual brace open and newline.
  1178. indent_vbrace_open_on_tabstop = false # true/false
  1179.  
  1180. # How to indent after a brace followed by another token (not a newline).
  1181. # true: indent all contained lines to match the token
  1182. # false: indent all contained lines to match the brace
  1183. #
  1184. # Default: true
  1185. indent_token_after_brace = true # true/false
  1186.  
  1187. # Whether to indent the body of a C++11 lambda.
  1188. indent_cpp_lambda_body = false # true/false
  1189.  
  1190. # (C#) Whether to indent a 'using' block if no braces are used.
  1191. #
  1192. # Default: true
  1193. indent_using_block = true # true/false
  1194.  
  1195. # How to indent the continuation of ternary operator.
  1196. #
  1197. # 0: Off (default)
  1198. # 1: When the `if_false` is a continuation, indent it under `if_false`
  1199. # 2: When the `:` is a continuation, indent it under `?`
  1200. indent_ternary_operator = 2 # unsigned number
  1201.  
  1202. # If true, the indentation of the chunks after a `return new` sequence will be set at return indentation column.
  1203. indent_off_after_return_new = false # true/false
  1204.  
  1205. # If true, the tokens after return are indented with regular single indentation. By default (false) the indentation is after the return token.
  1206. indent_single_after_return = false # true/false
  1207.  
  1208. # Whether to ignore indent and alignment for 'asm' blocks (i.e. assume they
  1209. # have their own indentation).
  1210. indent_ignore_asm_block = false # true/false
  1211.  
  1212. #
  1213. # Newline adding and removing options
  1214. #
  1215.  
  1216. # Whether to collapse empty blocks between '{' and '}'.
  1217. nl_collapse_empty_body = false # true/false
  1218.  
  1219. # Don't split one-line braced assignments, as in 'foo_t f = { 1, 2 };'.
  1220. nl_assign_leave_one_liners = false # true/false
  1221.  
  1222. # Don't split one-line braced statements inside a 'class xx { }' body.
  1223. nl_class_leave_one_liners = false # true/false
  1224.  
  1225. # Don't split one-line enums, as in 'enum foo { BAR = 15 };'
  1226. nl_enum_leave_one_liners = false # true/false
  1227.  
  1228. # Don't split one-line get or set functions.
  1229. nl_getset_leave_one_liners = false # true/false
  1230.  
  1231. # (C#) Don't split one-line property get or set functions.
  1232. nl_cs_property_leave_one_liners = false # true/false
  1233.  
  1234. # Don't split one-line function definitions, as in 'int foo() { return 0; }'.
  1235. nl_func_leave_one_liners = true # true/false
  1236.  
  1237. # Don't split one-line C++11 lambdas, as in '[]() { return 0; }'.
  1238. nl_cpp_lambda_leave_one_liners = false # true/false
  1239.  
  1240. # Don't split one-line if/else statements, as in 'if(...) b++;'.
  1241. nl_if_leave_one_liners = false # true/false
  1242.  
  1243. # Don't split one-line while statements, as in 'while(...) b++;'.
  1244. nl_while_leave_one_liners = false # true/false
  1245.  
  1246. # Don't split one-line for statements, as in 'for(...) b++;'.
  1247. nl_for_leave_one_liners = false # true/false
  1248.  
  1249. # (OC) Don't split one-line Objective-C messages.
  1250. nl_oc_msg_leave_one_liner = false # true/false
  1251.  
  1252. # (OC) Add or remove newline between method declaration and '{'.
  1253. nl_oc_mdef_brace = remove # ignore/add/remove/force
  1254.  
  1255. # (OC) Add or remove newline between Objective-C block signature and '{'.
  1256. nl_oc_block_brace = remove # ignore/add/remove/force
  1257.  
  1258. # (OC) Add or remove newline between '@interface' and '{'.
  1259. nl_oc_interface_brace = remove # ignore/add/remove/force
  1260.  
  1261. # (OC) Add or remove newline between '@implementation' and '{'.
  1262. nl_oc_implementation_brace = remove # ignore/add/remove/force
  1263.  
  1264. # Add or remove newlines at the start of the file.
  1265. nl_start_of_file = ignore # ignore/add/remove/force
  1266.  
  1267. # The minimum number of newlines at the start of the file (only used if
  1268. # nl_start_of_file is 'add' or 'force').
  1269. nl_start_of_file_min = 0 # unsigned number
  1270.  
  1271. # Add or remove newline at the end of the file.
  1272. nl_end_of_file = ignore # ignore/add/remove/force
  1273.  
  1274. # The minimum number of newlines at the end of the file (only used if
  1275. # nl_end_of_file is 'add' or 'force').
  1276. nl_end_of_file_min = 0 # unsigned number
  1277.  
  1278. # Add or remove newline between '=' and '{'.
  1279. nl_assign_brace = ignore # ignore/add/remove/force
  1280.  
  1281. # (D) Add or remove newline between '=' and '['.
  1282. nl_assign_square = ignore # ignore/add/remove/force
  1283.  
  1284. # Add or remove newline between '[]' and '{'.
  1285. nl_tsquare_brace = ignore # ignore/add/remove/force
  1286.  
  1287. # (D) Add or remove newline after '= ['. Will also affect the newline before
  1288. # the ']'.
  1289. nl_after_square_assign = ignore # ignore/add/remove/force
  1290.  
  1291. # The number of blank lines after a block of variable definitions at the top
  1292. # of a function body.
  1293. #
  1294. # 0 = No change (default).
  1295. nl_func_var_def_blk = 0 # unsigned number
  1296.  
  1297. # The number of newlines before a block of typedefs. If nl_after_access_spec
  1298. # is non-zero, that option takes precedence.
  1299. #
  1300. # 0 = No change (default).
  1301. nl_typedef_blk_start = 0 # unsigned number
  1302.  
  1303. # The number of newlines after a block of typedefs.
  1304. #
  1305. # 0 = No change (default).
  1306. nl_typedef_blk_end = 0 # unsigned number
  1307.  
  1308. # The maximum number of consecutive newlines within a block of typedefs.
  1309. #
  1310. # 0 = No change (default).
  1311. nl_typedef_blk_in = 0 # unsigned number
  1312.  
  1313. # The number of newlines before a block of variable definitions not at the top
  1314. # of a function body. If nl_after_access_spec is non-zero, that option takes
  1315. # precedence.
  1316. #
  1317. # 0 = No change (default).
  1318. nl_var_def_blk_start = 0 # unsigned number
  1319.  
  1320. # The number of newlines after a block of variable definitions not at the top
  1321. # of a function body.
  1322. #
  1323. # 0 = No change (default).
  1324. nl_var_def_blk_end = 0 # unsigned number
  1325.  
  1326. # The maximum number of consecutive newlines within a block of variable
  1327. # definitions.
  1328. #
  1329. # 0 = No change (default).
  1330. nl_var_def_blk_in = 0 # unsigned number
  1331.  
  1332. # Add or remove newline between a function call's ')' and '{', as in
  1333. # 'list_for_each(item, &list) { }'.
  1334. nl_fcall_brace = ignore # ignore/add/remove/force
  1335.  
  1336. # Add or remove newline between 'enum' and '{'.
  1337. nl_enum_brace = remove # ignore/add/remove/force
  1338.  
  1339. # Add or remove newline between 'enum' and 'class'.
  1340. nl_enum_class = remove # ignore/add/remove/force
  1341.  
  1342. # Add or remove newline between 'enum class' and the identifier.
  1343. nl_enum_class_identifier = ignore # ignore/add/remove/force
  1344.  
  1345. # Add or remove newline between 'enum class' type and ':'.
  1346. nl_enum_identifier_colon = ignore # ignore/add/remove/force
  1347.  
  1348. # Add or remove newline between 'enum class identifier :' and type.
  1349. nl_enum_colon_type = ignore # ignore/add/remove/force
  1350.  
  1351. # Add or remove newline between 'struct and '{'.
  1352. nl_struct_brace = remove # ignore/add/remove/force
  1353.  
  1354. # Add or remove newline between 'union' and '{'.
  1355. nl_union_brace = remove # ignore/add/remove/force
  1356.  
  1357. # Add or remove newline between 'if' and '{'.
  1358. nl_if_brace = remove # ignore/add/remove/force
  1359.  
  1360. # Add or remove newline between '}' and 'else'.
  1361. nl_brace_else = remove # ignore/add/remove/force
  1362.  
  1363. # Add or remove newline between 'else if' and '{'. If set to ignore,
  1364. # nl_if_brace is used instead.
  1365. nl_elseif_brace = remove # ignore/add/remove/force
  1366.  
  1367. # Add or remove newline between 'else' and '{'.
  1368. nl_else_brace = remove # ignore/add/remove/force
  1369.  
  1370. # Add or remove newline between 'else' and 'if'.
  1371. nl_else_if = ignore # ignore/add/remove/force
  1372.  
  1373. # Add or remove newline before 'if'/'else if' closing parenthesis.
  1374. nl_before_if_closing_paren = ignore # ignore/add/remove/force
  1375.  
  1376. # Add or remove newline between '}' and 'finally'.
  1377. nl_brace_finally = remove # ignore/add/remove/force
  1378.  
  1379. # Add or remove newline between 'finally' and '{'.
  1380. nl_finally_brace = remove # ignore/add/remove/force
  1381.  
  1382. # Add or remove newline between 'try' and '{'.
  1383. nl_try_brace = remove # ignore/add/remove/force
  1384.  
  1385. # Add or remove newline between get/set and '{'.
  1386. nl_getset_brace = ignore # ignore/add/remove/force
  1387.  
  1388. # Add or remove newline between 'for' and '{'.
  1389. nl_for_brace = ignore # ignore/add/remove/force
  1390.  
  1391. # Add or remove newline before the '{' of a 'catch' statement, as in
  1392. # 'catch (decl) <here> {'.
  1393. nl_catch_brace = ignore # ignore/add/remove/force
  1394.  
  1395. # (OC) Add or remove newline before the '{' of a '@catch' statement, as in
  1396. # '@catch (decl) <here> {'. If set to ignore, nl_catch_brace is used.
  1397. nl_oc_catch_brace = ignore # ignore/add/remove/force
  1398.  
  1399. # Add or remove newline between '}' and 'catch'.
  1400. nl_brace_catch = ignore # ignore/add/remove/force
  1401.  
  1402. # (OC) Add or remove newline between '}' and '@catch'. If set to ignore,
  1403. # nl_brace_catch is used.
  1404. nl_oc_brace_catch = ignore # ignore/add/remove/force
  1405.  
  1406. # Add or remove newline between '}' and ']'.
  1407. nl_brace_square = ignore # ignore/add/remove/force
  1408.  
  1409. # Add or remove newline between '}' and ')' in a function invocation.
  1410. nl_brace_fparen = ignore # ignore/add/remove/force
  1411.  
  1412. # Add or remove newline between 'while' and '{'.
  1413. nl_while_brace = remove # ignore/add/remove/force
  1414.  
  1415. # (D) Add or remove newline between 'scope (x)' and '{'.
  1416. nl_scope_brace = ignore # ignore/add/remove/force
  1417.  
  1418. # (D) Add or remove newline between 'unittest' and '{'.
  1419. nl_unittest_brace = ignore # ignore/add/remove/force
  1420.  
  1421. # (D) Add or remove newline between 'version (x)' and '{'.
  1422. nl_version_brace = ignore # ignore/add/remove/force
  1423.  
  1424. # (C#) Add or remove newline between 'using' and '{'.
  1425. nl_using_brace = ignore # ignore/add/remove/force
  1426.  
  1427. # Add or remove newline between two open or close braces. Due to general
  1428. # newline/brace handling, REMOVE may not work.
  1429. nl_brace_brace = ignore # ignore/add/remove/force
  1430.  
  1431. # Add or remove newline between 'do' and '{'.
  1432. nl_do_brace = remove # ignore/add/remove/force
  1433.  
  1434. # Add or remove newline between '}' and 'while' of 'do' statement.
  1435. nl_brace_while = remove # ignore/add/remove/force
  1436.  
  1437. # Add or remove newline between 'switch' and '{'.
  1438. nl_switch_brace = remove # ignore/add/remove/force
  1439.  
  1440. # Add or remove newline between 'synchronized' and '{'.
  1441. nl_synchronized_brace = remove # ignore/add/remove/force
  1442.  
  1443. # Add a newline between ')' and '{' if the ')' is on a different line than the
  1444. # if/for/etc.
  1445. #
  1446. # Overrides nl_for_brace, nl_if_brace, nl_switch_brace, nl_while_switch and
  1447. # nl_catch_brace.
  1448. nl_multi_line_cond = false # true/false
  1449.  
  1450. # Force a newline in a define after the macro name for multi-line defines.
  1451. nl_multi_line_define = false # true/false
  1452.  
  1453. # Whether to add a newline before 'case', and a blank line before a 'case'
  1454. # statement that follows a ';' or '}'.
  1455. nl_before_case = false # true/false
  1456.  
  1457. # Whether to add a newline after a 'case' statement.
  1458. nl_after_case = false # true/false
  1459.  
  1460. # Add or remove newline between a case ':' and '{'.
  1461. #
  1462. # Overrides nl_after_case.
  1463. nl_case_colon_brace = ignore # ignore/add/remove/force
  1464.  
  1465. # Add or remove newline between ')' and 'throw'.
  1466. nl_before_throw = ignore # ignore/add/remove/force
  1467.  
  1468. # Add or remove newline between 'namespace' and '{'.
  1469. nl_namespace_brace = remove # ignore/add/remove/force
  1470.  
  1471. # Add or remove newline between 'template<>' and whatever follows.
  1472. nl_template_class = ignore # ignore/add/remove/force
  1473.  
  1474. # Add or remove newline between 'class' and '{'.
  1475. nl_class_brace = remove # ignore/add/remove/force
  1476.  
  1477. # Add or remove newline before or after (depending on pos_class_comma) each
  1478. # ',' in the base class list.
  1479. nl_class_init_args = ignore # ignore/add/remove/force
  1480.  
  1481. # Add or remove newline after each ',' in the constructor member
  1482. # initialization. Related to nl_constr_colon, pos_constr_colon and
  1483. # pos_constr_comma.
  1484. nl_constr_init_args = ignore # ignore/add/remove/force
  1485.  
  1486. # Add or remove newline before first element, after comma, and after last
  1487. # element, in 'enum'.
  1488. nl_enum_own_lines = ignore # ignore/add/remove/force
  1489.  
  1490. # Add or remove newline between return type and function name in a function
  1491. # definition.
  1492. nl_func_type_name = ignore # ignore/add/remove/force
  1493.  
  1494. # Add or remove newline between return type and function name inside a class
  1495. # definition. If set to ignore, nl_func_type_name or nl_func_proto_type_name
  1496. # is used instead.
  1497. nl_func_type_name_class = ignore # ignore/add/remove/force
  1498.  
  1499. # Add or remove newline between class specification and '::'
  1500. # in 'void A::f() { }'. Only appears in separate member implementation (does
  1501. # not appear with in-line implementation).
  1502. nl_func_class_scope = ignore # ignore/add/remove/force
  1503.  
  1504. # Add or remove newline between function scope and name, as in
  1505. # 'void A :: <here> f() { }'.
  1506. nl_func_scope_name = ignore # ignore/add/remove/force
  1507.  
  1508. # Add or remove newline between return type and function name in a prototype.
  1509. nl_func_proto_type_name = ignore # ignore/add/remove/force
  1510.  
  1511. # Add or remove newline between a function name and the opening '(' in the
  1512. # declaration.
  1513. nl_func_paren = ignore # ignore/add/remove/force
  1514.  
  1515. # Overrides nl_func_paren for functions with no parameters.
  1516. nl_func_paren_empty = ignore # ignore/add/remove/force
  1517.  
  1518. # Add or remove newline between a function name and the opening '(' in the
  1519. # definition.
  1520. nl_func_def_paren = ignore # ignore/add/remove/force
  1521.  
  1522. # Overrides nl_func_def_paren for functions with no parameters.
  1523. nl_func_def_paren_empty = ignore # ignore/add/remove/force
  1524.  
  1525. # Add or remove newline between a function name and the opening '(' in the
  1526. # call.
  1527. nl_func_call_paren = ignore # ignore/add/remove/force
  1528.  
  1529. # Overrides nl_func_call_paren for functions with no parameters.
  1530. nl_func_call_paren_empty = ignore # ignore/add/remove/force
  1531.  
  1532. # Add or remove newline after '(' in a function declaration.
  1533. nl_func_decl_start = ignore # ignore/add/remove/force
  1534.  
  1535. # Add or remove newline after '(' in a function definition.
  1536. nl_func_def_start = ignore # ignore/add/remove/force
  1537.  
  1538. # Overrides nl_func_decl_start when there is only one parameter.
  1539. nl_func_decl_start_single = ignore # ignore/add/remove/force
  1540.  
  1541. # Overrides nl_func_def_start when there is only one parameter.
  1542. nl_func_def_start_single = ignore # ignore/add/remove/force
  1543.  
  1544. # Whether to add a newline after '(' in a function declaration if '(' and ')'
  1545. # are in different lines. If false, nl_func_decl_start is used instead.
  1546. nl_func_decl_start_multi_line = false # true/false
  1547.  
  1548. # Whether to add a newline after '(' in a function definition if '(' and ')'
  1549. # are in different lines. If false, nl_func_def_start is used instead.
  1550. nl_func_def_start_multi_line = false # true/false
  1551.  
  1552. # Add or remove newline after each ',' in a function declaration.
  1553. nl_func_decl_args = ignore # ignore/add/remove/force
  1554.  
  1555. # Add or remove newline after each ',' in a function definition.
  1556. nl_func_def_args = ignore # ignore/add/remove/force
  1557.  
  1558. # Whether to add a newline after each ',' in a function declaration if '('
  1559. # and ')' are in different lines. If false, nl_func_decl_args is used instead.
  1560. nl_func_decl_args_multi_line = false # true/false
  1561.  
  1562. # Whether to add a newline after each ',' in a function definition if '('
  1563. # and ')' are in different lines. If false, nl_func_def_args is used instead.
  1564. nl_func_def_args_multi_line = false # true/false
  1565.  
  1566. # Add or remove newline before the ')' in a function declaration.
  1567. nl_func_decl_end = ignore # ignore/add/remove/force
  1568.  
  1569. # Add or remove newline before the ')' in a function definition.
  1570. nl_func_def_end = ignore # ignore/add/remove/force
  1571.  
  1572. # Overrides nl_func_decl_end when there is only one parameter.
  1573. nl_func_decl_end_single = ignore # ignore/add/remove/force
  1574.  
  1575. # Overrides nl_func_def_end when there is only one parameter.
  1576. nl_func_def_end_single = ignore # ignore/add/remove/force
  1577.  
  1578. # Whether to add a newline before ')' in a function declaration if '(' and ')'
  1579. # are in different lines. If false, nl_func_decl_end is used instead.
  1580. nl_func_decl_end_multi_line = false # true/false
  1581.  
  1582. # Whether to add a newline before ')' in a function definition if '(' and ')'
  1583. # are in different lines. If false, nl_func_def_end is used instead.
  1584. nl_func_def_end_multi_line = false # true/false
  1585.  
  1586. # Add or remove newline between '()' in a function declaration.
  1587. nl_func_decl_empty = ignore # ignore/add/remove/force
  1588.  
  1589. # Add or remove newline between '()' in a function definition.
  1590. nl_func_def_empty = ignore # ignore/add/remove/force
  1591.  
  1592. # Add or remove newline between '()' in a function call.
  1593. nl_func_call_empty = ignore # ignore/add/remove/force
  1594.  
  1595. # Whether to add a newline after '(' in a function call if '(' and ')' are in
  1596. # different lines.
  1597. nl_func_call_start_multi_line = false # true/false
  1598.  
  1599. # Whether to add a newline after each ',' in a function call if '(' and ')'
  1600. # are in different lines.
  1601. nl_func_call_args_multi_line = false # true/false
  1602.  
  1603. # Whether to add a newline before ')' in a function call if '(' and ')' are in
  1604. # different lines.
  1605. nl_func_call_end_multi_line = false # true/false
  1606.  
  1607. # (OC) Whether to put each Objective-C message parameter on a separate line.
  1608. # See nl_oc_msg_leave_one_liner.
  1609. nl_oc_msg_args = false # true/false
  1610.  
  1611. # Add or remove newline between function signature and '{'.
  1612. nl_fdef_brace = remove # ignore/add/remove/force
  1613.  
  1614. # Add or remove newline between C++11 lambda signature and '{'.
  1615. nl_cpp_ldef_brace = remove # ignore/add/remove/force
  1616.  
  1617. # Add or remove newline between 'return' and the return expression.
  1618. nl_return_expr = remove # ignore/add/remove/force
  1619.  
  1620. # Whether to add a newline after semicolons, except in 'for' statements.
  1621. nl_after_semicolon = false # true/false
  1622.  
  1623. # (Java) Add or remove newline between the ')' and '{{' of the double brace
  1624. # initializer.
  1625. nl_paren_dbrace_open = ignore # ignore/add/remove/force
  1626.  
  1627. # Whether to add a newline after the type in an unnamed temporary
  1628. # direct-list-initialization.
  1629. nl_type_brace_init_lst = ignore # ignore/add/remove/force
  1630.  
  1631. # Whether to add a newline after the open brace in an unnamed temporary
  1632. # direct-list-initialization.
  1633. nl_type_brace_init_lst_open = ignore # ignore/add/remove/force
  1634.  
  1635. # Whether to add a newline before the close brace in an unnamed temporary
  1636. # direct-list-initialization.
  1637. nl_type_brace_init_lst_close = ignore # ignore/add/remove/force
  1638.  
  1639. # Whether to add a newline after '{'. This also adds a newline before the
  1640. # matching '}'.
  1641. nl_after_brace_open = false # true/false
  1642.  
  1643. # Whether to add a newline between the open brace and a trailing single-line
  1644. # comment. Requires nl_after_brace_open=true.
  1645. nl_after_brace_open_cmt = false # true/false
  1646.  
  1647. # Whether to add a newline after a virtual brace open with a non-empty body.
  1648. # These occur in un-braced if/while/do/for statement bodies.
  1649. nl_after_vbrace_open = false # true/false
  1650.  
  1651. # Whether to add a newline after a virtual brace open with an empty body.
  1652. # These occur in un-braced if/while/do/for statement bodies.
  1653. nl_after_vbrace_open_empty = false # true/false
  1654.  
  1655. # Whether to add a newline after '}'. Does not apply if followed by a
  1656. # necessary ';'.
  1657. nl_after_brace_close = false # true/false
  1658.  
  1659. # Whether to add a newline after a virtual brace close,
  1660. # as in 'if (foo) a++; <here> return;'.
  1661. nl_after_vbrace_close = false # true/false
  1662.  
  1663. # Add or remove newline between the close brace and identifier,
  1664. # as in 'struct { int a; } <here> b;'. Affects enumerations, unions and
  1665. # structures. If set to ignore, uses nl_after_brace_close.
  1666. nl_brace_struct_var = ignore # ignore/add/remove/force
  1667.  
  1668. # Whether to alter newlines in '#define' macros.
  1669. nl_define_macro = false # true/false
  1670.  
  1671. # Whether to alter newlines between consecutive parenthesis closes. The number
  1672. # of closing parentheses in a line will depend on respective open parenthesis
  1673. # lines.
  1674. nl_squeeze_paren_close = false # true/false
  1675.  
  1676. # Whether to remove blanks after '#ifxx' and '#elxx', or before '#elxx' and
  1677. # '#endif'. Does not affect top-level #ifdefs.
  1678. nl_squeeze_ifdef = false # true/false
  1679.  
  1680. # Makes the nl_squeeze_ifdef option affect the top-level #ifdefs as well.
  1681. nl_squeeze_ifdef_top_level = false # true/false
  1682.  
  1683. # Add or remove blank line before 'if'.
  1684. nl_before_if = add # ignore/add/remove/force
  1685.  
  1686. # Add or remove blank line after 'if' statement. Add/Force work only if the
  1687. # next token is not a closing brace.
  1688. nl_after_if = add # ignore/add/remove/force
  1689.  
  1690. # Add or remove blank line before 'for'.
  1691. nl_before_for = add # ignore/add/remove/force
  1692.  
  1693. # Add or remove blank line after 'for' statement.
  1694. nl_after_for = add # ignore/add/remove/force
  1695.  
  1696. # Add or remove blank line before 'while'.
  1697. nl_before_while = add # ignore/add/remove/force
  1698.  
  1699. # Add or remove blank line after 'while' statement.
  1700. nl_after_while = add # ignore/add/remove/force
  1701.  
  1702. # Add or remove blank line before 'switch'.
  1703. nl_before_switch = add # ignore/add/remove/force
  1704.  
  1705. # Add or remove blank line after 'switch' statement.
  1706. nl_after_switch = add # ignore/add/remove/force
  1707.  
  1708. # Add or remove blank line before 'synchronized'.
  1709. nl_before_synchronized = ignore # ignore/add/remove/force
  1710.  
  1711. # Add or remove blank line after 'synchronized' statement.
  1712. nl_after_synchronized = ignore # ignore/add/remove/force
  1713.  
  1714. # Add or remove blank line before 'do'.
  1715. nl_before_do = add # ignore/add/remove/force
  1716.  
  1717. # Add or remove blank line after 'do/while' statement.
  1718. nl_after_do = add # ignore/add/remove/force
  1719.  
  1720. # Whether to double-space commented-entries in 'struct'/'union'/'enum'.
  1721. nl_ds_struct_enum_cmt = false # true/false
  1722.  
  1723. # Whether to force a newline before '}' of a 'struct'/'union'/'enum'.
  1724. # (Lower priority than eat_blanks_before_close_brace.)
  1725. nl_ds_struct_enum_close_brace = false # true/false
  1726.  
  1727. # Add or remove newline before or after (depending on pos_class_colon) a class
  1728. # colon, as in 'class Foo <here> : <or here> public Bar'.
  1729. nl_class_colon = ignore # ignore/add/remove/force
  1730.  
  1731. # Add or remove newline around a class constructor colon. The exact position
  1732. # depends on nl_constr_init_args, pos_constr_colon and pos_constr_comma.
  1733. nl_constr_colon = ignore # ignore/add/remove/force
  1734.  
  1735. # Whether to collapse a two-line namespace, like 'namespace foo\n{ decl; }'
  1736. # into a single line. If true, prevents other brace newline rules from turning
  1737. # such code into four lines.
  1738. nl_namespace_two_to_one_liner = false # true/false
  1739.  
  1740. # Whether to remove a newline in simple unbraced if statements, turning them
  1741. # into one-liners, as in 'if(b)\n i++;' → 'if(b) i++;'.
  1742. nl_create_if_one_liner = false # true/false
  1743.  
  1744. # Whether to remove a newline in simple unbraced for statements, turning them
  1745. # into one-liners, as in 'for (...)\n stmt;' → 'for (...) stmt;'.
  1746. nl_create_for_one_liner = false # true/false
  1747.  
  1748. # Whether to remove a newline in simple unbraced while statements, turning
  1749. # them into one-liners, as in 'while (expr)\n stmt;' → 'while (expr) stmt;'.
  1750. nl_create_while_one_liner = false # true/false
  1751.  
  1752. # Whether to collapse a function definition whose body (not counting braces)
  1753. # is only one line so that the entire definition (prototype, braces, body) is
  1754. # a single line.
  1755. nl_create_func_def_one_liner = false # true/false
  1756.  
  1757. # Whether to split one-line simple unbraced if statements into two lines by
  1758. # adding a newline, as in 'if(b) <here> i++;'.
  1759. nl_split_if_one_liner = false # true/false
  1760.  
  1761. # Whether to split one-line simple unbraced for statements into two lines by
  1762. # adding a newline, as in 'for (...) <here> stmt;'.
  1763. nl_split_for_one_liner = false # true/false
  1764.  
  1765. # Whether to split one-line simple unbraced while statements into two lines by
  1766. # adding a newline, as in 'while (expr) <here> stmt;'.
  1767. nl_split_while_one_liner = false # true/false
  1768.  
  1769. #
  1770. # Blank line options
  1771. #
  1772.  
  1773. # The maximum number of consecutive newlines (3 = 2 blank lines).
  1774. nl_max = 0 # unsigned number
  1775.  
  1776. # The maximum number of consecutive newlines in a function.
  1777. nl_max_blank_in_func = 2 # unsigned number
  1778.  
  1779. # The number of newlines before a function prototype.
  1780. nl_before_func_body_proto = 0 # unsigned number
  1781.  
  1782. # The number of newlines before a multi-line function definition.
  1783. nl_before_func_body_def = 0 # unsigned number
  1784.  
  1785. # The number of newlines before a class constructor/destructor prototype.
  1786. nl_before_func_class_proto = 0 # unsigned number
  1787.  
  1788. # The number of newlines before a class constructor/destructor definition.
  1789. nl_before_func_class_def = 0 # unsigned number
  1790.  
  1791. # The number of newlines after a function prototype.
  1792. nl_after_func_proto = 0 # unsigned number
  1793.  
  1794. # The number of newlines after a function prototype, if not followed by
  1795. # another function prototype.
  1796. nl_after_func_proto_group = 0 # unsigned number
  1797.  
  1798. # The number of newlines after a class constructor/destructor prototype.
  1799. nl_after_func_class_proto = 0 # unsigned number
  1800.  
  1801. # The number of newlines after a class constructor/destructor prototype,
  1802. # if not followed by another constructor/destructor prototype.
  1803. nl_after_func_class_proto_group = 0 # unsigned number
  1804.  
  1805. # Whether one-line method definitions inside a class body should be treated
  1806. # as if they were prototypes for the purposes of adding newlines.
  1807. #
  1808. # Requires nl_class_leave_one_liners=true. Overrides nl_before_func_body_def
  1809. # and nl_before_func_class_def for one-liners.
  1810. nl_class_leave_one_liner_groups = false # true/false
  1811.  
  1812. # The number of newlines after '}' of a multi-line function body.
  1813. nl_after_func_body = 0 # unsigned number
  1814.  
  1815. # The number of newlines after '}' of a multi-line function body in a class
  1816. # declaration. Also affects class constructors/destructors.
  1817. #
  1818. # Overrides nl_after_func_body.
  1819. nl_after_func_body_class = 0 # unsigned number
  1820.  
  1821. # The number of newlines after '}' of a single line function body. Also
  1822. # affects class constructors/destructors.
  1823. #
  1824. # Overrides nl_after_func_body and nl_after_func_body_class.
  1825. nl_after_func_body_one_liner = 0 # unsigned number
  1826.  
  1827. # The minimum number of newlines before a multi-line comment.
  1828. # Doesn't apply if after a brace open or another multi-line comment.
  1829. nl_before_block_comment = 0 # unsigned number
  1830.  
  1831. # The minimum number of newlines before a single-line C comment.
  1832. # Doesn't apply if after a brace open or other single-line C comments.
  1833. nl_before_c_comment = 0 # unsigned number
  1834.  
  1835. # The minimum number of newlines before a CPP comment.
  1836. # Doesn't apply if after a brace open or other CPP comments.
  1837. nl_before_cpp_comment = 0 # unsigned number
  1838.  
  1839. # Whether to force a newline after a multi-line comment.
  1840. nl_after_multiline_comment = false # true/false
  1841.  
  1842. # Whether to force a newline after a label's colon.
  1843. nl_after_label_colon = false # true/false
  1844.  
  1845. # The number of newlines after '}' or ';' of a struct/enum/union definition.
  1846. nl_after_struct = 0 # unsigned number
  1847.  
  1848. # The number of newlines before a class definition.
  1849. nl_before_class = 0 # unsigned number
  1850.  
  1851. # The number of newlines after '}' or ';' of a class definition.
  1852. nl_after_class = 0 # unsigned number
  1853.  
  1854. # The number of newlines before an access specifier label. This also includes
  1855. # the Qt-specific 'signals:' and 'slots:'. Will not change the newline count
  1856. # if after a brace open.
  1857. #
  1858. # 0 = No change (default).
  1859. nl_before_access_spec = 0 # unsigned number
  1860.  
  1861. # The number of newlines after an access specifier label. This also includes
  1862. # the Qt-specific 'signals:' and 'slots:'. Will not change the newline count
  1863. # if after a brace open.
  1864. #
  1865. # 0 = No change (default).
  1866. #
  1867. # Overrides nl_typedef_blk_start and nl_var_def_blk_start.
  1868. nl_after_access_spec = 0 # unsigned number
  1869.  
  1870. # The number of newlines between a function definition and the function
  1871. # comment, as in '// comment\n <here> void foo() {...}'.
  1872. #
  1873. # 0 = No change (default).
  1874. nl_comment_func_def = 0 # unsigned number
  1875.  
  1876. # The number of newlines after a try-catch-finally block that isn't followed
  1877. # by a brace close.
  1878. #
  1879. # 0 = No change (default).
  1880. nl_after_try_catch_finally = 0 # unsigned number
  1881.  
  1882. # (C#) The number of newlines before and after a property, indexer or event
  1883. # declaration.
  1884. #
  1885. # 0 = No change (default).
  1886. nl_around_cs_property = 0 # unsigned number
  1887.  
  1888. # (C#) The number of newlines between the get/set/add/remove handlers.
  1889. #
  1890. # 0 = No change (default).
  1891. nl_between_get_set = 0 # unsigned number
  1892.  
  1893. # (C#) Add or remove newline between property and the '{'.
  1894. nl_property_brace = ignore # ignore/add/remove/force
  1895.  
  1896. # The number of newlines after '{' of a namespace. This also adds newlines
  1897. # before the matching '}'.
  1898. #
  1899. # 0 = Apply eat_blanks_after_open_brace or eat_blanks_before_close_brace if
  1900. # applicable, otherwise no change.
  1901. #
  1902. # Overrides eat_blanks_after_open_brace and eat_blanks_before_close_brace.
  1903. nl_inside_namespace = 0 # unsigned number
  1904.  
  1905. # Whether to remove blank lines after '{'.
  1906. eat_blanks_after_open_brace = false # true/false
  1907.  
  1908. # Whether to remove blank lines before '}'.
  1909. eat_blanks_before_close_brace = false # true/false
  1910.  
  1911. # How aggressively to remove extra newlines not in preprocessor.
  1912. #
  1913. # 0: No change (default)
  1914. # 1: Remove most newlines not handled by other config
  1915. # 2: Remove all newlines and reformat completely by config
  1916. nl_remove_extra_newlines = 0 # unsigned number
  1917.  
  1918. # Whether to put a blank line before 'return' statements, unless after an open
  1919. # brace.
  1920. nl_before_return = true # true/false
  1921.  
  1922. # Whether to put a blank line after 'return' statements, unless followed by a
  1923. # close brace.
  1924. nl_after_return = false # true/false
  1925.  
  1926. # (Java) Add or remove newline after an annotation statement. Only affects
  1927. # annotations that are after a newline.
  1928. nl_after_annotation = ignore # ignore/add/remove/force
  1929.  
  1930. # (Java) Add or remove newline between two annotations.
  1931. nl_between_annotation = ignore # ignore/add/remove/force
  1932.  
  1933. #
  1934. # Positioning options
  1935. #
  1936.  
  1937. # The position of arithmetic operators in wrapped expressions.
  1938. pos_arith = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1939.  
  1940. # The position of assignment in wrapped expressions. Do not affect '='
  1941. # followed by '{'.
  1942. pos_assign = trail # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1943.  
  1944. # The position of Boolean operators in wrapped expressions.
  1945. pos_bool = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1946.  
  1947. # The position of comparison operators in wrapped expressions.
  1948. pos_compare = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1949.  
  1950. # The position of conditional operators, as in the '?' and ':' of
  1951. # 'expr ? stmt : stmt', in wrapped expressions.
  1952. pos_conditional = lead # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1953.  
  1954. # The position of the comma in wrapped expressions.
  1955. pos_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1956.  
  1957. # The position of the comma in enum entries.
  1958. pos_enum_comma = trail # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1959.  
  1960. # The position of the comma in the base class list if there is more than one
  1961. # line. Affects nl_class_init_args.
  1962. pos_class_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1963.  
  1964. # The position of the comma in the constructor initialization list.
  1965. # Related to nl_constr_colon, nl_constr_init_args and pos_constr_colon.
  1966. pos_constr_comma = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1967.  
  1968. # The position of trailing/leading class colon, between class and base class
  1969. # list. Affects nl_class_colon.
  1970. pos_class_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1971.  
  1972. # The position of colons between constructor and member initialization.
  1973. # Related to nl_constr_colon, nl_constr_init_args and pos_constr_comma.
  1974. pos_constr_colon = ignore # ignore/break/force/lead/trail/join/lead_break/lead_force/trail_break/trail_force
  1975.  
  1976. #
  1977. # Line splitting options
  1978. #
  1979.  
  1980. # Try to limit code width to N columns.
  1981. code_width = 80 # unsigned number
  1982.  
  1983. # Whether to fully split long 'for' statements at semi-colons.
  1984. ls_for_split_full = false # true/false
  1985.  
  1986. # Whether to fully split long function prototypes/calls at commas.
  1987. ls_func_split_full = false # true/false
  1988.  
  1989. # Whether to split lines as close to code_width as possible and ignore some
  1990. # groupings.
  1991. ls_code_width = false # true/false
  1992.  
  1993. #
  1994. # Code alignment options (not left column spaces/tabs)
  1995. #
  1996.  
  1997. # Whether to keep non-indenting tabs.
  1998. align_keep_tabs = false # true/false
  1999.  
  2000. # Whether to use tabs for aligning.
  2001. align_with_tabs = false # true/false
  2002.  
  2003. # Whether to bump out to the next tab when aligning.
  2004. align_on_tabstop = false # true/false
  2005.  
  2006. # Whether to right-align numbers.
  2007. align_number_right = false # true/false
  2008.  
  2009. # Whether to keep whitespace not required for alignment.
  2010. align_keep_extra_space = false # true/false
  2011.  
  2012. # Whether to align variable definitions in prototypes and functions.
  2013. align_func_params = false # true/false
  2014.  
  2015. # The span for aligning parameter definitions in function on parameter name.
  2016. #
  2017. # 0 = Don't align (default).
  2018. align_func_params_span = 0 # unsigned number
  2019.  
  2020. # The threshold for aligning function parameter definitions.
  2021. #
  2022. # 0 = No limit (default).
  2023. align_func_params_thresh = 0 # unsigned number
  2024.  
  2025. # The gap for aligning function parameter definitions.
  2026. align_func_params_gap = 0 # unsigned number
  2027.  
  2028. # Whether to align parameters in single-line functions that have the same
  2029. # name. The function names must already be aligned with each other.
  2030. align_same_func_call_params = false # true/false
  2031.  
  2032. # The span for aligning function-call parameters for single line functions.
  2033. #
  2034. # 0 = Don't align (default).
  2035. align_same_func_call_params_span = 0 # unsigned number
  2036.  
  2037. # The threshold for aligning function-call parameters for single line
  2038. # functions.
  2039. #
  2040. # 0 = No limit (default).
  2041. align_same_func_call_params_thresh = 0 # unsigned number
  2042.  
  2043. # The span for aligning variable definitions.
  2044. #
  2045. # 0 = Don't align (default).
  2046. align_var_def_span = 0 # unsigned number
  2047.  
  2048. # How to align the '*' in variable definitions.
  2049. #
  2050. # 0: Part of the type 'void * foo;' (default)
  2051. # 1: Part of the variable 'void *foo;'
  2052. # 2: Dangling 'void *foo;'
  2053. align_var_def_star_style = 1 # unsigned number
  2054.  
  2055. # How to align the '&' in variable definitions.
  2056. #
  2057. # 0: Part of the type 'long & foo;' (default)
  2058. # 1: Part of the variable 'long &foo;'
  2059. # 2: Dangling 'long &foo;'
  2060. align_var_def_amp_style = 1 # unsigned number
  2061.  
  2062. # The threshold for aligning variable definitions.
  2063. #
  2064. # 0 = No limit (default).
  2065. align_var_def_thresh = 0 # unsigned number
  2066.  
  2067. # The gap for aligning variable definitions.
  2068. align_var_def_gap = 0 # unsigned number
  2069.  
  2070. # Whether to align the colon in struct bit fields.
  2071. align_var_def_colon = false # true/false
  2072.  
  2073. # The gap for aligning the colon in struct bit fields.
  2074. align_var_def_colon_gap = 0 # unsigned number
  2075.  
  2076. # Whether to align any attribute after the variable name.
  2077. align_var_def_attribute = false # true/false
  2078.  
  2079. # Whether to align inline struct/enum/union variable definitions.
  2080. align_var_def_inline = false # true/false
  2081.  
  2082. # The span for aligning on '=' in assignments.
  2083. #
  2084. # 0 = Don't align (default).
  2085. align_assign_span = 0 # unsigned number
  2086.  
  2087. # The threshold for aligning on '=' in assignments.
  2088. #
  2089. # 0 = No limit (default).
  2090. align_assign_thresh = 0 # unsigned number
  2091.  
  2092. # How to apply align_assign_span to function declaration "assignments", i.e.
  2093. # 'virtual void foo() = 0' or '~foo() = {default|delete}'.
  2094. #
  2095. # 0: Align with other assignments (default)
  2096. # 1: Align with each other, ignoring regular assignments
  2097. # 2: Don't align
  2098. align_assign_decl_func = 0 # unsigned number
  2099.  
  2100. # The span for aligning on '=' in enums.
  2101. #
  2102. # 0 = Don't align (default).
  2103. align_enum_equ_span = 0 # unsigned number
  2104.  
  2105. # The threshold for aligning on '=' in enums.
  2106. #
  2107. # 0 = no limit (default).
  2108. align_enum_equ_thresh = 0 # unsigned number
  2109.  
  2110. # The span for aligning class member definitions.
  2111. #
  2112. # 0 = Don't align (default).
  2113. align_var_class_span = 0 # unsigned number
  2114.  
  2115. # The threshold for aligning class member definitions.
  2116. #
  2117. # 0 = No limit (default).
  2118. align_var_class_thresh = 0 # unsigned number
  2119.  
  2120. # The gap for aligning class member definitions.
  2121. align_var_class_gap = 0 # unsigned number
  2122.  
  2123. # The span for aligning struct/union member definitions.
  2124. #
  2125. # 0 = Don't align (default).
  2126. align_var_struct_span = 0 # unsigned number
  2127.  
  2128. # The threshold for aligning struct/union member definitions.
  2129. #
  2130. # 0 = No limit (default).
  2131. align_var_struct_thresh = 0 # unsigned number
  2132.  
  2133. # The gap for aligning struct/union member definitions.
  2134. align_var_struct_gap = 0 # unsigned number
  2135.  
  2136. # The span for aligning struct initializer values.
  2137. #
  2138. # 0 = Don't align (default).
  2139. align_struct_init_span = 0 # unsigned number
  2140.  
  2141. # The minimum space between the type and the synonym of a typedef.
  2142. align_typedef_gap = 0 # unsigned number
  2143.  
  2144. # The span for aligning single-line typedefs.
  2145. #
  2146. # 0 = Don't align (default).
  2147. align_typedef_span = 0 # unsigned number
  2148.  
  2149. # How to align typedef'd functions with other typedefs.
  2150. #
  2151. # 0: Don't mix them at all (default)
  2152. # 1: Align the open parenthesis with the types
  2153. # 2: Align the function type name with the other type names
  2154. align_typedef_func = 0 # unsigned number
  2155.  
  2156. # How to align the '*' in typedefs.
  2157. #
  2158. # 0: Align on typedef type, ignore '*' (default)
  2159. # 1: The '*' is part of type name: 'typedef int *pint;'
  2160. # 2: The '*' is part of the type, but dangling: 'typedef int *pint;'
  2161. align_typedef_star_style = 0 # unsigned number
  2162.  
  2163. # How to align the '&' in typedefs.
  2164. #
  2165. # 0: Align on typedef type, ignore '&' (default)
  2166. # 1: The '&' is part of type name: 'typedef int &pint;'
  2167. # 2: The '&' is part of the type, but dangling: 'typedef int &pint;'
  2168. align_typedef_amp_style = 0 # unsigned number
  2169.  
  2170. # The span for aligning comments that end lines.
  2171. #
  2172. # 0 = Don't align (default).
  2173. align_right_cmt_span = 0 # unsigned number
  2174.  
  2175. # If aligning comments, whether to mix with comments after '}' and #endif with
  2176. # less than three spaces before the comment.
  2177. align_right_cmt_mix = false # true/false
  2178.  
  2179. # Whether to only align trailing comments that are at the same brace level.
  2180. align_right_cmt_same_level = false # true/false
  2181.  
  2182. # Minimum number of columns between preceding text and a trailing comment in
  2183. # order for the comment to qualify for being aligned. Must be non-zero to have
  2184. # an effect.
  2185. align_right_cmt_gap = 0 # unsigned number
  2186.  
  2187. # Minimum column at which to align trailing comments. Comments which are
  2188. # aligned beyond this column, but which can be aligned in a lesser column,
  2189. # may be "pulled in".
  2190. #
  2191. # 0 = Ignore (default).
  2192. align_right_cmt_at_col = 0 # unsigned number
  2193.  
  2194. # The span for aligning function prototypes.
  2195. #
  2196. # 0 = Don't align (default).
  2197. align_func_proto_span = 0 # unsigned number
  2198.  
  2199. # Minimum gap between the return type and the function name.
  2200. align_func_proto_gap = 0 # unsigned number
  2201.  
  2202. # Whether to align function prototypes on the 'operator' keyword instead of
  2203. # what follows.
  2204. align_on_operator = false # true/false
  2205.  
  2206. # Whether to mix aligning prototype and variable declarations. If true,
  2207. # align_var_def_XXX options are used instead of align_func_proto_XXX options.
  2208. align_mix_var_proto = false # true/false
  2209.  
  2210. # Whether to align single-line functions with function prototypes.
  2211. # Uses align_func_proto_span.
  2212. align_single_line_func = false # true/false
  2213.  
  2214. # Whether to align the open brace of single-line functions.
  2215. # Requires align_single_line_func=true. Uses align_func_proto_span.
  2216. align_single_line_brace = false # true/false
  2217.  
  2218. # Gap for align_single_line_brace.
  2219. align_single_line_brace_gap = 0 # unsigned number
  2220.  
  2221. # (OC) The span for aligning Objective-C message specifications.
  2222. #
  2223. # 0 = Don't align (default).
  2224. align_oc_msg_spec_span = 0 # unsigned number
  2225.  
  2226. # Whether to align macros wrapped with a backslash and a newline. This will
  2227. # not work right if the macro contains a multi-line comment.
  2228. align_nl_cont = false # true/false
  2229.  
  2230. # Whether to align macro functions and variables together.
  2231. align_pp_define_together = false # true/false
  2232.  
  2233. # The minimum space between label and value of a preprocessor define.
  2234. align_pp_define_gap = 0 # unsigned number
  2235.  
  2236. # The span for aligning on '#define' bodies.
  2237. #
  2238. # =0: Don't align (default)
  2239. # >0: Number of lines (including comments) between blocks
  2240. align_pp_define_span = 0 # unsigned number
  2241.  
  2242. # Whether to align lines that start with '<<' with previous '<<'.
  2243. #
  2244. # Default: true
  2245. align_left_shift = true # true/false
  2246.  
  2247. # Whether to align text after 'asm volatile ()' colons.
  2248. align_asm_colon = false # true/false
  2249.  
  2250. # (OC) Span for aligning parameters in an Objective-C message call
  2251. # on the ':'.
  2252. #
  2253. # 0 = Don't align.
  2254. align_oc_msg_colon_span = 0 # unsigned number
  2255.  
  2256. # (OC) Whether to always align with the first parameter, even if it is too
  2257. # short.
  2258. align_oc_msg_colon_first = false # true/false
  2259.  
  2260. # (OC) Whether to align parameters in an Objective-C '+' or '-' declaration
  2261. # on the ':'.
  2262. align_oc_decl_colon = false # true/false
  2263.  
  2264. #
  2265. # Comment modification options
  2266. #
  2267.  
  2268. # Try to wrap comments at N columns.
  2269. cmt_width = 0 # unsigned number
  2270.  
  2271. # How to reflow comments.
  2272. #
  2273. # 0: No reflowing (apart from the line wrapping due to cmt_width) (default)
  2274. # 1: No touching at all
  2275. # 2: Full reflow
  2276. cmt_reflow_mode = 0 # unsigned number
  2277.  
  2278. # Whether to convert all tabs to spaces in comments. If false, tabs in
  2279. # comments are left alone, unless used for indenting.
  2280. cmt_convert_tab_to_spaces = false # true/false
  2281.  
  2282. # Whether to apply changes to multi-line comments, including cmt_width,
  2283. # keyword substitution and leading chars.
  2284. #
  2285. # Default: true
  2286. cmt_indent_multi = true # true/false
  2287.  
  2288. # Whether to group c-comments that look like they are in a block.
  2289. cmt_c_group = false # true/false
  2290.  
  2291. # Whether to put an empty '/*' on the first line of the combined c-comment.
  2292. cmt_c_nl_start = false # true/false
  2293.  
  2294. # Whether to add a newline before the closing '*/' of the combined c-comment.
  2295. cmt_c_nl_end = false # true/false
  2296.  
  2297. # Whether to change cpp-comments into c-comments.
  2298. cmt_cpp_to_c = false # true/false
  2299.  
  2300. # Whether to group cpp-comments that look like they are in a block. Only
  2301. # meaningful if cmt_cpp_to_c=true.
  2302. cmt_cpp_group = false # true/false
  2303.  
  2304. # Whether to put an empty '/*' on the first line of the combined cpp-comment
  2305. # when converting to a c-comment.
  2306. #
  2307. # Requires cmt_cpp_to_c=true and cmt_cpp_group=true.
  2308. cmt_cpp_nl_start = false # true/false
  2309.  
  2310. # Whether to add a newline before the closing '*/' of the combined cpp-comment
  2311. # when converting to a c-comment.
  2312. #
  2313. # Requires cmt_cpp_to_c=true and cmt_cpp_group=true.
  2314. cmt_cpp_nl_end = false # true/false
  2315.  
  2316. # Whether to put a star on subsequent comment lines.
  2317. cmt_star_cont = false # true/false
  2318.  
  2319. # The number of spaces to insert at the start of subsequent comment lines.
  2320. cmt_sp_before_star_cont = 0 # unsigned number
  2321.  
  2322. # The number of spaces to insert after the star on subsequent comment lines.
  2323. cmt_sp_after_star_cont = 0 # unsigned number
  2324.  
  2325. # For multi-line comments with a '*' lead, remove leading spaces if the first
  2326. # and last lines of the comment are the same length.
  2327. #
  2328. # Default: true
  2329. cmt_multi_check_last = true # true/false
  2330.  
  2331. # For multi-line comments with a '*' lead, remove leading spaces if the first
  2332. # and last lines of the comment are the same length AND if the length is
  2333. # bigger as the first_len minimum.
  2334. #
  2335. # Default: 4
  2336. cmt_multi_first_len_minimum = 4 # unsigned number
  2337.  
  2338. # Path to a file that contains text to insert at the beginning of a file if
  2339. # the file doesn't start with a C/C++ comment. If the inserted text contains
  2340. # '$(filename)', that will be replaced with the current file's name.
  2341. cmt_insert_file_header = "" # string
  2342.  
  2343. # Path to a file that contains text to insert at the end of a file if the
  2344. # file doesn't end with a C/C++ comment. If the inserted text contains
  2345. # '$(filename)', that will be replaced with the current file's name.
  2346. cmt_insert_file_footer = "" # string
  2347.  
  2348. # Path to a file that contains text to insert before a function definition if
  2349. # the function isn't preceded by a C/C++ comment. If the inserted text
  2350. # contains '$(function)', '$(javaparam)' or '$(fclass)', these will be
  2351. # replaced with, respectively, the name of the function, the javadoc '@param'
  2352. # and '@return' stuff, or the name of the class to which the member function
  2353. # belongs.
  2354. cmt_insert_func_header = "" # string
  2355.  
  2356. # Path to a file that contains text to insert before a class if the class
  2357. # isn't preceded by a C/C++ comment. If the inserted text contains '$(class)',
  2358. # that will be replaced with the class name.
  2359. cmt_insert_class_header = "" # string
  2360.  
  2361. # Path to a file that contains text to insert before an Objective-C message
  2362. # specification, if the method isn't preceded by a C/C++ comment. If the
  2363. # inserted text contains '$(message)' or '$(javaparam)', these will be
  2364. # replaced with, respectively, the name of the function, or the javadoc
  2365. # '@param' and '@return' stuff.
  2366. cmt_insert_oc_msg_header = "" # string
  2367.  
  2368. # Whether a comment should be inserted if a preprocessor is encountered when
  2369. # stepping backwards from a function name.
  2370. #
  2371. # Applies to cmt_insert_oc_msg_header, cmt_insert_func_header and
  2372. # cmt_insert_class_header.
  2373. cmt_insert_before_preproc = false # true/false
  2374.  
  2375. # Whether a comment should be inserted if a function is declared inline to a
  2376. # class definition.
  2377. #
  2378. # Applies to cmt_insert_func_header.
  2379. #
  2380. # Default: true
  2381. cmt_insert_before_inlines = true # true/false
  2382.  
  2383. # Whether a comment should be inserted if the function is a class constructor
  2384. # or destructor.
  2385. #
  2386. # Applies to cmt_insert_func_header.
  2387. cmt_insert_before_ctor_dtor = false # true/false
  2388.  
  2389. #
  2390. # Code modifying options (non-whitespace)
  2391. #
  2392.  
  2393. # Add or remove braces on a single-line 'do' statement.
  2394. mod_full_brace_do = add # ignore/add/remove/force
  2395.  
  2396. # Add or remove braces on a single-line 'for' statement.
  2397. mod_full_brace_for = add # ignore/add/remove/force
  2398.  
  2399. # (Pawn) Add or remove braces on a single-line function definition.
  2400. mod_full_brace_function = add # ignore/add/remove/force
  2401.  
  2402. # Add or remove braces on a single-line 'if' statement. Braces will not be
  2403. # removed if the braced statement contains an 'else'.
  2404. mod_full_brace_if = add # ignore/add/remove/force
  2405.  
  2406. # Whether to enforce that all blocks of an 'if'/'else if'/'else' chain either
  2407. # have, or do not have, braces. If true, braces will be added if any block
  2408. # needs braces, and will only be removed if they can be removed from all
  2409. # blocks.
  2410. #
  2411. # Overrides mod_full_brace_if.
  2412. mod_full_brace_if_chain = false # true/false
  2413.  
  2414. # Whether to add braces to all blocks of an 'if'/'else if'/'else' chain.
  2415. # If true, mod_full_brace_if_chain will only remove braces from an 'if' that
  2416. # does not have an 'else if' or 'else'.
  2417. mod_full_brace_if_chain_only = false # true/false
  2418.  
  2419. # Add or remove braces on single-line 'while' statement.
  2420. mod_full_brace_while = ignore # ignore/add/remove/force
  2421.  
  2422. # Add or remove braces on single-line 'using ()' statement.
  2423. mod_full_brace_using = ignore # ignore/add/remove/force
  2424.  
  2425. # Don't remove braces around statements that span N newlines
  2426. mod_full_brace_nl = 0 # unsigned number
  2427.  
  2428. # Whether to prevent removal of braces from 'if'/'for'/'while'/etc. blocks
  2429. # which span multiple lines.
  2430. #
  2431. # Affects:
  2432. # mod_full_brace_for
  2433. # mod_full_brace_if
  2434. # mod_full_brace_if_chain
  2435. # mod_full_brace_if_chain_only
  2436. # mod_full_brace_while
  2437. # mod_full_brace_using
  2438. #
  2439. # Does not affect:
  2440. # mod_full_brace_do
  2441. # mod_full_brace_function
  2442. mod_full_brace_nl_block_rem_mlcond = false # true/false
  2443.  
  2444. # Add or remove unnecessary parenthesis on 'return' statement.
  2445. mod_paren_on_return = ignore # ignore/add/remove/force
  2446.  
  2447. # (Pawn) Whether to change optional semicolons to real semicolons.
  2448. mod_pawn_semicolon = false # true/false
  2449.  
  2450. # Whether to fully parenthesize Boolean expressions in 'while' and 'if'
  2451. # statement, as in 'if (a && b > c)' → 'if (a && (b > c))'.
  2452. mod_full_paren_if_bool = false # true/false
  2453.  
  2454. # Whether to remove superfluous semicolons.
  2455. mod_remove_extra_semicolon = false # true/false
  2456.  
  2457. # If a function body exceeds the specified number of newlines and doesn't have
  2458. # a comment after the close brace, a comment will be added.
  2459. mod_add_long_function_closebrace_comment = 0 # unsigned number
  2460.  
  2461. # If a namespace body exceeds the specified number of newlines and doesn't
  2462. # have a comment after the close brace, a comment will be added.
  2463. mod_add_long_namespace_closebrace_comment = 0 # unsigned number
  2464.  
  2465. # If a class body exceeds the specified number of newlines and doesn't have a
  2466. # comment after the close brace, a comment will be added.
  2467. mod_add_long_class_closebrace_comment = 0 # unsigned number
  2468.  
  2469. # If a switch body exceeds the specified number of newlines and doesn't have a
  2470. # comment after the close brace, a comment will be added.
  2471. mod_add_long_switch_closebrace_comment = 0 # unsigned number
  2472.  
  2473. # If an #ifdef body exceeds the specified number of newlines and doesn't have
  2474. # a comment after the #endif, a comment will be added.
  2475. mod_add_long_ifdef_endif_comment = 0 # unsigned number
  2476.  
  2477. # If an #ifdef or #else body exceeds the specified number of newlines and
  2478. # doesn't have a comment after the #else, a comment will be added.
  2479. mod_add_long_ifdef_else_comment = 0 # unsigned number
  2480.  
  2481. # Whether to sort consecutive single-line 'import' statements.
  2482. mod_sort_import = false # true/false
  2483.  
  2484. # (C#) Whether to sort consecutive single-line 'using' statements.
  2485. mod_sort_using = false # true/false
  2486.  
  2487. # Whether to sort consecutive single-line '#include' statements (C/C++) and
  2488. # '#import' statements (Objective-C). Be aware that this has the potential to
  2489. # break your code if your includes/imports have ordering dependencies.
  2490. mod_sort_include = false # true/false
  2491.  
  2492. # Whether to move a 'break' that appears after a fully braced 'case' before
  2493. # the close brace, as in 'case X: { ... } break;' → 'case X: { ... break; }'.
  2494. mod_move_case_break = false # true/false
  2495.  
  2496. # Add or remove braces around a fully braced case statement. Will only remove
  2497. # braces if there are no variable declarations in the block.
  2498. mod_case_brace = ignore # ignore/add/remove/force
  2499.  
  2500. # Whether to remove a void 'return;' that appears as the last statement in a
  2501. # function.
  2502. mod_remove_empty_return = false # true/false
  2503.  
  2504. # Add or remove the comma after the last value of an enumeration.
  2505. mod_enum_last_comma = ignore # ignore/add/remove/force
  2506.  
  2507. # (OC) Whether to organize the properties. If true, properties will be
  2508. # rearranged according to the mod_sort_oc_property_*_weight factors.
  2509. mod_sort_oc_properties = false # true/false
  2510.  
  2511. # (OC) Weight of a class property modifier.
  2512. mod_sort_oc_property_class_weight = 0 # number
  2513.  
  2514. # (OC) Weight of 'atomic' and 'nonatomic'.
  2515. mod_sort_oc_property_thread_safe_weight = 0 # number
  2516.  
  2517. # (OC) Weight of 'readwrite' when organizing properties.
  2518. mod_sort_oc_property_readwrite_weight = 0 # number
  2519.  
  2520. # (OC) Weight of a reference type specifier ('retain', 'copy', 'assign',
  2521. # 'weak', 'strong') when organizing properties.
  2522. mod_sort_oc_property_reference_weight = 0 # number
  2523.  
  2524. # (OC) Weight of getter type ('getter=') when organizing properties.
  2525. mod_sort_oc_property_getter_weight = 0 # number
  2526.  
  2527. # (OC) Weight of setter type ('setter=') when organizing properties.
  2528. mod_sort_oc_property_setter_weight = 0 # number
  2529.  
  2530. # (OC) Weight of nullability type ('nullable', 'nonnull', 'null_unspecified',
  2531. # 'null_resettable') when organizing properties.
  2532. mod_sort_oc_property_nullability_weight = 0 # number
  2533.  
  2534. #
  2535. # Preprocessor options
  2536. #
  2537.  
  2538. # Add or remove indentation of preprocessor directives inside #if blocks
  2539. # at brace level 0 (file-level).
  2540. pp_indent = ignore # ignore/add/remove/force
  2541.  
  2542. # Whether to indent #if/#else/#endif at the brace level. If false, these are
  2543. # indented from column 1.
  2544. pp_indent_at_level = false # true/false
  2545.  
  2546. # Specifies the number of columns to indent preprocessors per level
  2547. # at brace level 0 (file-level). If pp_indent_at_level=false, also specifies
  2548. # the number of columns to indent preprocessors per level
  2549. # at brace level > 0 (function-level).
  2550. #
  2551. # Default: 1
  2552. pp_indent_count = 1 # unsigned number
  2553.  
  2554. # Add or remove space after # based on pp_level of #if blocks.
  2555. pp_space = ignore # ignore/add/remove/force
  2556.  
  2557. # Sets the number of spaces per level added with pp_space.
  2558. pp_space_count = 0 # unsigned number
  2559.  
  2560. # The indent for '#region' and '#endregion' in C# and '#pragma region' in
  2561. # C/C++. Negative values decrease indent down to the first column.
  2562. pp_indent_region = 0 # number
  2563.  
  2564. # Whether to indent the code between #region and #endregion.
  2565. pp_region_indent_code = false # true/false
  2566.  
  2567. # If pp_indent_at_level=true, sets the indent for #if, #else and #endif when
  2568. # not at file-level. Negative values decrease indent down to the first column.
  2569. #
  2570. # =0: Indent preprocessors using output_tab_size
  2571. # >0: Column at which all preprocessors will be indented
  2572. pp_indent_if = 0 # number
  2573.  
  2574. # Whether to indent the code between #if, #else and #endif.
  2575. pp_if_indent_code = false # true/false
  2576.  
  2577. # Whether to indent '#define' at the brace level. If false, these are
  2578. # indented from column 1.
  2579. pp_define_at_level = false # true/false
  2580.  
  2581. # Whether to ignore the '#define' body while formatting.
  2582. pp_ignore_define_body = false # true/false
  2583.  
  2584. # Whether to indent case statements between #if, #else, and #endif.
  2585. # Only applies to the indent of the preprocesser that the case statements
  2586. # directly inside of.
  2587. #
  2588. # Default: true
  2589. pp_indent_case = true # true/false
  2590.  
  2591. # Whether to indent whole function definitions between #if, #else, and #endif.
  2592. # Only applies to the indent of the preprocesser that the function definition
  2593. # is directly inside of.
  2594. #
  2595. # Default: true
  2596. pp_indent_func_def = true # true/false
  2597.  
  2598. # Whether to indent extern C blocks between #if, #else, and #endif.
  2599. # Only applies to the indent of the preprocesser that the extern block is
  2600. # directly inside of.
  2601. #
  2602. # Default: true
  2603. pp_indent_extern = true # true/false
  2604.  
  2605. # Whether to indent braces directly inside #if, #else, and #endif.
  2606. # Only applies to the indent of the preprocesser that the braces are directly
  2607. # inside of.
  2608. #
  2609. # Default: true
  2610. pp_indent_brace = true # true/false
  2611.  
  2612. #
  2613. # Sort includes options
  2614. #
  2615.  
  2616. # The regex for include category with priority 0.
  2617. include_category_0 = "" # string
  2618.  
  2619. # The regex for include category with priority 1.
  2620. include_category_1 = "" # string
  2621.  
  2622. # The regex for include category with priority 2.
  2623. include_category_2 = "" # string
  2624.  
  2625. #
  2626. # Use or Do not Use options
  2627. #
  2628.  
  2629. # true: indent_func_call_param will be used (default)
  2630. # false: indent_func_call_param will NOT be used
  2631. #
  2632. # Default: true
  2633. use_indent_func_call_param = true # true/false
  2634.  
  2635. # The value of the indentation for a continuation line is calculated
  2636. # differently if the statement is:
  2637. # - a declaration: your case with QString fileName ...
  2638. # - an assignment: your case with pSettings = new QSettings( ...
  2639. #
  2640. # At the second case the indentation value might be used twice:
  2641. # - at the assignment
  2642. # - at the function call (if present)
  2643. #
  2644. # To prevent the double use of the indentation value, use this option with the
  2645. # value 'true'.
  2646. #
  2647. # true: indent_continue will be used only once
  2648. # false: indent_continue will be used every time (default)
  2649. use_indent_continue_only_once = true # true/false
  2650.  
  2651. # The value might be used twice:
  2652. # - at the assignment
  2653. # - at the opening brace
  2654. #
  2655. # To prevent the double use of the indentation value, use this option with the
  2656. # value 'true'.
  2657. #
  2658. # true: indentation will be used only once
  2659. # false: indentation will be used every time (default)
  2660. indent_cpp_lambda_only_once = true # true/false
  2661.  
  2662. # Whether to apply special formatting for Qt SIGNAL/SLOT macros. Essentially,
  2663. # this tries to format these so that they match Qt's normalized form (i.e. the
  2664. # result of QMetaObject::normalizedSignature), which can slightly improve the
  2665. # performance of the QObject::connect call, rather than how they would
  2666. # otherwise be formatted.
  2667. #
  2668. # See options_for_QT.cpp for details.
  2669. #
  2670. # Default: true
  2671. use_options_overriding_for_qt_macros = true # true/false
  2672.  
  2673. #
  2674. # Warn levels - 1: error, 2: warning (default), 3: note
  2675. #
  2676.  
  2677. # (C#) Warning is given if doing tab-to-\t replacement and we have found one
  2678. # in a C# verbatim string literal.
  2679. #
  2680. # Default: 2
  2681. warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number
  2682.  
  2683. # Meaning of the settings:
  2684. # Ignore - do not do any changes
  2685. # Add - makes sure there is 1 or more space/brace/newline/etc
  2686. # Force - makes sure there is exactly 1 space/brace/newline/etc,
  2687. # behaves like Add in some contexts
  2688. # Remove - removes space/brace/newline/etc
  2689. #
  2690. #
  2691. # - Token(s) can be treated as specific type(s) with the 'set' option:
  2692. # `set tokenType tokenString [tokenString...]`
  2693. #
  2694. # Example:
  2695. # `set BOOL __AND__ __OR__`
  2696. #
  2697. # tokenTypes are defined in src/token_enum.h, use them without the
  2698. # 'CT_' prefix: 'CT_BOOL' → 'BOOL'
  2699. #
  2700. #
  2701. # - Token(s) can be treated as type(s) with the 'type' option.
  2702. # `type tokenString [tokenString...]`
  2703. #
  2704. # Example:
  2705. # `type int c_uint_8 Rectangle`
  2706. #
  2707. # This can also be achieved with `set TYPE int c_uint_8 Rectangle`
  2708. #
  2709. #
  2710. # To embed whitespace in tokenStrings use the '\' escape character, or quote
  2711. # the tokenStrings. These quotes are supported: "'`
  2712. #
  2713. #
  2714. # - Support for the auto detection of languages through the file ending can be
  2715. # added using the 'file_ext' command.
  2716. # `file_ext langType langString [langString..]`
  2717. #
  2718. # Example:
  2719. # `file_ext CPP .ch .cxx .cpp.in`
  2720. #
  2721. # langTypes are defined in uncrusify_types.h in the lang_flag_e enum, use
  2722. # them without the 'LANG_' prefix: 'LANG_CPP' → 'CPP'
  2723. #
  2724. #
  2725. # - Custom macro-based indentation can be set up using 'macro-open',
  2726. # 'macro-else' and 'macro-close'.
  2727. # `(macro-open | macro-else | macro-close) tokenString`
  2728. #
  2729. # Example:
  2730. # `macro-open BEGIN_TEMPLATE_MESSAGE_MAP`
  2731. # `macro-open BEGIN_MESSAGE_MAP`
  2732. # `macro-close END_MESSAGE_MAP`
  2733. #
  2734. #
  2735. # option(s) with 'not default' value: 0
  2736. #
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement