OSchip
/
llvm-project
mirror of https://github.com/THU-DSP-LAB/llvm-project.git
13
0
Fork 6
Code Issues Packages Projects Releases Wiki Activity

[clang-format][NFC] Improve documentation of FixNamespaceComments 

Fixes https://github.com/llvm/llvm-project/issues/55162
This commit is contained in:
Björn Schäpers 2022-11-12 05:51:19 +01:00
parent 40c1476e3a
commit cb01befda5
2 changed files with 16 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
clang/docs/ClangFormatStyleOptions.rst
View File

@ -2696,16 +2696,19 @@ the configuration (without a prefix: ``Auto``).
**FixNamespaceComments** (``Boolean``) :versionbadge:`clang-format 5`
If ``true``, clang-format adds missing namespace end comments for
short namespaces and fixes invalid existing ones. Short ones are
controlled by "ShortNamespaceLines".
namespaces and fixes invalid existing ones. This doesn't affect short
namespaces, which are controlled by ``ShortNamespaceLines``.
.. code-block:: c++
true: false:
namespace a { vs. namespace a {
foo(); foo();
bar(); bar();
namespace longNamespace { vs. namespace longNamespace {
void foo(); void foo();
void bar(); void bar();
} // namespace a }
namespace shortNamespace { namespace shortNamespace {
void baz(); void baz();
} }
**ForEachMacros** (``List of Strings``) :versionbadge:`clang-format 3.7`
A vector of macros that should be interpreted as foreach loops

13
clang/include/clang/Format/Format.h
View File

@ -2121,14 +2121,17 @@ struct FormatStyle {
bool ExperimentalAutoDetectBinPacking;
/// If ``true``, clang-format adds missing namespace end comments for
/// short namespaces and fixes invalid existing ones. Short ones are
/// controlled by "ShortNamespaceLines".
/// namespaces and fixes invalid existing ones. This doesn't affect short
/// namespaces, which are controlled by ``ShortNamespaceLines``.
/// \code
/// true: false:
/// namespace a { vs. namespace a {
/// foo(); foo();
/// bar(); bar();
/// namespace longNamespace { vs. namespace longNamespace {
/// void foo(); void foo();
/// void bar(); void bar();
/// } // namespace a }
/// namespace shortNamespace { namespace shortNamespace {
/// void baz(); void baz();
/// } }
/// \endcode
/// \version 5
bool FixNamespaceComments;