Doxygen 1.4.2 has been released, with some D fixes.
http://www.stack.nl/~dimitri/doxygen/
http://www.prowiki.org/wiki4d/wiki.cgi?DoxygenIssues


There is still a lot left to do, and it may always
be required to run a "dfilter" before Doxygen, but
it is very useful already (much like D itself) and
it's not like D has another doc tool ready to go ?

(although I know both "ddoc" and "leds" have been
working on custom documentation generators for D)


Turn-around time from bug reported to bug fixed
was three weeks... I don't think that says anything
about Dmitri being "better" than Walter, just that
the Doxygen infrastructure is a lot better than D's ?

--anders

Anders F Björklund wrote:
> Doxygen 1.4.2 has been released, with some D fixes.
> http://www.stack.nl/~dimitri/doxygen/
> http://www.prowiki.org/wiki4d/wiki.cgi?DoxygenIssues

Excellent!

> There is still a lot left to do, and it may always
> be required to run a "dfilter" before Doxygen, but
> it is very useful already (much like D itself) and
> it's not like D has another doc tool ready to go ?

How complete is the "Left to do" list on the wiki page now?  For example, what about the failings I listed here?

http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/11272

(I guess that fixing the file extension check will have fixed a few things....)

Dfilter can certainly shrink now.  When someone's got time, let's go through Dfilter and see how much of it is still needed.  AFAIK the best version is

http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/7994

And we should probably consider what to do with James Dunne's divergent modification(s)

http://svn.dsource.org/svn/projects/bindings/trunk/dfilter.d

while keeping this in mind

http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/18884

Stewart.

-- 
My e-mail is valid but not my primary mailbox.  Please keep replies on on the 'group where everyone may benefit.

Stewart Gordon wrote:

> How complete is the "Left to do" list on the wiki page now?  For example, what about the failings I listed here?
> 
> http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/11272
> 
> (I guess that fixing the file extension check will have fixed a few things....)

This version (1.4.2) enables the "D mode" for the FIRST time...

It still has a lot of problems. But at least modules are now
treated as namespaces, and it recognizes a few more keywords.

Interfaces are also recognized, along with the ctors/dtors.
Semicolons are no longer required after classes and structs.

We should probably make some kind of test for it, like Dstress ?

> Dfilter can certainly shrink now.  When someone's got time, let's go through Dfilter and see how much of it is still needed.  AFAIK the best version is
> 
> http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/7994
> 
> And we should probably consider what to do with James Dunne's divergent modification(s)
> 
> http://svn.dsource.org/svn/projects/bindings/trunk/dfilter.d
> 
> while keeping this in mind
> 
> http://www.digitalmars.com/drn-bin/wwwnews?digitalmars.D/18884

Yeah, merging them all into one updated dfilter would be good.

It still needs to handle debug() and version(), which confuses
Doxygen. And of course, templates and mixins could well do too...

It doesn't recognize "alias", so you need to filter that to
"typedef" which is recognized as the same thing in C/C++.

There is still no support for the D comments, /+ +/, either.

extern(C) in front of functions is also a source of confusion.

--anders

Anders F Björklund wrote:
<snip>
> Interfaces are also recognized, along with the ctors/dtors.
> Semicolons are no longer required after classes and structs.

Experiment with this a bit more....

> We should probably make some kind of test for it, like Dstress ?

You're probably right.

<snip>
> Yeah, merging them all into one updated dfilter would be good.
> 
> It still needs to handle debug() and version(), which confuses
> Doxygen. And of course, templates and mixins could well do too...
<snip>

I've done a bit of experimenting, and I'm working on this updated Dfilter and how to revamp support for attribute blocks.  Expect to see it next week.

Stewart.

-- 
My e-mail is valid but not my primary mailbox.  Please keep replies on the 'group where everyone may benefit.

Stewart Gordon wrote:

>> We should probably make some kind of test for it, like Dstress ?
> 
> You're probably right.

I guess a bunch of simple .d files would do, to check what
kind of docs that it generates - with and without "dfilter" ?

My own D code has been kind of simple, mostly ported C and Java,
so no fancy templates or mixins nor lots of versions and aliases.

> I've done a bit of experimenting, and I'm working on this updated Dfilter and how to revamp support for attribute blocks.  Expect to see it next week.

Excellent! I've found that bug fixes to Doxygen are both
welcome and quickly integrated, if reported via Bugzilla.

http://bugzilla.gnome.org/buglist.cgi?product=doxygen&bug_status=UNCONFIRMED

Objective-C and D are not primary languages of Doxygen,
but support has been added for both in the last versions.

--anders