Re: Another modest proposal for docs formatting: catalog descriptions
Tom Lane <tgl@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Fabien COELHO <coelho@cri.ensmp.fr>,
Alvaro Herrera <alvherre@2ndquadrant.com>,
pgsql-docs@lists.postgresql.org,
PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Date: 2020-05-10T16:27:23Z
Lists: pgsql-hackers, pgsql-docs
Attachments
- catalog-reformat.patch.gz (application/x-gzip) patch
- website.patch (text/x-diff) patch
Just FTR, here's a complete patch for this. I successfully regenerated the column names, types, and ordering from the system catalogs, and plugged the descriptions back into that by dint of parsing them out of the XML. The "references" data was based on findoidjoins' results plus hand additions to cover all the cases we are calling out now (there are a lot of "references" links for attnums and a few other non-OID columns, plus references links for views which findoidjoins doesn't consider). So I have pretty high confidence that this info is OK. I'd be too embarrassed to show anybody the code though ;-) ... it was just a brute force hack. regards, tom lane
Commits
-
Doc: reformat catalog/view description tables.
- a042750646db 13.0 landed