Re: pgsql: doc: clarify where to find pg_type_d.h (PG 11+) and pg_type.h - Mailing list pgsql-committers

From Alvaro Herrera
Subject Re: pgsql: doc: clarify where to find pg_type_d.h (PG 11+) and pg_type.h
Date
Msg-id 20201112202900.GA28098@alvherre.pgsql
Whole thread Raw
In response to pgsql: doc: clarify where to find pg_type_d.h (PG 11+) and pg_type.h  (Bruce Momjian <bruce@momjian.us>)
Responses Re: pgsql: doc: clarify where to find pg_type_d.h (PG 11+) and pg_type.h
List pgsql-committers
On 2020-Nov-12, Bruce Momjian wrote:

> doc:  clarify where to find pg_type_d.h (PG 11+) and pg_type.h
> 
> These files are in compiled directories and install directories.

I think this patch is wrong, because in the install tree the files are in
the server/ subdir.  It should read:

    The <acronym>OID</acronym>s of the built-in data types are defined in
    the file <filename>include/catalog/pg_type_d.h</filename> in the
    compiled source directory, and in
    <filename>include/server/catalog/pg_type_d.h</filename> in the install
    directory.

That said, if the user is doing a VPATH build, then "compiled source
directory" is a confusing way to say "the build directory", and I don't
think it's an important location anyway, first because it's really a
throwaway directory, and second it's not even there in a packaged
installation; users just care about the *installed* file, don't they?
So I suggest to rip that part out, and leave just:

    The <acronym>OID</acronym>s of the built-in data types are defined in
    the file <filename>include/server/catalog/pg_type_d.h</filename> in the
    install directory.



pgsql-committers by date:

Previous
From: Bruce Momjian
Date:
Subject: pgsql: doc: clarify where to find pg_type_d.h (PG 11+) and pg_type.h
Next
From: Erik Rijkers
Date:
Subject: Re: pgsql: docs: mention that expression indexes need analyze