Re: pgstat documentation tables

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