diff options
author | Peter Eisentraut <peter@eisentraut.org> | 2024-04-18 11:32:22 +0200 |
---|---|---|
committer | Peter Eisentraut <peter@eisentraut.org> | 2024-04-18 11:37:01 +0200 |
commit | e0d51e3bf45436bdf84d096916daea2af2c7ba6e (patch) | |
tree | 3b85e8f41c5f3a8e81b01fc5f89d108d4333a1b0 | |
parent | 2c7cea5a8e741b7f7f9f12700d59b49b376301a1 (diff) | |
download | postgresql-e0d51e3bf45436bdf84d096916daea2af2c7ba6e.tar.gz postgresql-e0d51e3bf45436bdf84d096916daea2af2c7ba6e.zip |
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
-rw-r--r-- | src/tools/pginclude/README | 26 |
1 files 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 |