DSSS, Dsource, and cpan

[Brad Anderson]

Anders F Björklund wrote:
> 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

There is no UI for project admins to make changes by themselves yet, but the
Tango docs are fully automated.

http://dsource.org/projects/tango/docs/current/

I've set this up, so that in the future, these things can be achieved with
each project...

BA