Re: source documentation tool doxygen - Mailing list pgsql-hackers

From Andrew Dunstan
Subject Re: source documentation tool doxygen
Date
Msg-id 38611.68.143.134.146.1137419873.squirrel@www.dunslane.net
Whole thread Raw
In response to Re: source documentation tool doxygen  (Thomas Hallgren <thomas@tada.se>)
Responses Re: source documentation tool doxygen
Re: source documentation tool doxygen
List pgsql-hackers
Thomas Hallgren said:
> I wish I've had this when I started working with PostgreSQL. This looks
> really good. Very  useful indeed, even without the comments. What kind
> of changes are needed in order to get  the comments in?
>

I too have done this. But retrofitting Doxygen style comments to the
PostgreSQL source code would be a big undertaking. Maintaining it, which
would be another task for reviewers/committers, would also be a pain unless
there were some automated checking tool.

cheers

andrew




pgsql-hackers by date:

Previous
From: Kim Bisgaard
Date:
Subject: Re: source documentation tool doxygen
Next
From: "R, Rajesh (STSD)"
Date:
Subject: [PATCH] Better way to check for getaddrinfo function.