DSSS, Dsource, and cpan

Anders F Björklund afb at algonet.se
Wed Apr 11 23:40:06 PDT 2007


David B. Held wrote:

>> Not all projects use ddoc, some use for instance Doxygen instead...
> 
> All CPAN projects use PerlDoc, even though it's not the greatest 
> documentation system ever invented.  However, there is something to be 
> said for having consistent-looking documentation across an archive as 
> big as CPAN.  That doesn't preclude the library author from having 
> supplemental documentation in their favorite format, but I think it's 
> perfectly reasonable to at least require a library overview in DDoc, for 
> ease of integration.

Well, my only problem with Ddoc now is that it looks like:
http://wxd.sourceforge.net/ddoc/

But if required I can make it available, along the usual:
http://wxd.sourceforge.net/api/

Looking at four (there are many more) different language
bindings for wxWidgets, each of them with their own native
documentation comments. So Doxygen was only used to share
comments, since it "works" with all (C, C#, Java, and D)

The original API docs are in tex, and stand-alone, anyway.
http://wxwidgets.org/manuals/2.6/wx_classref.html

I guess it's still possible to copy all those over manually,
but still looking for a more automated approach, if doable.

--anders



More information about the Digitalmars-d mailing list