Mike Mascari <mascarm(at)mascari(dot)com> writes:
> I was wondering in the past if it would simply be better to have an
> .SQL script which is submitted to the template1 database at
> post-initdb time with COMMENT ON statements to document built-in
> types, functions, system relations, etc.
The nice thing about the way it's done now is that the descriptions
sit right next to the defining commands in the catalog/*.h files.
Having to maintain a separate script file doesn't seem like a win.
Almost certainly, the descriptions would be poorly maintained ---
ye olde out-of-sight, out-of-mind problem.
regards, tom lane