Exclude doc blocks with problematic Doxygen commands from autowrapping.

facebookresearch · Oct 6, 2022 · ab361b9 · ab361b9
1 parent eae4af0
commit ab361b9
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/.clang-format b/.clang-format
@@ -46,7 +46,10 @@ BreakConstructorInitializers: BeforeColon
 BreakAfterJavaFieldAnnotations: false
 BreakStringLiterals: true
 ColumnLimit:     80
-CommentPragmas:  '^ IWYU pragma:'
+# Doc block @ref and @section commands often cause Doxygen parsing bugs if
+# wrapped on multiple lines. If a comment contains them, it's not formatted in
+# any way.
+CommentPragmas:  '(^ IWYU pragma:|@ref|@section)'
 CompactNamespaces: false
 ConstructorInitializerAllOnOneLineOrOnePerLine: true
 ConstructorInitializerIndentWidth: 4