mirrors/llvm-project
0
0
Fork 0
mirror of https://github.com/llvm/llvm-project.git synced 2025-04-25 20:56:06 +00:00
Code Issues Projects Releases Wiki Activity

Clarify the statement on using #if 0 ... #endif in CodingStandards.

Browse Source 
The statement on using #if 0 ... #endif is not very clear (for people like me
:-)). This patch clarifies it a bit to avoid confusion.

Differential Revision: https://reviews.llvm.org/D23404

llvm-svn: 278932
This commit is contained in:
Andrey Bokhanko 2016-08-17 14:53:18 +00:00
parent 545afafb70
commit 7d7bacbafa
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
llvm/docs/CodingStandards.rst
View File

@ -309,8 +309,10 @@ useful to use C style (``/* */``) comments however:
#. When writing a source file that is used by a tool that only accepts C style
comments.
To comment out a large block of code, use ``#if 0`` and ``#endif``. These nest
properly and are better behaved in general than C style comments.
Commenting out large blocks of code is discouraged, but if you really have to do
this (for documentation purposes or as a suggestion for debug printing), use
``#if 0`` and ``#endif``. These nest properly and are better behaved in general
than C style comments.
Doxygen Use in Documentation Comments
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^