From: Daniel Jasper Date: Tue, 6 Oct 2015 12:11:51 +0000 (+0000) Subject: clang-format: Add empty line before code-blocks in Docs. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c8ebad79a50382d4931263f66271da3fdba670f5;p=clang clang-format: Add empty line before code-blocks in Docs. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@249394 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/ClangFormatStyleOptions.rst b/docs/ClangFormatStyleOptions.rst index fd14d90ff5..7d31a5869c 100644 --- a/docs/ClangFormatStyleOptions.rst +++ b/docs/ClangFormatStyleOptions.rst @@ -155,6 +155,7 @@ the configuration (without a prefix: ``Auto``). 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: ``Auto``). 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: ``Auto``). 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: ``Auto``). instead of as function calls. These are expected to be macros of the form: + .. code-block:: c++ FOREACH(, ...) 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: ``Auto``). (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)/' diff --git a/docs/tools/dump_format_style.py b/docs/tools/dump_format_style.py index 8d1323e8a1..3c04171044 100755 --- a/docs/tools/dump_format_style.py +++ b/docs/tools/dump_format_style.py @@ -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'