[prev in list] [next in list] [prev in thread] [next in thread] 

List:       apache-httpd-dev
Subject:    Re: Doxygen
From:       Ian Holsman <lists () holsman ! net>
Date:       2005-08-28 22:15:01
Message-ID: 43123765.7040109 () holsman ! net
[Download RAW message or body]

Hi Neale.

I'll go through and review the patch today.
I'll try to get it commited in a couple of hours.


Neale Ranns wrote:
> Sander,
> 
> I put a patch here (http://www.ranns.org/~ndrr/apache2/), it's kinda big
> to be emailing to all. There is also a tar ball there of the html files
> if anyone would like a copy.
> i am working from an up to date version of the svn trunk.


> 
> thnaks
> neale
> 
> On Fri, 2005-08-19 at 19:05, Sander Temme wrote:
>> 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
>>>
> 

[prev in list] [next in list] [prev in thread] [next in thread]