|
1 | | -## This config file is only relevant for clang-format version 8.0.0 |
| 1 | +## This config file is only relevant for clang-format version 19.1.7 |
2 | 2 | ## |
3 | 3 | ## Examples of each format style can be found on the in the clang-format documentation |
4 | 4 | ## See: https://clang.llvm.org/docs/ClangFormatStyleOptions.html for details of each option |
|
10 | 10 | ## maintaining a consistent code style. |
11 | 11 | ## |
12 | 12 | ## EXAMPLE apply code style enforcement before commit: |
13 | | -# Utilities/Maintenance/clang-format.bash --clang ${PATH_TO_CLANG_FORMAT_8.0.0} --modified |
| 13 | +# Utilities/Maintenance/clang-format.bash --clang ${PATH_TO_CLANG_FORMAT_19.1.7} --modified |
14 | 14 | ## EXAMPLE apply code style enforcement after commit: |
15 | | -# Utilities/Maintenance/clang-format.bash --clang ${PATH_TO_CLANG_FORMAT_8.0.0} --last |
| 15 | +# Utilities/Maintenance/clang-format.bash --clang ${PATH_TO_CLANG_FORMAT_19.1.7} --last |
16 | 16 | --- |
17 | | -# This configuration requires clang-format version 8.0.0 exactly. |
18 | | -BasedOnStyle: Mozilla |
| 17 | +# This configuration requires clang-format version 19.1.7 exactly. |
19 | 18 | Language: Cpp |
20 | 19 | AccessModifierOffset: -2 |
21 | 20 | AlignAfterOpenBracket: Align |
22 | | -AlignConsecutiveAssignments: false |
23 | | -AlignConsecutiveDeclarations: true |
24 | | -AlignEscapedNewlines: Right |
25 | | -AlignOperands: true |
26 | | -AlignTrailingComments: true |
27 | | -# clang 9.0 AllowAllArgumentsOnNextLine: true |
28 | | -# clang 9.0 AllowAllConstructorInitializersOnNextLine: true |
| 21 | +AlignArrayOfStructures: None |
| 22 | +AlignConsecutiveAssignments: |
| 23 | + Enabled: false |
| 24 | + AcrossEmptyLines: false |
| 25 | + AcrossComments: false |
| 26 | + AlignCompound: false |
| 27 | + AlignFunctionPointers: false |
| 28 | + PadOperators: true |
| 29 | +AlignConsecutiveBitFields: |
| 30 | + Enabled: false |
| 31 | + AcrossEmptyLines: false |
| 32 | + AcrossComments: false |
| 33 | + AlignCompound: false |
| 34 | + AlignFunctionPointers: false |
| 35 | + PadOperators: false |
| 36 | +AlignConsecutiveDeclarations: |
| 37 | + Enabled: true |
| 38 | + AcrossEmptyLines: false |
| 39 | + AcrossComments: false |
| 40 | + AlignCompound: false |
| 41 | + AlignFunctionPointers: false |
| 42 | + PadOperators: true |
| 43 | +AlignConsecutiveMacros: |
| 44 | + Enabled: false |
| 45 | + AcrossEmptyLines: false |
| 46 | + AcrossComments: false |
| 47 | + AlignCompound: false |
| 48 | + AlignFunctionPointers: false |
| 49 | + PadOperators: false |
| 50 | +AlignConsecutiveShortCaseStatements: |
| 51 | + Enabled: false |
| 52 | + AcrossEmptyLines: false |
| 53 | + AcrossComments: false |
| 54 | + AlignCaseArrows: false |
| 55 | + AlignCaseColons: false |
| 56 | +AlignConsecutiveTableGenBreakingDAGArgColons: |
| 57 | + Enabled: false |
| 58 | + AcrossEmptyLines: false |
| 59 | + AcrossComments: false |
| 60 | + AlignCompound: false |
| 61 | + AlignFunctionPointers: false |
| 62 | + PadOperators: false |
| 63 | +AlignConsecutiveTableGenCondOperatorColons: |
| 64 | + Enabled: false |
| 65 | + AcrossEmptyLines: false |
| 66 | + AcrossComments: false |
| 67 | + AlignCompound: false |
| 68 | + AlignFunctionPointers: false |
| 69 | + PadOperators: false |
| 70 | +AlignConsecutiveTableGenDefinitionColons: |
| 71 | + Enabled: false |
| 72 | + AcrossEmptyLines: false |
| 73 | + AcrossComments: false |
| 74 | + AlignCompound: false |
| 75 | + AlignFunctionPointers: false |
| 76 | + PadOperators: false |
| 77 | +AlignEscapedNewlines: Left |
| 78 | +AlignOperands: Align |
| 79 | +AlignTrailingComments: |
| 80 | + Kind: Always |
| 81 | + OverEmptyLines: 0 |
| 82 | +AllowAllArgumentsOnNextLine: true |
29 | 83 | AllowAllParametersOfDeclarationOnNextLine: false |
30 | | -AllowShortBlocksOnASingleLine: false |
| 84 | +AllowBreakBeforeNoexceptSpecifier: Never |
| 85 | +AllowShortBlocksOnASingleLine: Never |
| 86 | +AllowShortCaseExpressionOnASingleLine: true |
31 | 87 | AllowShortCaseLabelsOnASingleLine: false |
32 | | -AllowShortFunctionsOnASingleLine: Inline |
33 | | -# clang 9.0 AllowShortLambdasOnASingleLine: All |
34 | | -# clang 9.0 features AllowShortIfStatementsOnASingleLine: Never |
35 | | -AllowShortIfStatementsOnASingleLine: false |
| 88 | +AllowShortCompoundRequirementOnASingleLine: true |
| 89 | +AllowShortEnumsOnASingleLine: true |
| 90 | +#AllowShortFunctionsOnASingleLine: Inline Only merge functions defined inside a class. Implies empty. |
| 91 | +#AllowShortFunctionsOnASingleLine: None (in configuration: None) Never merge functions into a single line. |
| 92 | +AllowShortFunctionsOnASingleLine: All |
| 93 | +AllowShortIfStatementsOnASingleLine: Never |
| 94 | +AllowShortLambdasOnASingleLine: All |
36 | 95 | AllowShortLoopsOnASingleLine: false |
37 | 96 | AlwaysBreakAfterDefinitionReturnType: None |
38 | | -AlwaysBreakAfterReturnType: All |
39 | 97 | AlwaysBreakBeforeMultilineStrings: false |
40 | | -AlwaysBreakTemplateDeclarations: Yes |
| 98 | +AttributeMacros: |
| 99 | + - __capability |
41 | 100 | BinPackArguments: false |
42 | 101 | BinPackParameters: false |
43 | | -BreakBeforeBraces: Custom |
| 102 | +BitFieldColonSpacing: Both |
44 | 103 | BraceWrapping: |
45 | | - # clang 9.0 feature AfterCaseLabel: false |
| 104 | + AfterCaseLabel: true |
46 | 105 | AfterClass: true |
47 | | - AfterControlStatement: true |
| 106 | + AfterControlStatement: Always |
48 | 107 | AfterEnum: true |
| 108 | + AfterExternBlock: true |
49 | 109 | AfterFunction: true |
50 | 110 | AfterNamespace: true |
51 | 111 | AfterObjCDeclaration: true |
52 | 112 | AfterStruct: true |
53 | 113 | AfterUnion: true |
54 | | - AfterExternBlock: true |
55 | 114 | BeforeCatch: true |
56 | 115 | BeforeElse: true |
57 | | -## This is the big change from historical ITK formatting! |
58 | | -# Historically ITK used a style similar to https://en.wikipedia.org/wiki/Indentation_style#Whitesmiths_style |
59 | | -# with indented braces, and not indented code. This style is very difficult to automatically |
60 | | -# maintain with code beautification tools. Not indenting braces is more common among |
61 | | -# formatting tools. |
| 116 | + BeforeLambdaBody: false |
| 117 | + BeforeWhile: false |
62 | 118 | IndentBraces: false |
63 | 119 | SplitEmptyFunction: false |
64 | 120 | SplitEmptyRecord: false |
65 | 121 | SplitEmptyNamespace: false |
| 122 | +BreakAdjacentStringLiterals: true |
| 123 | +BreakAfterAttributes: Leave |
| 124 | +BreakAfterJavaFieldAnnotations: false |
| 125 | +BreakAfterReturnType: All |
| 126 | +BreakArrays: true |
66 | 127 | BreakBeforeBinaryOperators: None |
67 | | -#clang 6.0 BreakBeforeInheritanceComma: true |
68 | | -BreakInheritanceList: BeforeComma |
| 128 | +BreakBeforeConceptDeclarations: Always |
| 129 | +BreakBeforeBraces: Custom |
| 130 | +BreakBeforeInlineASMColon: OnlyMultiline |
69 | 131 | BreakBeforeTernaryOperators: true |
70 | | -#clang 6.0 BreakConstructorInitializersBeforeComma: true |
71 | 132 | BreakConstructorInitializers: BeforeComma |
72 | | -BreakAfterJavaFieldAnnotations: false |
| 133 | +BreakFunctionDefinitionParameters: false |
| 134 | +BreakInheritanceList: BeforeComma |
73 | 135 | BreakStringLiterals: true |
| 136 | +BreakTemplateDeclarations: Yes |
74 | 137 | ## The following line allows larger lines in non-documentation code |
75 | 138 | ColumnLimit: 120 |
76 | 139 | CommentPragmas: '^ IWYU pragma:' |
77 | 140 | CompactNamespaces: false |
78 | | -ConstructorInitializerAllOnOneLineOrOnePerLine: false |
79 | 141 | ConstructorInitializerIndentWidth: 2 |
80 | 142 | ContinuationIndentWidth: 2 |
81 | 143 | Cpp11BracedListStyle: false |
82 | 144 | DerivePointerAlignment: false |
83 | 145 | DisableFormat: false |
| 146 | +EmptyLineAfterAccessModifier: Never |
| 147 | +EmptyLineBeforeAccessModifier: LogicalBlock |
84 | 148 | ExperimentalAutoDetectBinPacking: false |
85 | 149 | FixNamespaceComments: true |
86 | 150 | ForEachMacros: |
87 | 151 | - foreach |
88 | 152 | - Q_FOREACH |
89 | 153 | - BOOST_FOREACH |
| 154 | +IfMacros: |
| 155 | + - KJ_IF_MAYBE |
90 | 156 | IncludeBlocks: Preserve |
91 | 157 | IncludeCategories: |
92 | 158 | - Regex: '^"(llvm|llvm-c|clang|clang-c)/' |
93 | 159 | Priority: 2 |
| 160 | + SortPriority: 0 |
| 161 | + CaseSensitive: false |
94 | 162 | - Regex: '^(<|"(gtest|gmock|isl|json)/)' |
95 | 163 | Priority: 3 |
| 164 | + SortPriority: 0 |
| 165 | + CaseSensitive: false |
96 | 166 | - Regex: '.*' |
97 | 167 | Priority: 1 |
| 168 | + SortPriority: 0 |
| 169 | + CaseSensitive: false |
98 | 170 | IncludeIsMainRegex: '(Test)?$' |
| 171 | +IncludeIsMainSourceRegex: '' |
| 172 | +IndentAccessModifiers: false |
| 173 | +IndentCaseBlocks: false |
99 | 174 | IndentCaseLabels: true |
| 175 | +IndentExternBlock: AfterExternBlock |
| 176 | +IndentGotoLabels: true |
100 | 177 | IndentPPDirectives: AfterHash |
| 178 | +IndentRequiresClause: true |
101 | 179 | IndentWidth: 2 |
102 | 180 | IndentWrappedFunctionNames: false |
| 181 | +InsertBraces: false |
| 182 | +InsertNewlineAtEOF: false |
| 183 | +InsertTrailingCommas: None |
| 184 | +IntegerLiteralSeparator: |
| 185 | + Binary: 0 |
| 186 | + BinaryMinDigits: 0 |
| 187 | + Decimal: 0 |
| 188 | + DecimalMinDigits: 0 |
| 189 | + Hex: 0 |
| 190 | + HexMinDigits: 0 |
103 | 191 | JavaScriptQuotes: Leave |
104 | 192 | JavaScriptWrapImports: true |
105 | | -KeepEmptyLinesAtTheStartOfBlocks: true |
| 193 | +KeepEmptyLines: |
| 194 | + AtEndOfFile: false |
| 195 | + AtStartOfBlock: true |
| 196 | + AtStartOfFile: true |
| 197 | +LambdaBodyIndentation: Signature |
| 198 | +LineEnding: DeriveLF |
106 | 199 | MacroBlockBegin: '' |
107 | 200 | MacroBlockEnd: '' |
| 201 | +MainIncludeChar: Quote |
108 | 202 | MaxEmptyLinesToKeep: 2 |
109 | 203 | NamespaceIndentation: None |
110 | 204 | ObjCBinPackProtocolList: Auto |
111 | 205 | ObjCBlockIndentWidth: 2 |
| 206 | +ObjCBreakBeforeNestedBlockParam: true |
112 | 207 | ObjCSpaceAfterProperty: true |
113 | 208 | ObjCSpaceBeforeProtocolList: false |
| 209 | +PackConstructorInitializers: BinPack |
114 | 210 | PenaltyBreakAssignment: 2 |
115 | 211 | PenaltyBreakBeforeFirstCallParameter: 19 |
116 | 212 | PenaltyBreakComment: 300 |
117 | 213 | ## The following line allows larger lines in non-documentation code |
118 | 214 | PenaltyBreakFirstLessLess: 120 |
| 215 | +PenaltyBreakOpenParenthesis: 0 |
| 216 | +PenaltyBreakScopeResolution: 500 |
119 | 217 | PenaltyBreakString: 1000 |
120 | 218 | PenaltyBreakTemplateDeclaration: 10 |
121 | 219 | PenaltyExcessCharacter: 1000000 |
| 220 | +PenaltyIndentedWhitespace: 0 |
122 | 221 | PenaltyReturnTypeOnItsOwnLine: 200 |
123 | 222 | PointerAlignment: Middle |
| 223 | +PPIndentWidth: -1 |
| 224 | +QualifierAlignment: Custom |
| 225 | +QualifierOrder: |
| 226 | + - friend |
| 227 | + - static |
| 228 | + - inline |
| 229 | + - constexpr |
| 230 | + - const |
| 231 | + - type |
| 232 | +ReferenceAlignment: Pointer |
124 | 233 | ReflowComments: true |
| 234 | +RemoveBracesLLVM: false |
| 235 | +RemoveParentheses: Leave |
| 236 | +RemoveSemicolon: false |
| 237 | +RequiresClausePosition: OwnLine |
| 238 | +RequiresExpressionIndentation: OuterScope |
| 239 | +SeparateDefinitionBlocks: Leave |
| 240 | +ShortNamespaceLines: 1 |
| 241 | +SkipMacroDefinitionBody: false |
125 | 242 | # We may want to sort the includes as a separate pass |
126 | | -SortIncludes: false |
| 243 | +SortIncludes: Never |
| 244 | +SortJavaStaticImport: Before |
127 | 245 | # We may want to revisit this later |
128 | | -SortUsingDeclarations: false |
| 246 | +SortUsingDeclarations: Never |
129 | 247 | SpaceAfterCStyleCast: false |
130 | | -# SpaceAfterLogicalNot: false |
| 248 | +SpaceAfterLogicalNot: false |
131 | 249 | SpaceAfterTemplateKeyword: true |
| 250 | +SpaceAroundPointerQualifiers: Default |
132 | 251 | SpaceBeforeAssignmentOperators: true |
| 252 | +SpaceBeforeCaseColon: false |
133 | 253 | SpaceBeforeCpp11BracedList: false |
134 | 254 | SpaceBeforeCtorInitializerColon: true |
135 | 255 | SpaceBeforeInheritanceColon: true |
| 256 | +SpaceBeforeJsonColon: false |
136 | 257 | SpaceBeforeParens: ControlStatements |
| 258 | +SpaceBeforeParensOptions: |
| 259 | + AfterControlStatements: true |
| 260 | + AfterForeachMacros: true |
| 261 | + AfterFunctionDefinitionName: false |
| 262 | + AfterFunctionDeclarationName: false |
| 263 | + AfterIfMacros: true |
| 264 | + AfterOverloadedOperator: false |
| 265 | + AfterPlacementOperator: true |
| 266 | + AfterRequiresInClause: false |
| 267 | + AfterRequiresInExpression: false |
| 268 | + BeforeNonEmptyParentheses: false |
137 | 269 | SpaceBeforeRangeBasedForLoopColon: true |
138 | | -SpaceInEmptyParentheses: false |
| 270 | +SpaceBeforeSquareBrackets: false |
| 271 | +SpaceInEmptyBlock: false |
139 | 272 | SpacesBeforeTrailingComments: 1 |
140 | | -SpacesInAngles: false |
| 273 | +SpacesInAngles: Never |
141 | 274 | SpacesInContainerLiterals: false |
142 | | -SpacesInCStyleCastParentheses: false |
143 | | -SpacesInParentheses: false |
| 275 | +SpacesInLineCommentPrefix: |
| 276 | + Minimum: 1 |
| 277 | + Maximum: -1 |
| 278 | +SpacesInParens: Never |
| 279 | +SpacesInParensOptions: |
| 280 | + ExceptDoubleParentheses: false |
| 281 | + InCStyleCasts: false |
| 282 | + InConditionalStatements: false |
| 283 | + InEmptyParentheses: false |
| 284 | + Other: false |
144 | 285 | SpacesInSquareBrackets: false |
145 | | -Standard: Cpp11 |
| 286 | +Standard: Latest |
| 287 | +StatementAttributeLikeMacros: |
| 288 | + - Q_EMIT |
146 | 289 | StatementMacros: |
147 | 290 | - Q_UNUSED |
148 | 291 | - QT_REQUIRE_VERSION |
| 292 | + - ITK_GCC_PRAGMA_PUSH |
| 293 | + - ITK_GCC_PRAGMA_POP |
| 294 | + - ITK_GCC_SUPPRESS_Wfloat_equal |
| 295 | + - ITK_GCC_SUPPRESS_Wformat_nonliteral |
| 296 | + - ITK_GCC_SUPPRESS_Warray_bounds |
| 297 | + - ITK_CLANG_PRAGMA_PUSH |
| 298 | + - ITK_CLANG_PRAGMA_POP |
| 299 | + - ITK_CLANG_SUPPRESS_Wzero_as_null_pointer_constant |
| 300 | + - CLANG_PRAGMA_PUSH |
| 301 | + - CLANG_PRAGMA_POP |
| 302 | + - CLANG_SUPPRESS_Wfloat_equal |
| 303 | + - INTEL_PRAGMA_WARN_PUSH |
| 304 | + - INTEL_PRAGMA_WARN_POP |
| 305 | + - INTEL_SUPPRESS_warning_1292 |
| 306 | + - itkTemplateFloatingToIntegerMacro |
| 307 | + - itkLegacyMacro |
| 308 | +TableGenBreakInsideDAGArg: DontBreak |
149 | 309 | TabWidth: 2 |
150 | 310 | UseTab: Never |
| 311 | +VerilogBreakBetweenInstancePorts: true |
| 312 | +WhitespaceSensitiveMacros: |
| 313 | + - BOOST_PP_STRINGIZE |
| 314 | + - CF_SWIFT_NAME |
| 315 | + - NS_SWIFT_NAME |
| 316 | + - PP_STRINGIZE |
| 317 | + - STRINGIZE |
151 | 318 | ... |
0 commit comments