www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Updated doxygen dfilter

reply Hauke Duden <H.NS.Duden gmx.net> writes:
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

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 20 2004
parent reply Stewart Gordon <smjg_1998 yahoo.com> writes:
Hauke Duden wrote:

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

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
parent reply Hauke Duden <H.NS.Duden gmx.net> writes:
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
May 21 2004
next sibling parent "Matthew" <matthew.hat stlsoft.dot.org> writes:
"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. ;/
Jun 04 2004
prev sibling parent "Matthew" <matthew.hat stlsoft.dot.org> writes:
"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??
Jun 04 2004