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? 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 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 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?
 
 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
 
 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
 
 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...

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