[clang-format][docs] Regenerate ClangFormatStyleOptions.rst

[kuzkry]

Summary

Misalignment of clang/docs/ClangFormatStyleOptions.rst and
clang/include/clang/Format/Format.h was introduced in c24b3db45.

Regenerated with:
python clang/docs/tools/dump_format_style.py

[kuzkry]

@sstwcw, I think you must have forgotten to regenerate the rst file :) I added you as a reviewer to this revision.

[sstwcw]

Yes. I probably forgot to generate the doc. Thank you.

[kuzkry]

I removed @MyDeveloperDay, as this is a trivial PR and already got 3 approvals.

Anyway, could someone please deliver this one for me? My name and email in git format is "Krystian Kuzniarek <[e-mail]>"

[MyDeveloperDay]

clang/docs/ClangFormatStyleOptions.rst

361

Is this wider than 80 chars?

[sstwcw]

clang/docs/ClangFormatStyleOptions.rst

361

The comment in the source code is within 80 columns. The python script prepended the option name. It's the same case as line 1541.

[curdeius]

clang/docs/ClangFormatStyleOptions.rst

361

It is indeed. But it was already longer than 80 chars.
I'll have a look at the script to see how to fix this.

[curdeius]

clang/docs/ClangFormatStyleOptions.rst

361

At the same time, does it really matter if it's auto-generated?

[owenpan]

clang/docs/ClangFormatStyleOptions.rst

361

It should not matter, especially because it’s also a non-source file.

[MyDeveloperDay]

clang/docs/ClangFormatStyleOptions.rst

361

I seem to remember once before I made a change to clang-tidy and they liked the rst to be no wider than 80 chars, but that might have been hand generated rst. If I remember rightly @Eugene.Zelenko picked me up on it, So I actually developed a script (which never landed) that checks the rst for me. D55523: [clang-tidy] Linting .rst documentation

I still use this from time to time and try and clean up.

Checking docs/ClangFormatStyleOptions.rst...
warning: line 9 title and markup non matching lengths
warning: line 21 multiple blank lines
warning: line 35 maximize 80 characters by joining:'[When using ``-style=file:<format_file_path>``, :program:`clang-format` for]' and '[each...]

warning: line 36 maximize 80 characters by joining:'[each input file will use the format file located at `<format_file_path>`.]' and '[The...]

warning: line 103 multiple blank lines
warning: line 121 multiple blank lines
warning: line 130 multiple blank lines
warning: line 139 multiple blank lines
warning: line 181 maximize 80 characters by joining:'[**AccessModifierOffset** (``Integer``) :versionbadge:`clang-format 3.3`]' and '[The...]

warning: line 184 is in excess of 80 characters (87) : **AlignAfterOpenBracket** (``BracketAlignmentStyle``) :versionbadge:`clang-format 3.8`
...
warning: line 228 multiple blank lines
warning: line 229 trailing whitespace
warning: line 233 multiple blank lines
warning: line 234 multiple blank lines
warning: line 235 is in excess of 80 characters (96) : **AlignArrayOfStructures** (``ArrayInitializerAlignmentStyle``) :versionbadge:`clang-format 13`
...
warning: line 236 maximize 80 characters by joining:'[  if not ``None``, when using initialization for an array of structs]' and '[aligns...]

warning: line 251 contains double spaces
warning: line 253 contains double spaces
warning: line 263 contains double spaces
warning: line 265 contains double spaces
warning: line 271 multiple blank lines
warning: line 272 multiple blank lines
warning: line 273 is in excess of 80 characters (93) : **AlignConsecutiveAssignments** (``AlignConsecutiveStyle``) :versionbadge:`clang-format 3.8`
...
warning: line 280 contains double spaces
warning: line 282 contains double spaces
warning: line 295 maximize 80 characters by joining:'[  For example, to align across empty lines and not across comments, either]' and '[of...]

warning: line 311 contains double spaces
warning: line 312 contains double spaces
warning: line 314 contains double spaces
warning: line 315 contains double spaces
warning: line 317 contains double spaces
warning: line 319 contains double spaces
warning: line 322 contains double spaces
warning: line 323 contains double spaces
warning: line 325 contains double spaces
warning: line 326 contains double spaces
warning: line 334 contains double spaces
warning: line 336 contains double spaces
warning: line 338 contains double spaces
warning: line 341 contains double spaces
warning: line 343 contains double spaces
warning: line 352 contains double spaces
warning: line 361 contains double spaces
warning: line 367 contains double spaces
warning: line 368 contains double spaces
warning: line 374 contains double spaces
warning: line 381 contains double spaces
warning: line 382 contains double spaces
warning: line 384 contains double spaces
warning: line 391 contains double spaces
warning: line 394 multiple blank lines
warning: line 395 is in excess of 80 characters (90) : **AlignConsecutiveBitFields** (``AlignConsecutiveStyle``) :versionbadge:`clang-format 11`
...
warning: line 398 maximize 80 characters by joining:'[  ``Consecutive`` will align the bitfield separators of consecutive lines.]' and '[This...]

warning: line 404 contains double spaces
warning: line 405 contains double spaces
warning: line 418 maximize 80 characters by joining:'[  For example, to align across empty lines and not across comments, either]' and '[of...]

warning: line 434 contains double spaces
warning: line 435 contains double spaces
warning: line 437 contains double spaces
warning: line 438 contains double spaces
warning: line 440 contains double spaces
warning: line 442 contains double spaces
warning: line 445 contains double spaces
warning: line 446 contains double spaces
warning: line 448 contains double spaces
warning: line 449 contains double spaces
warning: line 457 contains double spaces
warning: line 459 contains double spaces
warning: line 461 contains double spaces
warning: line 464 contains double spaces
warning: line 466 contains double spaces
warning: line 475 contains double spaces
warning: line 484 contains double spaces
warning: line 490 contains double spaces
warning: line 491 contains double spaces
warning: line 497 contains double spaces
warning: line 504 contains double spaces
warning: line 505 contains double spaces
warning: line 507 contains double spaces
warning: line 514 contains double spaces
warning: line 517 multiple blank lines
warning: line 518 is in excess of 80 characters (94) : **AlignConsecutiveDeclarations** (``AlignConsecutiveStyle``) :versionbadge:`clang-format 3.8`
...
warning: line 521 maximize 80 characters by joining:'[  ``Consecutive`` will align the declaration names of consecutive lines.]' and '[This...]

warning: line 526 contains double spaces
warning: line 527 contains double spaces
warning: line 541 maximize 80 characters by joining:'[  For example, to align across empty lines and not across comments, either]' and '[of...]

warning: line 557 contains double spaces
warning: line 558 contains double spaces
warning: line 560 contains double spaces
warning: line 561 contains double spaces
warning: line 563 contains double spaces
warning: line 565 contains double spaces
warning: line 568 contains double spaces
warning: line 569 contains double spaces
warning: line 571 contains double spaces
warning: line 572 contains double spaces
warning: line 580 contains double spaces
warning: line 582 contains double spaces
warning: line 584 contains double spaces
warning: line 587 contains double spaces
warning: line 589 contains double spaces
warning: line 598 contains double spaces
warning: line 607 contains double spaces
warning: line 613 contains double spaces
warning: line 614 contains double spaces
warning: line 620 contains double spaces
warning: line 627 contains double spaces
warning: line 628 contains double spaces
warning: line 630 contains double spaces
warning: line 637 contains double spaces
warning: line 640 multiple blank lines
warning: line 641 is in excess of 80 characters (86) : **AlignConsecutiveMacros** (``AlignConsecutiveStyle``) :versionbadge:`clang-format 9`
...
warning: line 648 contains double spaces
warning: line 649 contains double spaces
warning: line 651 contains double spaces
warning: line 652 contains double spaces
warning: line 665 maximize 80 characters by joining:'[  For example, to align across empty lines and not across comments, either]' and '[of...]

warning: line 681 contains double spaces
warning: line 682 contains double spaces
warning: line 684 contains double spaces
warning: line 685 contains double spaces
warning: line 687 contains double spaces
warning: line 689 contains double spaces
warning: line 692 contains double spaces
warning: line 693 contains double spaces
warning: line 695 contains double spaces
warning: line 696 contains double spaces
warning: line 704 contains double spaces
warning: line 706 contains double spaces
warning: line 708 contains double spaces
warning: line 711 contains double spaces
warning: line 713 contains double spaces
warning: line 722 contains double spaces
warning: line 731 contains double spaces
warning: line 737 contains double spaces
warning: line 738 contains double spaces
warning: line 744 contains double spaces
warning: line 751 contains double spaces
warning: line 752 contains double spaces
warning: line 754 contains double spaces
warning: line 761 contains double spaces
warning: line 764 multiple blank lines
warning: line 765 is in excess of 80 characters (91) : **AlignEscapedNewlines** (``EscapedNewlineAlignmentStyle``) :versionbadge:`clang-format 5`
...
warning: line 786 contains double spaces
warning: line 788 contains double spaces
warning: line 798 contains double spaces
warning: line 799 contains double spaces
warning: line 800 contains double spaces
warning: line 803 multiple blank lines
warning: line 804 multiple blank lines
warning: line 806 maximize 80 characters by joining:'[  If ``true``, horizontally align operands of binary and ternary]' and '[expressions....]

warning: line 847 multiple blank lines
warning: line 848 multiple blank lines
warning: line 849 maximize 80 characters by joining:'[**AlignTrailingComments** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 854 contains double spaces
warning: line 855 contains double spaces
warning: line 856 contains double spaces
warning: line 858 maximize 80 characters by joining:'[**AllowAllArgumentsOnNextLine** (``Boolean``) :versionbadge:`clang-format 9`]' and '[If...]

warning: line 859 maximize 80 characters by joining:'[  If a function call or braced initializer list doesn't fit on a]' and '[line,...]

warning: line 875 is in excess of 80 characters (91) : **AllowAllConstructorInitializersOnNextLine** (``Boolean``) :versionbadge:`clang-format 9`
...
warning: line 879 is in excess of 80 characters (93) : **AllowAllParametersOfDeclarationOnNextLine** (``Boolean``) :versionbadge:`clang-format 3.3`
...
warning: line 880 maximize 80 characters by joining:'[  If the function declaration doesn't fit on a line,]' and '[allow...]

warning: line 881 maximize 80 characters by joining:'[  allow putting all parameters of a function declaration onto]' and '[the...]

warning: line 897 is in excess of 80 characters (88) : **AllowShortBlocksOnASingleLine** (``ShortBlockStyle``) :versionbadge:`clang-format 11`
...
warning: line 898 maximize 80 characters by joining:'[  Dependent on the value, ``while (true) { continue; }`` can be put on a]' and '[single...]

warning: line 932 multiple blank lines
warning: line 933 multiple blank lines
warning: line 934 is in excess of 80 characters (85) : **AllowShortCaseLabelsOnASingleLine** (``Boolean``) :versionbadge:`clang-format 3.6`
...
warning: line 939 contains double spaces
warning: line 940 contains double spaces
warning: line 941 contains double spaces
warning: line 942 contains double spaces
warning: line 943 contains double spaces
warning: line 962 is in excess of 80 characters (95) : **AllowShortFunctionsOnASingleLine** (``ShortFunctionStyle``) :versionbadge:`clang-format 3.5`
...
warning: line 963 maximize 80 characters by joining:'[  Dependent on the value, ``int f() { return 0; }`` can be put on a]' and '[single...]

warning: line 1020 multiple blank lines
warning: line 1021 multiple blank lines
warning: line 1022 is in excess of 80 characters (90) : **AllowShortIfStatementsOnASingleLine** (``ShortIfStyle``) :versionbadge:`clang-format 9`
...
warning: line 1098 multiple blank lines
warning: line 1099 multiple blank lines
warning: line 1100 is in excess of 80 characters (89) : **AllowShortLambdasOnASingleLine** (``ShortLambdaStyle``) :versionbadge:`clang-format 9`
...
warning: line 1137 multiple blank lines
warning: line 1138 multiple blank lines
warning: line 1140 maximize 80 characters by joining:'[  If ``true``, ``while (true) continue;`` can be put on a single]' and '[line....]

warning: line 1143 is in excess of 80 characters (114) : **AlwaysBreakAfterDefinitionReturnType** (``DefinitionReturnTypeBreakingStyle``) :versionbadge:`clang-format 3.7`
...
warning: line 1144 contains double spaces
warning: line 1144 maximize 80 characters by joining:'[  The function definition return type breaking style to use.  This]' and '[option...]

warning: line 1159 multiple blank lines
warning: line 1160 multiple blank lines
warning: line 1161 is in excess of 80 characters (94) : **AlwaysBreakAfterReturnType** (``ReturnTypeBreakingStyle``) :versionbadge:`clang-format 3.8`
...
warning: line 1242 multiple blank lines
warning: line 1243 multiple blank lines
warning: line 1244 is in excess of 80 characters (85) : **AlwaysBreakBeforeMultilineStrings** (``Boolean``) :versionbadge:`clang-format 3.4`
...
warning: line 1247 maximize 80 characters by joining:'[  This flag is mean to make cases where there are multiple multiline strings]' and '[in...]

warning: line 1254 contains double spaces
warning: line 1255 contains double spaces
warning: line 1256 contains double spaces
warning: line 1259 is in excess of 80 characters (104) : **AlwaysBreakTemplateDeclarations** (``BreakTemplateDeclarationsStyle``) :versionbadge:`clang-format 7`
...
warning: line 1302 multiple blank lines
warning: line 1303 multiple blank lines
warning: line 1304 maximize 80 characters by joining:'[**AttributeMacros** (``List of Strings``) :versionbadge:`clang-format 12`]' and '[A...]

warning: line 1306 maximize 80 characters by joining:'[  instead of identifiers. This can be useful for language extensions or]' and '[static...]

warning: line 1323 maximize 80 characters by joining:'[**BinPackArguments** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 1324 maximize 80 characters by joining:'[  If ``false``, a function call's arguments will either be all on the]' and '[same...]

warning: line 1342 maximize 80 characters by joining:'[**BinPackParameters** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 1343 maximize 80 characters by joining:'[  If ``false``, a function declaration's or function definition's]' and '[parameters...]

warning: line 1357 is in excess of 80 characters (89) : **BitFieldColonSpacing** (``BitFieldColonSpacingStyle``) :versionbadge:`clang-format 12`
...
warning: line 1392 multiple blank lines
warning: line 1393 multiple blank lines
warning: line 1424 contains double spaces
warning: line 1425 contains double spaces
warning: line 1426 contains double spaces
warning: line 1427 contains double spaces
warning: line 1428 contains double spaces
warning: line 1429 contains double spaces
warning: line 1430 contains double spaces
warning: line 1431 contains double spaces
warning: line 1432 contains double spaces
warning: line 1433 contains double spaces
warning: line 1489 multiple blank lines
warning: line 1661 contains double spaces
warning: line 1662 contains double spaces
warning: line 1672 contains double spaces
warning: line 1673 contains double spaces
warning: line 1683 contains double spaces
warning: line 1684 contains double spaces
warning: line 1687 multiple blank lines
warning: line 1688 is in excess of 80 characters (82) : **BreakAfterJavaFieldAnnotations** (``Boolean``) :versionbadge:`clang-format 3.8`
...
warning: line 1693 contains double spaces
warning: line 1694 contains double spaces
warning: line 1698 is in excess of 80 characters (90) : **BreakBeforeBinaryOperators** (``BinaryOperatorStyle``) :versionbadge:`clang-format 3.6`
...
warning: line 1745 multiple blank lines
warning: line 1746 multiple blank lines
warning: line 2196 multiple blank lines
warning: line 2197 multiple blank lines
warning: line 2198 is in excess of 80 characters (109) : **BreakBeforeConceptDeclarations** (``BreakBeforeConceptDeclarationsStyle``) :versionbadge:`clang-format 12`
...
warning: line 2224 multiple blank lines
warning: line 2225 multiple blank lines
warning: line 2241 is in excess of 80 characters (104) : **BreakConstructorInitializers** (``BreakConstructorInitializersStyle``) :versionbadge:`clang-format 5`
...
warning: line 2274 multiple blank lines
warning: line 2275 multiple blank lines
warning: line 2276 is in excess of 80 characters (88) : **BreakInheritanceList** (``BreakInheritanceListStyle``) :versionbadge:`clang-format 7`
...
warning: line 2321 multiple blank lines
warning: line 2322 multiple blank lines
warning: line 2323 maximize 80 characters by joining:'[**BreakStringLiterals** (``Boolean``) :versionbadge:`clang-format 3.9`]' and '[Allow...]

warning: line 2337 maximize 80 characters by joining:'[**ColumnLimit** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 2344 maximize 80 characters by joining:'[**CommentPragmas** (``String``) :versionbadge:`clang-format 3.7`]' and '[A...]

warning: line 2345 maximize 80 characters by joining:'[  A regular expression that describes comments with special meaning,]' and '[which...]

warning: line 2354 maximize 80 characters by joining:'[**CompactNamespaces** (``Boolean``) :versionbadge:`clang-format 5`]' and '[If...]

warning: line 2355 maximize 80 characters by joining:'[  If ``true``, consecutive namespace declarations will be on the same]' and '[line....]

warning: line 2370 maximize 80 characters by joining:'[  If it does not fit on a single line, the overflowing namespaces get]' and '[wrapped:...]

warning: line 2379 is in excess of 80 characters (98) : **ConstructorInitializerAllOnOneLineOrOnePerLine** (``Boolean``) :versionbadge:`clang-format 3.7`
...
warning: line 2383 is in excess of 80 characters (86) : **ConstructorInitializerIndentWidth** (``Unsigned``) :versionbadge:`clang-format 3.7`
...
warning: line 2384 maximize 80 characters by joining:'[  The number of characters to use for indentation of constructor]' and '[initializer...]

warning: line 2394 contains double spaces
warning: line 2398 maximize 80 characters by joining:'[**Cpp11BracedListStyle** (``Boolean``) :versionbadge:`clang-format 3.4`]' and '[If...]

warning: line 2399 maximize 80 characters by joining:'[  If ``true``, format braced lists as best suited for C++11 braced]' and '[lists....]

warning: line 2407 maximize 80 characters by joining:'[  Fundamentally, C++11 braced lists are formatted exactly like function]' and '[calls...]

warning: line 2410 maximize 80 characters by joining:'[  the parentheses of a function call with that name. If there is no name,]' and '[a...]

warning: line 2415 contains double spaces
warning: line 2416 contains double spaces
warning: line 2417 contains double spaces
warning: line 2418 contains double spaces
warning: line 2419 contains double spaces
warning: line 2421 maximize 80 characters by joining:'[**DeriveLineEnding** (``Boolean``) :versionbadge:`clang-format 11`]' and '[Analyze...]

warning: line 2422 maximize 80 characters by joining:'[  Analyze the formatted file for the most used line ending (``\r\n``]' and '[or...]

warning: line 2425 maximize 80 characters by joining:'[**DerivePointerAlignment** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 2426 maximize 80 characters by joining:'[  If ``true``, analyze the formatted file for the most common]' and '[alignment...]

warning: line 2427 maximize 80 characters by joining:'[  alignment of ``&`` and ``*``.]' and '[Pointer...]

warning: line 2428 maximize 80 characters by joining:'[  Pointer and reference alignment styles are going to be updated according]' and '[to...]

warning: line 2432 maximize 80 characters by joining:'[**DisableFormat** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[Disables...]

warning: line 2435 is in excess of 80 characters (105) : **EmptyLineAfterAccessModifier** (``EmptyLineAfterAccessModifierStyle``) :versionbadge:`clang-format 13`
...
warning: line 2437 maximize 80 characters by joining:'[  ``EmptyLineBeforeAccessModifier`` configuration handles the number of]' and '[empty...]

warning: line 2486 multiple blank lines
warning: line 2487 multiple blank lines
warning: line 2488 is in excess of 80 characters (107) : **EmptyLineBeforeAccessModifier** (``EmptyLineBeforeAccessModifierStyle``) :versionbadge:`clang-format 12`
...
warning: line 2555 multiple blank lines
warning: line 2556 multiple blank lines
warning: line 2557 is in excess of 80 characters (84) : **ExperimentalAutoDetectBinPacking** (``Boolean``) :versionbadge:`clang-format 3.7`
...
warning: line 2558 maximize 80 characters by joining:'[  If ``true``, clang-format detects whether function calls and]' and '[definitions...]

warning: line 2562 maximize 80 characters by joining:'[  inconclusive, e.g. completely on one line, but a decision needs to be]' and '[made,...]

warning: line 2563 maximize 80 characters by joining:'[  made, clang-format analyzes whether there are other bin-packed cases in]' and '[the...]

warning: line 2566 maximize 80 characters by joining:'[  NOTE: This is an experimental flag, that might go away or be renamed. Do]' and '[not...]

warning: line 2569 maximize 80 characters by joining:'[**FixNamespaceComments** (``Boolean``) :versionbadge:`clang-format 5`]' and '[If...]

warning: line 2570 maximize 80 characters by joining:'[  If ``true``, clang-format adds missing namespace end comments for]' and '[short...]

warning: line 2571 maximize 80 characters by joining:'[  short namespaces and fixes invalid existing ones. Short ones are]' and '[controlled...]

warning: line 2576 contains double spaces
warning: line 2577 contains double spaces
warning: line 2578 contains double spaces
warning: line 2579 contains double spaces
warning: line 2580 contains double spaces
warning: line 2582 maximize 80 characters by joining:'[**ForEachMacros** (``List of Strings``) :versionbadge:`clang-format 3.7`]' and '[A...]

warning: line 2583 maximize 80 characters by joining:'[  A vector of macros that should be interpreted as foreach loops]' and '[instead...]

warning: line 2601 maximize 80 characters by joining:'[**IfMacros** (``List of Strings``) :versionbadge:`clang-format 13`]' and '[A...]

warning: line 2602 maximize 80 characters by joining:'[  A vector of macros that should be interpreted as conditionals]' and '[instead...]

warning: line 2624 maximize 80 characters by joining:'[  Dependent on the value, multiple ``#include`` blocks can be sorted]' and '[as...]

warning: line 2634 contains double spaces
warning: line 2636 contains double spaces
warning: line 2637 contains double spaces
warning: line 2644 contains double spaces
warning: line 2646 contains double spaces
warning: line 2656 contains double spaces
warning: line 2659 contains double spaces
warning: line 2661 multiple blank lines
warning: line 2662 multiple blank lines
warning: line 2663 is in excess of 80 characters (85) : **IncludeCategories** (``List of IncludeCategories``) :versionbadge:`clang-format 7`
...
warning: line 2664 maximize 80 characters by joining:'[  Regular expressions denoting the different ``#include`` categories]' and '[used...]

warning: line 2672 maximize 80 characters by joining:'[  (including the <> or "") in order. The value belonging to the first]' and '[matching...]

warning: line 2674 maximize 80 characters by joining:'[  according to increasing category number and then alphabetically within]' and '[each...]

warning: line 2677 maximize 80 characters by joining:'[  If none of the regular expressions match, INT_MAX is assigned as]' and '[category....]

warning: line 2678 maximize 80 characters by joining:'[  category. The main header for a source file automatically gets category 0.]' and '[so...]

warning: line 2681 maximize 80 characters by joining:'[  can also assign negative priorities if you have certain headers that]' and '[always...]

warning: line 2686 maximize 80 characters by joining:'[  ``#includes`` should be ordered. The value of ``Priority`` defines the]' and '[order...]

warning: line 2687 maximize 80 characters by joining:'[  order of ``#include blocks`` and also allows the grouping of ``#includes``]' and '[of...]

warning: line 2699 contains double spaces
warning: line 2700 contains double spaces
warning: line 2701 contains double spaces
warning: line 2702 contains double spaces
warning: line 2703 contains double spaces
warning: line 2704 contains double spaces
warning: line 2705 contains double spaces
warning: line 2706 contains double spaces
warning: line 2707 contains double spaces
warning: line 2708 contains double spaces
warning: line 2709 contains double spaces
warning: line 2711 maximize 80 characters by joining:'[**IncludeIsMainRegex** (``String``) :versionbadge:`clang-format 7`]' and '[Specify...]

warning: line 2715 maximize 80 characters by joining:'[  When guessing whether a #include is the "main" include (to assign]' and '[category...]

warning: line 2721 maximize 80 characters by joining:'[  For example, if configured to "(_test)?$", then a header a.h would be seen]' and '[as...]

warning: line 2725 maximize 80 characters by joining:'[  Specify a regular expression for files being formatted]' and '[that...]

warning: line 2726 maximize 80 characters by joining:'[  that are allowed to be considered "main" in the]' and '[file-to-main-include...]

warning: line 2729 maximize 80 characters by joining:'[  By default, clang-format considers files as "main" only when they end]' and '[with:...]

warning: line 2731 maximize 80 characters by joining:'[  extensions.]' and '[For...]

warning: line 2732 maximize 80 characters by joining:'[  For these files a guessing of "main" include takes place]' and '[(to...]

warning: line 2733 maximize 80 characters by joining:'[  (to assign category 0, see above). This config option allows for]' and '[additional...]

warning: line 2736 maximize 80 characters by joining:'[  For example, if this option is configured to ``(Impl\.hpp)$``,]' and '[then...]

warning: line 2738 maximize 80 characters by joining:'[  ``Class.c``, ``Class.cc``, ``Class.cpp`` and so on) and "main]' and '[include...]

warning: line 2739 maximize 80 characters by joining:'[  include file" logic will be executed (with *IncludeIsMainRegex* setting]' and '[also...]

warning: line 2741 maximize 80 characters by joining:'[  ``ClassImpl.hpp`` would not have the main include file put on top]' and '[before...]

warning: line 2744 maximize 80 characters by joining:'[**IndentAccessModifiers** (``Boolean``) :versionbadge:`clang-format 13`]' and '[Specify...]

warning: line 2747 maximize 80 characters by joining:'[  When ``false``, access modifiers are indented (or outdented) relative to]' and '[the...]

warning: line 2748 maximize 80 characters by joining:'[  the record members, respecting the ``AccessModifierOffset``. Record]' and '[members...]

warning: line 2749 maximize 80 characters by joining:'[  members are indented one level below the record.]' and '[When...]

warning: line 2757 contains double spaces
warning: line 2758 contains double spaces
warning: line 2759 contains double spaces
warning: line 2760 contains double spaces
warning: line 2761 contains double spaces
warning: line 2762 contains double spaces
warning: line 2763 contains double spaces
warning: line 2764 contains double spaces
warning: line 2765 contains double spaces
warning: line 2766 contains double spaces
warning: line 2767 contains double spaces
warning: line 2768 contains double spaces
warning: line 2769 contains double spaces
warning: line 2771 maximize 80 characters by joining:'[**IndentCaseBlocks** (``Boolean``) :versionbadge:`clang-format 11`]' and '[Indent...]

warning: line 2774 maximize 80 characters by joining:'[  When ``false``, the block following the case label uses the same]' and '[indentation...]

warning: line 2775 maximize 80 characters by joining:'[  indentation level as for the case label, treating the case label the same]' and '[as...]

warning: line 2776 maximize 80 characters by joining:'[  as an if-statement.]' and '[When...]

warning: line 2781 contains double spaces
warning: line 2782 contains double spaces
warning: line 2783 contains double spaces
warning: line 2784 contains double spaces
warning: line 2785 contains double spaces
warning: line 2786 contains double spaces
warning: line 2787 contains double spaces
warning: line 2788 contains double spaces
warning: line 2789 contains double spaces
warning: line 2794 maximize 80 characters by joining:'[**IndentCaseLabels** (``Boolean``) :versionbadge:`clang-format 3.3`]' and '[Indent...]

warning: line 2797 maximize 80 characters by joining:'[  When ``false``, use the same indentation level as for the switch]' and '[statement....]

warning: line 2798 maximize 80 characters by joining:'[  statement. Switch statement body is always indented one level more than]' and '[case...]

warning: line 2799 maximize 80 characters by joining:'[  case labels (except the first block following the case label, which]' and '[itself...]

warning: line 2804 contains double spaces
warning: line 2805 contains double spaces
warning: line 2806 contains double spaces
warning: line 2807 contains double spaces
warning: line 2808 contains double spaces
warning: line 2809 contains double spaces
warning: line 2810 contains double spaces
warning: line 2811 contains double spaces
warning: line 2813 is in excess of 80 characters (83) : **IndentExternBlock** (``IndentExternBlockStyle``) :versionbadge:`clang-format 11`
...
warning: line 2830 multiple blank lines
warning: line 2857 multiple blank lines
warning: line 2858 multiple blank lines
warning: line 2859 maximize 80 characters by joining:'[**IndentGotoLabels** (``Boolean``) :versionbadge:`clang-format 10`]' and '[Indent...]

warning: line 2866 contains double spaces
warning: line 2867 contains double spaces
warning: line 2868 contains double spaces
warning: line 2869 contains double spaces
warning: line 2870 contains double spaces
warning: line 2871 contains double spaces
warning: line 2872 contains double spaces
warning: line 2873 contains double spaces
warning: line 2874 contains double spaces
warning: line 2876 is in excess of 80 characters (83) : **IndentPPDirectives** (``PPDirectiveIndentStyle``) :versionbadge:`clang-format 6`
...
warning: line 2898 contains double spaces
warning: line 2899 contains double spaces
warning: line 2900 contains double spaces
warning: line 2914 multiple blank lines
warning: line 2915 multiple blank lines
warning: line 2916 maximize 80 characters by joining:'[**IndentRequiresClause** (``Boolean``) :versionbadge:`clang-format 15`]' and '[Indent...]

warning: line 2938 maximize 80 characters by joining:'[**IndentWidth** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 2953 maximize 80 characters by joining:'[  Indent if a function definition or declaration is wrapped after the]' and '[type....]

warning: line 2966 maximize 80 characters by joining:'[**InsertBraces** (``Boolean``) :versionbadge:`clang-format 15`]' and '[Insert...]

warning: line 2971 trailing whitespace
warning: line 2979 contains double spaces
warning: line 2981 contains double spaces
warning: line 2982 contains double spaces
warning: line 2983 contains double spaces
warning: line 2984 contains double spaces
warning: line 2985 contains double spaces
warning: line 2986 contains double spaces
warning: line 2989 contains double spaces
warning: line 2990 contains double spaces
warning: line 2991 contains double spaces
warning: line 2995 contains double spaces
warning: line 2996 contains double spaces
warning: line 2997 contains double spaces
warning: line 2999 is in excess of 80 characters (82) : **InsertTrailingCommas** (``TrailingCommaStyle``) :versionbadge:`clang-format 11`
...
warning: line 3000 maximize 80 characters by joining:'[  If set to ``TCS_Wrapped`` will insert trailing commas in container]' and '[literals...]

warning: line 3001 maximize 80 characters by joining:'[  literals (arrays and objects) that wrap across multiple lines.]' and '[It...]

warning: line 3002 maximize 80 characters by joining:'[  It is currently only available for JavaScript]' and '[and...]

warning: line 3004 maximize 80 characters by joining:'[  ``InsertTrailingCommas`` cannot be used together with ``BinPackArguments``]' and '[as...]

warning: line 3014 contains double spaces
warning: line 3029 multiple blank lines
warning: line 3030 multiple blank lines
warning: line 3031 maximize 80 characters by joining:'[**JavaImportGroups** (``List of Strings``) :versionbadge:`clang-format 8`]' and '[A...]

warning: line 3034 maximize 80 characters by joining:'[  One group's prefix can be a subset of another - the longest prefix is]' and '[always...]

warning: line 3036 maximize 80 characters by joining:'[  Static imports are grouped separately and follow the same group rules.]' and '[By...]

warning: line 3037 maximize 80 characters by joining:'[  By default, static imports are placed before non-static imports,]' and '[but...]

warning: line 3041 maximize 80 characters by joining:'[  In the .clang-format configuration file, this can be configured like]' and '[in...]

warning: line 3042 maximize 80 characters by joining:'[  in the following yaml example. This will result in imports being]' and '[formatted...]

warning: line 3049 multiple blank lines
warning: line 3095 multiple blank lines
warning: line 3096 multiple blank lines
warning: line 3112 is in excess of 80 characters (84) : **KeepEmptyLinesAtTheStartOfBlocks** (``Boolean``) :versionbadge:`clang-format 3.7`
...
warning: line 3117 contains double spaces
warning: line 3118 contains double spaces
warning: line 3120 contains double spaces
warning: line 3123 is in excess of 80 characters (90) : **LambdaBodyIndentation** (``LambdaBodyIndentationKind``) :versionbadge:`clang-format 13`
...
warning: line 3124 maximize 80 characters by joining:'[  The indentation style of lambda bodies. ``Signature`` (the default)]' and '[causes...]

warning: line 3125 maximize 80 characters by joining:'[  causes the lambda body to be indented one additional level relative to]' and '[the...]

warning: line 3126 maximize 80 characters by joining:'[  the indentation level of the signature. ``OuterScope`` forces the lambda]' and '[body...]

warning: line 3157 multiple blank lines
warning: line 3158 multiple blank lines
warning: line 3159 maximize 80 characters by joining:'[**Language** (``LanguageKind``) :versionbadge:`clang-format 3.5`]' and '[Language,...]

warning: line 3196 multiple blank lines
warning: line 3197 multiple blank lines
warning: line 3198 maximize 80 characters by joining:'[**MacroBlockBegin** (``String``) :versionbadge:`clang-format 3.7`]' and '[A...]

warning: line 3227 maximize 80 characters by joining:'[**MacroBlockEnd** (``String``) :versionbadge:`clang-format 3.7`]' and '[A...]

warning: line 3230 maximize 80 characters by joining:'[**MaxEmptyLinesToKeep** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 3235 contains double spaces
warning: line 3236 contains double spaces
warning: line 3237 contains double spaces
warning: line 3239 contains double spaces
warning: line 3244 is in excess of 80 characters (89) : **NamespaceIndentation** (``NamespaceIndentationKind``) :versionbadge:`clang-format 3.7`
...
warning: line 3285 multiple blank lines
warning: line 3286 multiple blank lines
warning: line 3287 maximize 80 characters by joining:'[**NamespaceMacros** (``List of Strings``) :versionbadge:`clang-format 9`]' and '[A...]

warning: line 3301 maximize 80 characters by joining:'[  Controls bin-packing Objective-C protocol conformance list]' and '[items...]

warning: line 3305 maximize 80 characters by joining:'[  ``BinPackParameters``. If that is ``true``, bin-packs Objective-C]' and '[protocol...]

warning: line 3306 maximize 80 characters by joining:'[  protocol conformance list items into as few lines as possible]' and '[whenever...]

warning: line 3309 maximize 80 characters by joining:'[  If ``Always``, always bin-packs Objective-C protocol conformance]' and '[list...]

warning: line 3313 maximize 80 characters by joining:'[  If ``Never``, lays out Objective-C protocol conformance list items]' and '[onto...]

warning: line 3316 multiple blank lines
warning: line 3344 multiple blank lines
warning: line 3345 multiple blank lines
warning: line 3346 maximize 80 characters by joining:'[**ObjCBlockIndentWidth** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 3357 is in excess of 80 characters (82) : **ObjCBreakBeforeNestedBlockParam** (``Boolean``) :versionbadge:`clang-format 11`
...
warning: line 3358 maximize 80 characters by joining:'[  Break parameters list into lines when there is nested block]' and '[parameters...]

warning: line 3381 maximize 80 characters by joining:'[**ObjCSpaceAfterProperty** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[Add...]

warning: line 3389 maximize 80 characters by joining:'[**PPIndentWidth** (``Integer``) :versionbadge:`clang-format 13`]' and '[The...]

warning: line 3390 maximize 80 characters by joining:'[  The number of columns to use for indentation of preprocessor statements.]' and '[When...]

warning: line 3404 is in excess of 80 characters (103) : **PackConstructorInitializers** (``PackConstructorInitializersStyle``) :versionbadge:`clang-format 14`
...
warning: line 3456 multiple blank lines
warning: line 3457 multiple blank lines
warning: line 3458 maximize 80 characters by joining:'[**PenaltyBreakAssignment** (``Unsigned``) :versionbadge:`clang-format 5`]' and '[The...]

warning: line 3461 is in excess of 80 characters (89) : **PenaltyBreakBeforeFirstCallParameter** (``Unsigned``) :versionbadge:`clang-format 3.7`
...
warning: line 3464 maximize 80 characters by joining:'[**PenaltyBreakComment** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 3473 maximize 80 characters by joining:'[**PenaltyBreakString** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 3476 is in excess of 80 characters (82) : **PenaltyBreakTemplateDeclaration** (``Unsigned``) :versionbadge:`clang-format 7`
...
warning: line 3479 maximize 80 characters by joining:'[**PenaltyExcessCharacter** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 3483 maximize 80 characters by joining:'[  Penalty for each character of whitespace indentation]' and '[(counted...]

warning: line 3486 is in excess of 80 characters (82) : **PenaltyReturnTypeOnItsOwnLine** (``Unsigned``) :versionbadge:`clang-format 3.7`
...
warning: line 3487 maximize 80 characters by joining:'[  Penalty for putting the return type of a function onto its own]' and '[line....]

warning: line 3490 is in excess of 80 characters (82) : **PointerAlignment** (``PointerAlignmentStyle``) :versionbadge:`clang-format 3.7`
...
warning: line 3516 multiple blank lines
warning: line 3517 multiple blank lines
warning: line 3518 is in excess of 80 characters (85) : **QualifierAlignment** (``QualifierAlignmentStyle``) :versionbadge:`clang-format 14`
...
warning: line 3521 trailing whitespace
warning: line 3523 contains double spaces
warning: line 3564 multiple blank lines
warning: line 3567 multiple blank lines
warning: line 3571 multiple blank lines
warning: line 3572 multiple blank lines
warning: line 3573 maximize 80 characters by joining:'[**QualifierOrder** (``List of Strings``) :versionbadge:`clang-format 14`]' and '[The...]

warning: line 3574 maximize 80 characters by joining:'[  The order in which the qualifiers appear.]' and '[Order...]

warning: line 3585 maximize 80 characters by joining:'[  Note: it MUST contain 'type'.]' and '[Items...]

warning: line 3587 maximize 80 characters by joining:'[  aligned in the order supplied. Items to the right of 'type' will be placed]' and '[to...]

warning: line 3590 multiple blank lines
warning: line 3595 is in excess of 80 characters (83) : **RawStringFormats** (``List of RawStringFormats``) :versionbadge:`clang-format 6`
...
warning: line 3596 maximize 80 characters by joining:'[  Defines hints for detecting supported languages code blocks in raw]' and '[strings....]

warning: line 3599 maximize 80 characters by joining:'[  A raw string with a matching delimiter or a matching enclosing function]' and '[name...]

warning: line 3600 maximize 80 characters by joining:'[  name will be reformatted assuming the specified language based on the]' and '[style...]

warning: line 3611 maximize 80 characters by joining:'[  There should be at most one specification per language and each delimiter]' and '[and...]

warning: line 3633 is in excess of 80 characters (85) : **ReferenceAlignment** (``ReferenceAlignmentStyle``) :versionbadge:`clang-format 13`
...
warning: line 3634 maximize 80 characters by joining:'[  Reference alignment style (overrides ``PointerAlignment`` for]' and '[references)....]

warning: line 3663 multiple blank lines
warning: line 3664 multiple blank lines
warning: line 3665 maximize 80 characters by joining:'[**ReflowComments** (``Boolean``) :versionbadge:`clang-format 4`]' and '[If...]

warning: line 3680 maximize 80 characters by joining:'[**RemoveBracesLLVM** (``Boolean``) :versionbadge:`clang-format 14`]' and '[Remove...]

warning: line 3681 maximize 80 characters by joining:'[  Remove optional braces of control statements (``if``, ``else``, ``for``,]' and '[and...]

warning: line 3684 trailing whitespace
warning: line 3688 trailing whitespace
warning: line 3696 contains double spaces
warning: line 3698 contains double spaces
warning: line 3699 contains double spaces
warning: line 3700 contains double spaces
warning: line 3701 contains double spaces
warning: line 3704 contains double spaces
warning: line 3705 contains double spaces
warning: line 3706 contains double spaces
warning: line 3707 contains double spaces
warning: line 3708 contains double spaces
warning: line 3712 contains double spaces
warning: line 3713 contains double spaces
warning: line 3714 contains double spaces
warning: line 3718 contains double spaces
warning: line 3719 contains double spaces
warning: line 3720 contains double spaces
warning: line 3721 contains double spaces
warning: line 3722 contains double spaces
warning: line 3723 contains double spaces
warning: line 3726 contains double spaces
warning: line 3727 contains double spaces
warning: line 3728 contains double spaces
warning: line 3729 contains double spaces
warning: line 3730 contains double spaces
warning: line 3731 contains double spaces
warning: line 3736 is in excess of 80 characters (93) : **RequiresClausePosition** (``RequiresClausePositionStyle``) :versionbadge:`clang-format 15`
...
warning: line 3820 multiple blank lines
warning: line 3821 multiple blank lines
warning: line 3822 is in excess of 80 characters (91) : **SeparateDefinitionBlocks** (``SeparateDefinitionStyle``) :versionbadge:`clang-format 14`
...
warning: line 3828 contains double spaces
warning: line 3829 contains double spaces
warning: line 3831 contains double spaces
warning: line 3832 contains double spaces
warning: line 3833 contains double spaces
warning: line 3835 contains double spaces
warning: line 3836 contains double spaces
warning: line 3837 contains double spaces
warning: line 3838 contains double spaces
warning: line 3839 contains double spaces
warning: line 3840 contains double spaces
warning: line 3841 contains double spaces
warning: line 3843 contains double spaces
warning: line 3844 contains double spaces
warning: line 3846 contains double spaces
warning: line 3847 contains double spaces
warning: line 3848 contains double spaces
warning: line 3850 contains double spaces
warning: line 3851 contains double spaces
warning: line 3852 contains double spaces
warning: line 3853 contains double spaces
warning: line 3855 contains double spaces
warning: line 3856 contains double spaces
warning: line 3857 contains double spaces
warning: line 3858 contains double spaces
warning: line 3881 multiple blank lines
warning: line 3882 multiple blank lines
warning: line 3883 maximize 80 characters by joining:'[**ShortNamespaceLines** (``Unsigned``) :versionbadge:`clang-format 13`]' and '[The...]

warning: line 3884 maximize 80 characters by joining:'[  The maximal number of unwrapped lines that a short namespace spans.]' and '[Defaults...]

warning: line 3887 maximize 80 characters by joining:'[  This determines the maximum length of short namespaces by counting]' and '[unwrapped...]

warning: line 3888 maximize 80 characters by joining:'[  unwrapped lines (i.e. containing neither opening nor closing]' and '[namespace...]

warning: line 3889 maximize 80 characters by joining:'[  namespace brace) and makes "FixNamespaceComments" omit adding]' and '[end...]

warning: line 3894 contains double spaces
warning: line 3895 contains double spaces
warning: line 3896 contains double spaces
warning: line 3897 contains double spaces
warning: line 3899 contains double spaces
warning: line 3900 contains double spaces
warning: line 3901 contains double spaces
warning: line 3902 contains double spaces
warning: line 3903 contains double spaces
warning: line 3906 maximize 80 characters by joining:'[  Controls if and how clang-format will sort ``#includes``.]' and '[If...]

warning: line 3907 maximize 80 characters by joining:'[  If ``Never``, includes are never sorted.]' and '[If...]

warning: line 3909 maximize 80 characters by joining:'[  insensitive fashion.]' and '[If...]

warning: line 3948 multiple blank lines
warning: line 3949 multiple blank lines
warning: line 3950 is in excess of 80 characters (91) : **SortJavaStaticImport** (``SortJavaStaticImportOptions``) :versionbadge:`clang-format 12`
...
warning: line 3952 maximize 80 characters by joining:'[  non-static imports. If ``JavaStaticImportAfterImport`` is ``After``,]' and '[static...]

warning: line 3975 multiple blank lines
warning: line 3976 multiple blank lines
warning: line 3977 maximize 80 characters by joining:'[**SortUsingDeclarations** (``Boolean``) :versionbadge:`clang-format 5`]' and '[If...]

warning: line 3980 maximize 80 characters by joining:'[  The order of using declarations is defined as follows:]' and '[Split...]

warning: line 3982 maximize 80 characters by joining:'[  element of each list is a non-namespace name; all others are namespace]' and '[names....]

warning: line 3985 maximize 80 characters by joining:'[  names, and within those groups, names are in case-insensitive]' and '[lexicographic...]

warning: line 3990 contains double spaces
warning: line 3991 contains double spaces
warning: line 3992 contains double spaces
warning: line 3994 maximize 80 characters by joining:'[**SpaceAfterCStyleCast** (``Boolean``) :versionbadge:`clang-format 3.5`]' and '[If...]

warning: line 3999 contains double spaces
warning: line 4000 contains double spaces
warning: line 4002 maximize 80 characters by joining:'[**SpaceAfterLogicalNot** (``Boolean``) :versionbadge:`clang-format 9`]' and '[If...]

warning: line 4007 contains double spaces
warning: line 4008 contains double spaces
warning: line 4010 maximize 80 characters by joining:'[**SpaceAfterTemplateKeyword** (``Boolean``) :versionbadge:`clang-format 4`]' and '[If...]

warning: line 4015 contains double spaces
warning: line 4016 contains double spaces
warning: line 4018 is in excess of 80 characters (105) : **SpaceAroundPointerQualifiers** (``SpaceAroundPointerQualifiersStyle``) :versionbadge:`clang-format 12`
...
warning: line 4029 contains double spaces
warning: line 4030 contains double spaces
warning: line 4037 contains double spaces
warning: line 4038 contains double spaces
warning: line 4045 contains double spaces
warning: line 4046 contains double spaces
warning: line 4053 contains double spaces
warning: line 4054 contains double spaces
warning: line 4056 multiple blank lines
warning: line 4057 multiple blank lines
warning: line 4058 is in excess of 80 characters (82) : **SpaceBeforeAssignmentOperators** (``Boolean``) :versionbadge:`clang-format 3.7`
...
warning: line 4063 contains double spaces
warning: line 4064 contains double spaces
warning: line 4065 contains double spaces
warning: line 4067 maximize 80 characters by joining:'[**SpaceBeforeCaseColon** (``Boolean``) :versionbadge:`clang-format 12`]' and '[If...]

warning: line 4072 contains double spaces
warning: line 4073 contains double spaces
warning: line 4074 contains double spaces
warning: line 4075 contains double spaces
warning: line 4077 maximize 80 characters by joining:'[**SpaceBeforeCpp11BracedList** (``Boolean``) :versionbadge:`clang-format 7`]' and '[If...]

warning: line 4078 maximize 80 characters by joining:'[  If ``true``, a space will be inserted before a C++11 braced list]' and '[used...]

warning: line 4083 contains double spaces
warning: line 4084 contains double spaces
warning: line 4085 contains double spaces
warning: line 4086 contains double spaces
warning: line 4087 contains double spaces
warning: line 4090 maximize 80 characters by joining:'[  If ``false``, spaces will be removed before constructor initializer]' and '[colon....]

warning: line 4095 contains double spaces
warning: line 4096 contains double spaces
warning: line 4098 maximize 80 characters by joining:'[**SpaceBeforeInheritanceColon** (``Boolean``) :versionbadge:`clang-format 7`]' and '[If...]

warning: line 4103 contains double spaces
warning: line 4104 contains double spaces
warning: line 4106 is in excess of 80 characters (84) : **SpaceBeforeParens** (``SpaceBeforeParensStyle``) :versionbadge:`clang-format 3.5`
...
warning: line 4180 multiple blank lines
warning: line 4181 multiple blank lines
warning: line 4182 is in excess of 80 characters (91) : **SpaceBeforeParensOptions** (``SpaceBeforeParensCustom``) :versionbadge:`clang-format 14`
...
warning: line 4185 maximize 80 characters by joining:'[  If ``SpaceBeforeParens`` is set to ``Custom``, use this to specify]' and '[how...]

warning: line 4214 contains double spaces
warning: line 4215 contains double spaces
warning: line 4221 contains double spaces
warning: line 4222 contains double spaces
warning: line 4223 contains double spaces
warning: line 4230 contains double spaces
warning: line 4231 contains double spaces
warning: line 4238 contains double spaces
warning: line 4239 contains double spaces
warning: line 4245 contains double spaces
warning: line 4246 contains double spaces
warning: line 4247 contains double spaces
warning: line 4254 contains double spaces
warning: line 4255 contains double spaces
warning: line 4256 contains double spaces
warning: line 4263 contains double spaces
warning: line 4264 contains double spaces
warning: line 4265 contains double spaces
warning: line 4266 contains double spaces
warning: line 4273 contains double spaces
warning: line 4274 contains double spaces
warning: line 4275 contains double spaces
warning: line 4276 contains double spaces
warning: line 4277 contains double spaces
warning: line 4284 contains double spaces
warning: line 4285 contains double spaces
warning: line 4286 contains double spaces
warning: line 4288 multiple blank lines
warning: line 4289 is in excess of 80 characters (83) : **SpaceBeforeRangeBasedForLoopColon** (``Boolean``) :versionbadge:`clang-format 7`
...
warning: line 4290 maximize 80 characters by joining:'[  If ``false``, spaces will be removed before range-based for loop]' and '[colon....]

warning: line 4295 contains double spaces
warning: line 4296 contains double spaces
warning: line 4299 contains double spaces
warning: line 4298 maximize 80 characters by joining:'[**SpaceBeforeSquareBrackets** (``Boolean``) :versionbadge:`clang-format 11`]' and '[If...]

warning: line 4299 maximize 80 characters by joining:'[  If ``true``, spaces will be before  ``[``.]' and '[Lambdas...]

warning: line 4304 contains double spaces
warning: line 4305 contains double spaces
warning: line 4306 contains double spaces
warning: line 4308 maximize 80 characters by joining:'[**SpaceInEmptyBlock** (``Boolean``) :versionbadge:`clang-format 11`]' and '[If...]

warning: line 4313 contains double spaces
warning: line 4314 contains double spaces
warning: line 4315 contains double spaces
warning: line 4317 maximize 80 characters by joining:'[**SpaceInEmptyParentheses** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 4322 contains double spaces
warning: line 4323 contains double spaces
warning: line 4324 contains double spaces
warning: line 4325 contains double spaces
warning: line 4326 contains double spaces
warning: line 4327 contains double spaces
warning: line 4328 contains double spaces
warning: line 4331 maximize 80 characters by joining:'[  The number of spaces before trailing line comments]' and '[(``//``...]

warning: line 4334 maximize 80 characters by joining:'[  This does not affect trailing block comments (``/*`` - comments) as]' and '[those...]

warning: line 4335 maximize 80 characters by joining:'[  those commonly have different usage patterns and a number of special]' and '[cases....]

warning: line 4342 contains double spaces
warning: line 4343 contains double spaces
warning: line 4344 contains double spaces
warning: line 4372 multiple blank lines
warning: line 4373 multiple blank lines
warning: line 4379 contains double spaces
warning: line 4380 contains double spaces
warning: line 4383 maximize 80 characters by joining:'[  If ``true``, spaces will be inserted around if/for/switch/while]' and '[conditions....]

warning: line 4388 contains double spaces
warning: line 4389 contains double spaces
warning: line 4390 contains double spaces
warning: line 4392 maximize 80 characters by joining:'[**SpacesInContainerLiterals** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 4393 maximize 80 characters by joining:'[  If ``true``, spaces are inserted inside container literals (e.g.]' and '[ObjC...]

warning: line 4398 contains double spaces
warning: line 4399 contains double spaces
warning: line 4400 contains double spaces
warning: line 4402 is in excess of 80 characters (88) : **SpacesInLineCommentPrefix** (``SpacesInLineComment``) :versionbadge:`clang-format 13`
...
warning: line 4404 maximize 80 characters by joining:'[  maximum set it to ``-1``, apart from that the maximum takes precedence]' and '[over...]

warning: line 4413 contains double spaces
warning: line 4424 contains double spaces
warning: line 4426 contains double spaces
warning: line 4427 contains double spaces
warning: line 4428 contains double spaces
warning: line 4431 contains double spaces
warning: line 4432 contains double spaces
warning: line 4433 contains double spaces
warning: line 4443 multiple blank lines
warning: line 4444 maximize 80 characters by joining:'[**SpacesInParentheses** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 4449 contains double spaces
warning: line 4450 contains double spaces
warning: line 4452 maximize 80 characters by joining:'[**SpacesInSquareBrackets** (``Boolean``) :versionbadge:`clang-format 3.7`]' and '[If...]

warning: line 4453 maximize 80 characters by joining:'[  If ``true``, spaces will be inserted after ``[`` and before ``]``.]' and '[Lambdas...]

warning: line 4454 maximize 80 characters by joining:'[  Lambdas without arguments or unspecified size array declarations will not]' and '[be...]

warning: line 4459 contains double spaces
warning: line 4460 contains double spaces
warning: line 4463 maximize 80 characters by joining:'[**Standard** (``LanguageStandard``) :versionbadge:`clang-format 3.7`]' and '[Parse...]

warning: line 4468 contains double spaces
warning: line 4469 contains double spaces
warning: line 4496 multiple blank lines
warning: line 4497 multiple blank lines
warning: line 4498 is in excess of 80 characters (87) : **StatementAttributeLikeMacros** (``List of Strings``) :versionbadge:`clang-format 12`
...
warning: line 4508 contains double spaces
warning: line 4515 maximize 80 characters by joining:'[**StatementMacros** (``List of Strings``) :versionbadge:`clang-format 8`]' and '[A...]

warning: line 4516 maximize 80 characters by joining:'[  A vector of macros that should be interpreted as complete]' and '[statements....]

warning: line 4519 maximize 80 characters by joining:'[  Typical macros are expressions, and require a semi-colon to be]' and '[added;...]

warning: line 4520 maximize 80 characters by joining:'[  added; sometimes this is not the case, and this allows to make]' and '[clang-format...]

warning: line 4525 maximize 80 characters by joining:'[**TabWidth** (``Unsigned``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 4528 maximize 80 characters by joining:'[**TypenameMacros** (``List of Strings``) :versionbadge:`clang-format 9`]' and '[A...]

warning: line 4529 maximize 80 characters by joining:'[  A vector of macros that should be interpreted as type declarations]' and '[instead...]

warning: line 4546 maximize 80 characters by joining:'[**UseCRLF** (``Boolean``) :versionbadge:`clang-format 11`]' and '[Use...]

warning: line 4547 maximize 80 characters by joining:'[  Use ``\r\n`` instead of ``\n`` for line breaks.]' and '[Also...]

warning: line 4550 maximize 80 characters by joining:'[**UseTab** (``UseTabStyle``) :versionbadge:`clang-format 3.7`]' and '[The...]

warning: line 4573 multiple blank lines
warning: line 4574 multiple blank lines
warning: line 4575 is in excess of 80 characters (84) : **WhitespaceSensitiveMacros** (``List of Strings``) :versionbadge:`clang-format 11`
...
warning: line 4576 maximize 80 characters by joining:'[  A vector of macros which are whitespace-sensitive and should not]' and '[be...]

warning: line 4599 maximize 80 characters by joining:'[these costs affect the clang-format development itself, as we need to make]' and '[sure...]

[kuzkry]

clang/docs/ClangFormatStyleOptions.rst

361

The point of this PR was to regenerate .rst in order to isolate these changes from any future clang-format patches that would otherwise include unrelated changes.

Anyway, considering enormous number of findings (757 to be exact), it's surely going to be tedious to fix those, unless the tool could automate that.

[MyDeveloperDay]

I’m not blocking it just using the observation to highlight that the rst generated isn’t conformant with best practices. The solution being that a volunteer offers to fix the dump_format_style.py or enduring Format.h isn’t making those mistakes

clang/docs/ClangFormatStyleOptions.rst

.. code-block:: c++
       /* A comment. */
       double e = 4;
 
       false:
       int d = 3;
       /* A comment. */
       double e = 4;
 
-  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound
-    assignments like ``+=`` are aligned along with ``=``.
+  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound assignments
+    like ``+=`` are aligned along with ``=``.
 
     .. code-block:: c++
 
       true:
       a   &= 2;
       bbb  = 2;
 
       false:
       a &= 2;
       bbb = 2;
 
-  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short
-    assignment operators are left-padded to the same length as long
-    ones in order to put all assignment operators to the right of
-    the left hand side.
+  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short assignment
+    operators are left-padded to the same length as long ones in order to
+    put all assignment operators to the right of the left hand side.
 
     .. code-block:: c++
 
       true:
       a   >>= 2;
       bbb   = 2;
 
       a     = 2;
.. code-block:: c++
       /* A comment. */
       double e = 4;
 
       false:
       int d = 3;
       /* A comment. */
       double e = 4;
 
-  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound
-    assignments like ``+=`` are aligned along with ``=``.
+  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound assignments
+    like ``+=`` are aligned along with ``=``.
 
     .. code-block:: c++
 
       true:
       a   &= 2;
       bbb  = 2;
 
       false:
       a &= 2;
       bbb = 2;
 
-  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short
-    assignment operators are left-padded to the same length as long
-    ones in order to put all assignment operators to the right of
-    the left hand side.
+  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short assignment
+    operators are left-padded to the same length as long ones in order to
+    put all assignment operators to the right of the left hand side.
 
     .. code-block:: c++
 
       true:
       a   >>= 2;
       bbb   = 2;
 
       a     = 2;
.. code-block:: c++
       /* A comment. */
       double e = 4;
 
       false:
       int d = 3;
       /* A comment. */
       double e = 4;
 
-  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound
-    assignments like ``+=`` are aligned along with ``=``.
+  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound assignments
+    like ``+=`` are aligned along with ``=``.
 
     .. code-block:: c++
 
       true:
       a   &= 2;
       bbb  = 2;
 
       false:
       a &= 2;
       bbb = 2;
 
-  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short
-    assignment operators are left-padded to the same length as long
-    ones in order to put all assignment operators to the right of
-    the left hand side.
+  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short assignment
+    operators are left-padded to the same length as long ones in order to
+    put all assignment operators to the right of the left hand side.
 
     .. code-block:: c++
 
       true:
       a   >>= 2;
       bbb   = 2;
 
       a     = 2;
.. code-block:: c++
       /* A comment. */
       double e = 4;
 
       false:
       int d = 3;
       /* A comment. */
       double e = 4;
 
-  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound
-    assignments like ``+=`` are aligned along with ``=``.
+  * ``bool AlignCompound`` Only for ``AlignConsecutiveAssignments``.  Whether compound assignments
+    like ``+=`` are aligned along with ``=``.
 
     .. code-block:: c++
 
       true:
       a   &= 2;
       bbb  = 2;
 
       false:
       a &= 2;
       bbb = 2;
 
-  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short
-    assignment operators are left-padded to the same length as long
-    ones in order to put all assignment operators to the right of
-    the left hand side.
+  * ``bool PadOperators`` Only for ``AlignConsecutiveAssignments``.  Whether short assignment
+    operators are left-padded to the same length as long ones in order to
+    put all assignment operators to the right of the left hand side.
 
     .. code-block:: c++
 
       true:
       a   >>= 2;
       bbb   = 2;
 
       a     = 2;