httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sander Temme <san...@temme.net>
Subject Re: Doxygen
Date Fri, 19 Aug 2005 17:05:18 GMT
Hi Neale,

On Aug 19, 2005, at 7:55 AM, Neale Ranns wrote:

> Over the past few days i've been reading around the source code and
> improving the doxygen documentation. You can see the results here.
>
> http://www.ranns.org/~ndrr/apache2/dox/html/index.html

Very cool. Could you produce a patch using diff -u? What version of  
the source code are you working with?

Thanks,

Sander

> Essentially what i have done is:
>  1) change all the @package (since these generate "Namespaces") to
> @defgroup (which produces the grouping in the "Modules" page)
>  2) Added lots more @defgroup to get the module grouping on the
> "Modules" page
>  3) Add a @file and @brief to each header file to improve the "File
> List" page
>  4) Did some improvements to function and struct declarations;  
> though by
> no means all. There is a long way to go.
>  5) lastly i changed the doxygen.conf file:
>     a) to make the output searchable
>     b) to extract everything (otherwise the undocumented stuff is  
> left out)
>     c) added a hack so the CORE_PRIVATE stuff is included
>     d) fixed the STRIP_FROM_PATH problem, by setting it to
> "STRIP_FROM_PATH=" which implies, the directory from which doxygen is
> run. It is possible to do with autoconf but more complicated.
>
> comments always welcome :)
>
> thanks
> neale
>


-- 
sander@temme.net              http://www.temme.net/sander/
PGP FP: 51B4 8727 466A 0BC3 69F4  B7B8 B2BE BC40 1529 24AF


Mime
View raw message