From: | David Fetter <david(at)fetter(dot)org> |
---|---|
To: | Chapman Flack <chap(at)anastigmatix(dot)net> |
Cc: | PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: doc: datatype-table and xfunc-c-type-table |
Date: | 2019-04-23 15:57:32 |
Message-ID: | 20190423155732.GD28936@fetter.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Sun, Apr 14, 2019 at 02:49:57AM -0400, Chapman Flack wrote:
> Hi,
>
> Both tables in $subject (in datatype.sgml and xfunc.sgml, respectively)
> contain similar information (though the xfunc one mentions C structs and
> header files, and the datatype one does not, but has a description column)
> and seem similarly out-of-date with respect to the currently supported
> types ... though not identically out-of-date; they have different numbers
> of rows, and different types that are missing.
>
> How crazy an idea would it be to have include/catalog/pg_type.dat
> augmented with description, ctypename, and cheader fields, and let
> both tables be generated, with their respective columns?
Not at all. Although literate programming didn't catch on, having a
single point of truth is generally good practice.
There are almost certainly other parts of the documentation that
should also be generated from the source code, but that's a matter for
separate threads for the cases where that would make sense.
Best,
David.
--
David Fetter <david(at)fetter(dot)org> http://fetter.org/
Phone: +1 415 235 3778
Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate
From | Date | Subject | |
---|---|---|---|
Next Message | Tomas Vondra | 2019-04-23 16:07:40 | Re: finding changed blocks using WAL scanning |
Previous Message | Stephen Frost | 2019-04-23 15:43:05 | Re: finding changed blocks using WAL scanning |