Re: Soliciting Feedback on Improving Server-Side Programming Documentation

From: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
Cc: PG <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Soliciting Feedback on Improving Server-Side Programming Documentation
Date: 2016-03-15 17:27:04
Message-ID: CADkLM=eSqiw2RnNggiAVKNnMaTN=WzPjA6198tUXaq87MQcRFQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

>
>
> 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.

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Corey Huinker 2016-03-15 17:30:56 Re: Soliciting Feedback on Improving Server-Side Programming Documentation
Previous Message Michael Paquier 2016-03-15 17:21:34 Re: WAL logging problem in 9.4.3?