Descent generated documentation

Robert Fraser fraserofthenight at gmail.com
Fri Jul 10 12:01:33 PDT 2009


Steven Schveighoffer wrote:
> On Fri, 10 Jul 2009 01:17:29 -0400, Ary Borenszweig 
> <ary at esperanto.org.ar> wrote:
> 
>> Ary Borenszweig escribió:
>>> Hi all!
>>>  So... I've been playing around with generating ddocs from Descent.
>>>  phobos: http://downloads.dsource.org/projects/descent/ddoc/phobos/
>>> Tango: http://downloads.dsource.org/projects/descent/ddoc/tango/
>>
>> I've updated the docs. New things:
>>
>> - Visibility is respected
>> - Everything except templates are listed (also nested types are listed)
>> - Modifiers are shown
>> - Public imports are listed (but it doesn't work quite well, I'll 
>> check it)
>> - Module level documentation is shown
>> - Inherited methods are shown
>>
>> Still no expand/collapse thingy.
> 
> /me cleans up pool of drool on desk.
> 
> One preference, if it's possible, is to copy the description of 
> inherited methods from the base class.  Even if not the entire 
> documentation, just a summary, first sentence from the documentation.
> 
> Already it's better than ddoc.  Nice work!
> 
> -Steve

me too

Also, I think Javadoc's tables are easier to read. The "list" view of 
this looks better, but it's difficult to differentiate what is what. 
Javadoc's tables & lines give a clear separation between sections. Just 
my bikeshed.


More information about the Digitalmars-d-announce mailing list