> Bulk? Redundancy with the SGML documentation? > > There are already more than enough places to have to edit documentation > when we change/add a column in a system catalog. I don't see the value > of adding another, especially not one that's constrained to one line. > And what will comments on, say, system indexes contribute really?
Maybe it would not be that bad if the comments could be derived automatically from the sgml documentation? At least for comments that are not provided directly from the initialization phase? That may involve designing a new tag for the sgml. Something like <shortdescr>... to specify the object name, its type and its description, so that some filter could derive the appropriate "COMMENT ON". I appreciate having something to read on a "\d+" in psql, without having to turn to the online doc. -- Fabien Coelho - [EMAIL PROTECTED] ---------------------------(end of broadcast)--------------------------- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faqs/FAQ.html