r249394 - clang-format: Add empty line before code-blocks in Docs.
Daniel Jasper via cfe-commits
cfe-commits at lists.llvm.org
Tue Oct 6 05:11:52 PDT 2015
Author: djasper
Date: Tue Oct 6 07:11:51 2015
New Revision: 249394
URL: http://llvm.org/viewvc/llvm-project?rev=249394&view=rev
Log:
clang-format: Add empty line before code-blocks in Docs.
Modified:
cfe/trunk/docs/ClangFormatStyleOptions.rst
cfe/trunk/docs/tools/dump_format_style.py
Modified: cfe/trunk/docs/ClangFormatStyleOptions.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/ClangFormatStyleOptions.rst?rev=249394&r1=249393&r2=249394&view=diff
==============================================================================
--- cfe/trunk/docs/ClangFormatStyleOptions.rst (original)
+++ cfe/trunk/docs/ClangFormatStyleOptions.rst Tue Oct 6 07:11:51 2015
@@ -155,6 +155,7 @@ the configuration (without a prefix: ``A
This applies to round brackets (parentheses), angle brackets and square
brackets. This will result in formattings like
+
.. code-block:: c++
someLongFunction(argument1,
argument2);
@@ -164,6 +165,7 @@ the configuration (without a prefix: ``A
This will align the assignment operators of consecutive lines. This
will result in formattings like
+
.. code-block:: c++
int aaaa = 12;
int b = 23;
@@ -174,6 +176,7 @@ the configuration (without a prefix: ``A
This will align the declaration names of consecutive lines. This
will result in formattings like
+
.. code-block:: c++
int aaaa = 12;
float b = 23;
@@ -389,11 +392,13 @@ the configuration (without a prefix: ``A
instead of as function calls.
These are expected to be macros of the form:
+
.. code-block:: c++
FOREACH(<variable-declaration>, ...)
<loop-body>
In the .clang-format configuration file, this can be configured like:
+
.. code-block:: c++
ForEachMacros: ['RANGES_FOR', 'FOREACH']
@@ -415,6 +420,7 @@ the configuration (without a prefix: ``A
(http://llvm.org/docs/CodingStandards.html#include-style).
To configure this in the .clang-format file, use:
+
.. code-block:: c++
IncludeCategories:
- Regex: '^"(llvm|llvm-c|clang|clang-c)/'
Modified: cfe/trunk/docs/tools/dump_format_style.py
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/tools/dump_format_style.py?rev=249394&r1=249393&r2=249394&view=diff
==============================================================================
--- cfe/trunk/docs/tools/dump_format_style.py (original)
+++ cfe/trunk/docs/tools/dump_format_style.py Tue Oct 6 07:11:51 2015
@@ -87,7 +87,7 @@ class EnumValue:
def clean_comment_line(line):
if line == '/// \\code':
- return '.. code-block:: c++\n'
+ return '\n.. code-block:: c++\n'
if line == '/// \\endcode':
return ''
return line[4:] + '\n'
More information about the cfe-commits
mailing list