Re: pgstat documentation tables - Mailing list pgsql-hackers

From Greg Smith
Subject Re: pgstat documentation tables
Date
Msg-id 4F129DD6.7020206@2ndQuadrant.com
Whole thread Raw
In response to pgstat documentation tables  (Magnus Hagander <magnus@hagander.net>)
Responses Re: pgstat documentation tables  (Magnus Hagander <magnus@hagander.net>)
List pgsql-hackers
On 01/15/2012 03:51 AM, Magnus Hagander wrote:
> I'd like to turn that into one table for each view, with two columns,
> one being the name the other one being the description. That'll also
> make it possible to expand on the descriptions without making it
> completley unreadable, should we want to.

Scott Mead's pg_stat_activity refactoring patch already was forced 
toward doing something similar for its documentation to be readable 
(maybe exactly the same as you were thinking, can't tell because my 
SGML-fu is weak) .  I feel doing this for every view in there is 
inevitable, just a matter of when to bite on the problem.  This whole 
section is barely usable in its current form.  I strongly hope the 
pg_stat_activity patch goes in, which will be close to a compelling 
event to motivate fixing the rest of them in a similar way.  I would 
advocate leading with that one until it seems right, then adopting the 
same style of reorg to the rest until they're all converted.

-- 
Greg Smith   2ndQuadrant US    greg@2ndQuadrant.com   Baltimore, MD
PostgreSQL Training, Services, and 24x7 Support www.2ndQuadrant.com



pgsql-hackers by date:

Previous
From: Greg Smith
Date:
Subject: Re: IDLE in transaction introspection
Next
From: Daniel Farina
Date:
Subject: Review of: pg_stat_statements with query tree normalization