Update src/tools/pginclude/README to match recent changes to cpluspluscheck
authorPeter Eisentraut
Thu, 18 Apr 2024 09:32:22 +0000 (11:32 +0200)
committerPeter Eisentraut
Thu, 18 Apr 2024 09:37:01 +0000 (11:37 +0200)
Commit 7b8e2ae2f has turned cpluspluscheck from separate script into a
--cplusplus option for headerscheck.  Update README correspondingly.

Author: Anton Voloshin 
Discussion: https://www.postgresql.org/message-id/02e69fa9-885d-4f41-9057-15a1d212eaf8@postgrespro.ru

src/tools/pginclude/README

index 712eca76fb33c759e17f8bba90e2a44d3de8d0ec..a685940da952cea744716c9e7279318f7a1010c0 100644 (file)
@@ -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