Re: pgstat documentation tables - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: pgstat documentation tables
Date
Msg-id 20120208161357.GF24440@momjian.us
Whole thread Raw
In response to Re: pgstat documentation tables  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: pgstat documentation tables  (Magnus Hagander <magnus@hagander.net>)
List 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. +


pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Progress on fast path sorting, btree index creation time
Next
From: Tom Lane
Date:
Subject: Re: Text-any concatenation volatility acting as optimization barrier