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(at)2ndQuadrant(dot)com Baltimore, MD
PostgreSQL Training, Services, and 24x7 Support www.2ndQuadrant.com