postgres.git / summary / log / commit / refs

commit    e0d51e3bf45436bdf84d096916daea2af2c7ba6e
Author:   Peter Eisentraut <peter@eisentraut.org>
Date:     Thu Apr 18 09:32:22 2024 +0000
First released in: 17.0

    Update src/tools/pginclude/README to match recent changes to cpluspluscheck
    
    Commit 7b8e2ae2f has turned cpluspluscheck from separate script into a
    --cplusplus option for headerscheck.  Update README correspondingly.
    
    Author: Anton Voloshin <a.voloshin@postgrespro.ru>
    Discussion: https://www.postgresql.org/message-id/02e69fa9-885d-4f41-9057-15a1d212eaf8@postgrespro.ru


 src/tools/pginclude/README | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/src/tools/pginclude/README b/src/tools/pginclude/README
index 712eca76fb3..a685940da95 100644
--- a/src/tools/pginclude/README
+++ b/src/tools/pginclude/README
@@ -1,10 +1,11 @@
 src/tools/pginclude/README
 
-NOTE: headerscheck and cpluspluscheck are in current use, and any
-problems they find should generally get fixed.  The other scripts
-in this directory have not been used in some time, and have issues.
-pgrminclude in particular has a history of creating more problems
-than it fixes.  Be very wary of applying their results blindly.
+NOTE: headerscheck and headerscheck --cplusplus are in current use,
+and any problems they find should generally get fixed.  The other
+scripts in this directory have not been used in some time, and have
+issues.  pgrminclude in particular has a history of creating more
+problems than it fixes.  Be very wary of applying their results
+blindly.
 
 
 pginclude
@@ -84,16 +85,17 @@ prerequisite, even if postgres_fe.h or c.h would be more appropriate.
 Also note that the contents of macros are not checked; this is intentional.
 
 
-cpluspluscheck
-==============
+headerscheck --cplusplus
+========================
 
-This script can be run to verify that all Postgres include files meet
-the project convention that they will compile as C++ code.  Although
-the project's coding language is C, some people write extensions in C++,
-so it's helpful for include files to be C++-clean.
+The headerscheck in --cplusplus mode can be run to verify that all
+Postgres include files meet the project convention that they will
+compile as C++ code.  Although the project's coding language is C,
+some people write extensions in C++, so it's helpful for include files
+to be C++-clean.
 
 A small number of header files are exempted from this requirement,
-and are skipped by the cpluspluscheck script.
+and are skipped by the script in the --cplusplus mode.
 
 The easy way to run the script is to say "make -s cpluspluscheck" in
 the top-level build directory after completing a build.  You should


[parent: 2c7cea5a8e74]