Robert Haas <robertmhaas@gmail.com> writes:
> On Tue, Jan 18, 2011 at 6:49 PM, Simone Aiken
> <saiken@quietlycompetent.com> wrote:
>> Pages like this one have column comments for the system tables:
>>
>> http://www.psql.it/manuale/8.3/catalog-pg-attribute.html
> Oh, I see. I don't think we want to go there. We'd need some kind of
> system for keeping the two places in sync.
I seem to recall some muttering about teaching genbki to extract such
comments from the SGML sources or perhaps the C header files. I tend to
agree though that it would be a lot more work than it's worth. And as
you say, pg_description entries aren't free.
Which brings up another point though. I have a personal TODO item to
make the comments for operator support functions more consistent:
http://archives.postgresql.org/message-id/21407.1287157253@sss.pgh.pa.us
Should we consider removing those comments altogether, instead?
regards, tom lane