www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.announce - Doxygen updated

reply =?ISO-8859-1?Q?Anders_F_Bj=F6rklund?= <afb algonet.se> writes:
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
Mar 30 2005
parent reply Stewart Gordon <smjg_1998 yahoo.com> writes:
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.
Mar 30 2005
parent reply =?ISO-8859-1?Q?Anders_F_Bj=F6rklund?= <afb algonet.se> writes:
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
Mar 31 2005
parent reply Stewart Gordon <smjg_1998 yahoo.com> writes:
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.
Apr 08 2005
parent =?ISO-8859-1?Q?Anders_F_Bj=F6rklund?= <afb algonet.se> writes:
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
Apr 08 2005