View mode: basic / threaded / horizontal-split · Log in · Help
May 20, 2004
Updated doxygen dfilter
I made two small modifications to the D filter for doxygen.

- the code now compiles with DMD 0.89 (fixed a few casts)
- private module(!) members are now removed, since doxygen does not 
recognize them as private. Previously they were included in the docs.

Source code and executable attached.


Hauke
May 21, 2004
Re: Updated doxygen dfilter
Hauke Duden wrote:

> I made two small modifications to the D filter for doxygen.
<snip>

I finally tried it out last night.  Naturally the cast syntax was the 
first thing I fixed.  And after that, de-obfuscated it a bit....

I also noticed that it doesn't even try to understand attribute blocks. 
   I got this working with access modifiers, but not with other 
attributes.  Also, I'm getting ugly mistakings of module and import 
statements for variable declarations - this should be an easy fix.

I'll try and do more, like merging your fix with mine....

Stewart.

-- 
My e-mail is valid but not my primary mailbox, aside from its being the 
unfortunate victim of intensive mail-bombing at the moment.  Please keep 
replies on the 'group where everyone may benefit.
May 21, 2004
Re: Updated doxygen dfilter
Stewart Gordon wrote:
> Hauke Duden wrote:
> 
>> I made two small modifications to the D filter for doxygen.
> 
> <snip>
> 
> I finally tried it out last night.  Naturally the cast syntax was the 
> first thing I fixed.  And after that, de-obfuscated it a bit....
> 
> I also noticed that it doesn't even try to understand attribute blocks. 
>    I got this working with access modifiers, but not with other 
> attributes.  Also, I'm getting ugly mistakings of module and import 
> statements for variable declarations - this should be an easy fix.
> 
> I'll try and do more, like merging your fix with mine....

Yes, it kind of shows that multiple people have worked on it and all of 
them were only "quickly hacking in" some new functionality (like myself) ;).

Maybe the Doxygen Filter should be added as a project to dsource.org? I 
thought about doing this before but I don't really have the time to 
maintain another project. If you or someone else would assume the role 
of project maintainer that would be great. It would create a central 
place where you can get the most recent version and where to send patches.

Any interest?

Hauke
June 04, 2004
Re: Updated doxygen dfilter
"Hauke Duden" <H.NS.Duden@gmx.net> wrote in message
news:c8km1i$2g59$1@digitaldaemon.com...
> Stewart Gordon wrote:
> > Hauke Duden wrote:
> >
> >> I made two small modifications to the D filter for doxygen.
> >
> > <snip>
> >
> > I finally tried it out last night.  Naturally the cast syntax was the
> > first thing I fixed.  And after that, de-obfuscated it a bit....
> >
> > I also noticed that it doesn't even try to understand attribute blocks.
> >    I got this working with access modifiers, but not with other
> > attributes.  Also, I'm getting ugly mistakings of module and import
> > statements for variable declarations - this should be an easy fix.
> >
> > I'll try and do more, like merging your fix with mine....
>
> Yes, it kind of shows that multiple people have worked on it and all of
> them were only "quickly hacking in" some new functionality (like myself) ;).
>
> Maybe the Doxygen Filter should be added as a project to dsource.org? I
> thought about doing this before but I don't really have the time to
> maintain another project. If you or someone else would assume the role
> of project maintainer that would be great. It would create a central
> place where you can get the most recent version and where to send patches.
>
> Any interest?

Much interest, but time constrains me to only offer interest as a user. ;/
June 04, 2004
Re: Updated doxygen dfilter
"Hauke Duden" <H.NS.Duden@gmx.net> wrote in message
news:c8km1i$2g59$1@digitaldaemon.com...
> Stewart Gordon wrote:
> > Hauke Duden wrote:
> >
> >> I made two small modifications to the D filter for doxygen.
> >
> > <snip>
> >
> > I finally tried it out last night.  Naturally the cast syntax was the
> > first thing I fixed.  And after that, de-obfuscated it a bit....
> >
> > I also noticed that it doesn't even try to understand attribute blocks.
> >    I got this working with access modifiers, but not with other
> > attributes.  Also, I'm getting ugly mistakings of module and import
> > statements for variable declarations - this should be an easy fix.
> >
> > I'll try and do more, like merging your fix with mine....
>
> Yes, it kind of shows that multiple people have worked on it and all of
> them were only "quickly hacking in" some new functionality (like myself) ;).
>
> Maybe the Doxygen Filter should be added as a project to dsource.org? I
> thought about doing this before but I don't really have the time to
> maintain another project. If you or someone else would assume the role
> of project maintainer that would be great. It would create a central
> place where you can get the most recent version and where to send patches.
>
> Any interest?

btw, I think we should adopt Doxygen as the documentor for Phobos until such time
as something in-house and better comes along.

Any takers??
Top | Discussion index | About this forum | D home