diff options
| author | Sylvestre Ledru <sylvestre@debian.org> | 2017-09-07 12:08:49 +0000 |
|---|---|---|
| committer | Sylvestre Ledru <sylvestre@debian.org> | 2017-09-07 12:08:49 +0000 |
| commit | 44d1ef140b9e82e32b39d26f841b7e73e8d415ea (patch) | |
| tree | 39d5e3a582de348881f8692a23cbcea4460133a0 | |
| parent | e2950f46c66b9a3547839fd4cd3598fb5bfcf412 (diff) | |
| download | bcm5719-llvm-44d1ef140b9e82e32b39d26f841b7e73e8d415ea.tar.gz bcm5719-llvm-44d1ef140b9e82e32b39d26f841b7e73e8d415ea.zip | |
Refresh the clang format options doc with the recent changes
Summary:
Looks like we are out of sync between the doc and the code.
Reviewers: djasper
Reviewed By: djasper
Subscribers: cfe-commits
Differential Revision: https://reviews.llvm.org/D37558
llvm-svn: 312716
| -rw-r--r-- | clang/docs/ClangFormatStyleOptions.rst | 54 |
1 files changed, 41 insertions, 13 deletions
diff --git a/clang/docs/ClangFormatStyleOptions.rst b/clang/docs/ClangFormatStyleOptions.rst index 083f9ea5b7e..3a99ac1cb24 100644 --- a/clang/docs/ClangFormatStyleOptions.rst +++ b/clang/docs/ClangFormatStyleOptions.rst @@ -679,7 +679,7 @@ the configuration (without a prefix: ``Auto``). * ``bool IndentBraces`` Indent the wrapped braces themselves. - * ``bool SplitEmptyFunctionBody`` If ``false``, empty function body can be put on a single line. + * ``bool SplitEmptyFunction`` If ``false``, empty function body can be put on a single line. This option is used only if the opening brace of the function has already been wrapped, i.e. the `AfterFunction` brace wrapping mode is set, and the function could/should not be put on a single line (as per @@ -691,6 +691,28 @@ the configuration (without a prefix: ``Auto``). {} { } + * ``bool SplitEmptyRecord`` If ``false``, empty record (e.g. class, struct or union) body + can be put on a single line. This option is used only if the opening + brace of the record has already been wrapped, i.e. the `AfterClass` + (for classes) brace wrapping mode is set. + + .. code-block:: c++ + + class Foo vs. class Foo + {} { + } + + * ``bool SplitEmptyNamespace`` If ``false``, empty namespace body can be put on a single line. + This option is used only if the opening brace of the namespace has + already been wrapped, i.e. the `AfterNamespace` brace wrapping mode is + set. + + .. code-block:: c++ + + namespace Foo vs. namespace Foo + {} { + } + **BreakAfterJavaFieldAnnotations** (``bool``) Break after each annotation on a field in Java files. @@ -1144,7 +1166,7 @@ the configuration (without a prefix: ``Auto``). IncludeCategories: - Regex: '^"(llvm|llvm-c|clang|clang-c)/' Priority: 2 - - Regex: '^(<|"(gtest|isl|json)/)' + - Regex: '^(<|"(gtest|gmock|isl|json)/)' Priority: 3 - Regex: '.*' Priority: 1 @@ -1180,7 +1202,7 @@ the configuration (without a prefix: ``Auto``). } } **IndentPPDirectives** (``PPDirectiveIndentStyle``) - Indent preprocessor directives on conditionals. + The preprocessor directive indenting style to use. Possible values: @@ -1189,22 +1211,24 @@ the configuration (without a prefix: ``Auto``). .. code-block:: c++ - #if FOO - #if BAR - #include <foo> - #endif - #endif + #if FOO + #if BAR + #include <foo> + #endif + #endif * ``PPDIS_AfterHash`` (in configuration: ``AfterHash``) Indents directives after the hash. .. code-block:: c++ - #if FOO - # if BAR - # include <foo> - # endif - #endif + #if FOO + # if BAR + # include <foo> + # endif + #endif + + **IndentWidth** (``unsigned``) The number of columns to use for indentation. @@ -1318,6 +1342,10 @@ the configuration (without a prefix: ``Auto``). * ``LK_TableGen`` (in configuration: ``TableGen``) Should be used for TableGen code. + * ``LK_TextProto`` (in configuration: ``TextProto``) + Should be used for Protocol Buffer messages in text format + (https://developers.google.com/protocol-buffers/). + **MacroBlockBegin** (``std::string``) |

