Re: pgstat documentation tables
Bruce Momjian <bruce@momjian.us>
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Alvaro Herrera <alvherre@commandprompt.com>, Greg Smith <greg@2ndquadrant.com>, Pg Hackers <pgsql-hackers@postgresql.org>
Date: 2012-02-08T16:13:57Z
Lists: pgsql-hackers
On Tue, Feb 07, 2012 at 11:29:12PM -0500, Tom Lane wrote: > Bruce Momjian <bruce@momjian.us> writes: > > How do people feel about pulling text out of the SGML docs and loading > > it into the database as table and column comments? > > I'm not thrilled by that proposal. The length limits on comments are > very much shorter than what is sensible to use in catalogs.sgml (at > least if you want the comments to look passable in \d displays). And > I don't want people trying to serve two different use-cases when they > write those. I was thinking of just grabbing the first X characters from the SGML comments. > Perhaps it'd work to pull column comments from the C header files > --- any same-line comment in catalog/pg_*.h is probably short enough to > serve this purpose usefully. Yes, that would be simpler. -- Bruce Momjian <bruce@momjian.us> http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. +