On Mon May 22, 2023 at 10:28 AM CDT, Tom Lane wrote:
> >> Some files were missing information from the c.h header.
>
> > Actually, these omissions are intentional, and we have bespoke handling
> > for this in our own header-checking scripts (src/tools/pginclude). I
> > imagine this is documented somewhere, but ATM I can't remember where.
> > (And if not, maybe that's something we should do.)
>
> Yeah, the general policy is that .h files should not explicitly include
> c.h (nor postgres.h nor postgres_fe.h). Instead, .c files should include
> the appropriate one of those three files first. This allows sharing of
> .h files more easily across frontend/backend/common environments.
>
> I'm not sure where this is documented either.
Thanks for the added context. I'll try to keep this in mind going
forward.
--
Tristan Partin
Neon (https://neon.tech)