postgres.git / summary / log / commit / refs

commit    b4d615aaa1ecedcf1e2ca415cd2893d1f18aeeca
Author:   Peter Eisentraut <peter@eisentraut.org>
Date:     Thu Sep 26 08:51:39 2019 +0000
First released in: 13.0, 12.0

    doc: Update note about source code formatting
    
    Update the note about why not to use // comments, even though it's now
    technically supported.
    
    The note about variable declarations was dropped here because it's
    addressed more properly later in the chapter.
    
    Discussion: https://www.postgresql.org/message-id/flat/156924954640.1117.6309209869705522549%40wrigleys.postgresql.org


 doc/src/sgml/sources.sgml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index 6294312ab7d..25e7763c7c7 100644
--- a/doc/src/sgml/sources.sgml
+++ b/doc/src/sgml/sources.sgml
@@ -26,9 +26,9 @@
    </para>
 
    <para>
-    Do not use C++ style comments (<literal>//</literal> comments).  Strict ANSI C
-    compilers do not accept them.  For the same reason, do not use C++
-    extensions such as declaring new variables mid-block.
+    To maintain a consistent coding style, do not use C++ style comments
+    (<literal>//</literal> comments).  <application>pgindent</application>
+    will replace them with <literal>/* ... */</literal>.
    </para>
 
    <para>


[parent: 66e0ea75bb9d]