mirror/postgresql
2
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2025-02-23 19:39:53 +08:00
Code Issues Packages Projects Releases Wiki Activity

Doc: update src/tools/pginclude/README.

Browse Source 
Commit f62975b2a made headerscheck and cpluspluscheck a little
smarter than this documentation gave them credit for.  Make
their docs match current reality.  Also add a warning about the
layer of dust that has settled on the rest of these scripts.

Discussion: https://postgr.es/m/769950.1684797558@sss.pgh.pa.us
This commit is contained in:
Tom Lane 2023-05-23 18:51:43 -04:00
parent 5df5bea290
commit be3f62ae6e
1 changed files with 15 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
src/tools/pginclude/README
View File

@ -1,5 +1,12 @@
src/tools/pginclude/README 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.
pginclude pginclude
========= =========
@ -71,10 +78,10 @@ the top-level build directory after completing a build. You should
have included "--with-perl --with-python" in your configure options, have included "--with-perl --with-python" in your configure options,
else you're likely to get errors about related headers not being found. else you're likely to get errors about related headers not being found.
A limitation of the current script is that it doesn't know which headers A limitation of the current script is that it doesn't know exactly which
are for frontend or backend, so it tests everything with postgres.h headers are for frontend or backend; when in doubt it uses postgres.h as
as prerequisite, even if postgres_fe.h would be more appropriate. Also prerequisite, even if postgres_fe.h or c.h would be more appropriate.
note that the contents of macros are not checked; this is intentional. Also note that the contents of macros are not checked; this is intentional.
cpluspluscheck cpluspluscheck
@ -97,7 +104,7 @@ If you are using a non-g++-compatible C++ compiler, you may need to
override the script's CXXFLAGS setting by setting a suitable environment override the script's CXXFLAGS setting by setting a suitable environment
value. value.
A limitation of the current script is that it doesn't know which headers A limitation of the current script is that it doesn't know exactly which
are for frontend or backend, so it tests everything with postgres.h headers are for frontend or backend; when in doubt it uses postgres.h as
as prerequisite, even if postgres_fe.h would be more appropriate. Also prerequisite, even if postgres_fe.h or c.h would be more appropriate.
note that the contents of macros are not checked; this is intentional. Also note that the contents of macros are not checked; this is intentional.