I think this is all great. You may find some automated assistance from doxygen.postgresql.org .
Sincerely,
JD
doxygen is great as far as it goes, but it does a great job of separating function definition from the comment explaining the function, so I have to drill into the raw source anyway.
Also, doxygen isn't very helpful with macros, and a lot of functions in the internals are actually macros.
