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