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