uncrustify.cfg 120 KB

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