Re: Descent generated documentation

2009-07-11 Thread Ary Borenszweig
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/ Who wants to drool? :) I updated the docs once more. *Now

Re: Descent generated documentation

2009-07-11 Thread Lutger
*drools* Some more wishes: D2 support? Couple of minor suggestions for the aesthetics (this is a matter of taste too of course): - make the declarations stand out more, bold font or something. - all the non-comments stuff should be in a different, monospace font - parameters names in italic

Re: Descent generated documentation

2009-07-11 Thread Nick B
Lutger wrote: *drools* Some more wishes: D2 support? Couple of minor suggestions for the aesthetics (this is a matter of taste too of course): - make the declarations stand out more, bold font or something. - all the non-comments stuff should be in a different, monospace font -

Re: Descent generated documentation

2009-07-10 Thread Gide Nwawudu
On Thu, 09 Jul 2009 20:01:02 -0300, Ary Borenszweig a...@esperanto.org.ar wrote: torhu escribió: On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source code? I never seen this feature

Re: Descent generated documentation

2009-07-10 Thread Robert Fraser
Daniel Keep wrote: But this is quite cool; always nice to have another alternative. :) What are the other alternatives? The interlinks are all but necessary for larger/OO projects.

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Gide Nwawudu escribió: On Thu, 09 Jul 2009 20:01:02 -0300, Ary Borenszweig a...@esperanto.org.ar wrote: torhu escribió: On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source code? I

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Daniel Keep escribió: Ary Borenszweig 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

Re: Descent generated documentation

2009-07-10 Thread Steven Schveighoffer
On Thu, 09 Jul 2009 19:01:02 -0400, Ary Borenszweig a...@esperanto.org.ar wrote: torhu escribió: On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source code? I never seen this

Re: Descent generated documentation

2009-07-10 Thread Steven Schveighoffer
On Fri, 10 Jul 2009 01:17:29 -0400, Ary Borenszweig a...@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:

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Steven Schveighoffer wrote: On Thu, 09 Jul 2009 19:01:02 -0400, Ary Borenszweig a...@esperanto.org.ar wrote: torhu escribió: On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source

Re: Descent generated documentation

2009-07-10 Thread torhu
On 10.07.2009 14:41, Ary Borenszweig wrote: You can select the maximum visibility: private, protected or public. (in the original UI in the plugin for Java there's also package, but... where does package fall? private package protected? protected package public? I think neither, mmm...)

Re: Descent generated documentation

2009-07-10 Thread Lutger
Cool, can you do preconditions and class invariants too?

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Lutger wrote: Cool, can you do preconditions and class invariants too? Sure.

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Robert Fraser wrote: Steven Schveighoffer wrote: On Fri, 10 Jul 2009 01:17:29 -0400, Ary Borenszweig a...@esperanto.org.ar wrote: Ary Borenszweig escribió: Hi all! So... I've been playing around with generating ddocs from Descent. phobos:

Re: Descent generated documentation

2009-07-10 Thread Steven Schveighoffer
On Fri, 10 Jul 2009 10:05:38 -0400, Steven Schveighoffer schvei...@yahoo.com wrote: 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

Re: Descent generated documentation

2009-07-10 Thread Ary Borenszweig
Steven Schveighoffer wrote: On Fri, 10 Jul 2009 10:05:38 -0400, Steven Schveighoffer schvei...@yahoo.com wrote: 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

Re: Descent generated documentation

2009-07-10 Thread Daniel Keep
torhu wrote: On 10.07.2009 14:41, Ary Borenszweig wrote: You can select the maximum visibility: private, protected or public. (in the original UI in the plugin for Java there's also package, but... where does package fall? private package protected? protected package public? I think

Re: Descent generated documentation

2009-07-09 Thread Jacob Carlborg
On 7/9/09 6:44 AM, Ary Borenszweig wrote: Hi all! So... I've been playing around with generating ddocs from Descent. I wanted several things: 1. Each reference to a symbol has a link to it. This applied to field types, functions and methods return types and parameters. 2. Get to know the

Re: Descent generated documentation

2009-07-09 Thread Steven Schveighoffer
On Thu, 09 Jul 2009 10:18:37 -0400, Ary Borenszweig a...@esperanto.org.ar wrote: Jacob Carlborg escribió: On 7/9/09 6:44 AM, Ary Borenszweig wrote: Hi all! So... I've been playing around with generating ddocs from Descent. I wanted several things: 1. Each reference to a symbol has a link

Re: Descent generated documentation

2009-07-09 Thread Steven Schveighoffer
On Thu, 09 Jul 2009 14:05:26 -0400, Ary Borenszweig a...@esperanto.org.ar wrote: Note that this is in trunk, not in any release yet. Don't worry, by the time I figure out how to do it, you'll have released it :P -Steve

Re: Descent generated documentation

2009-07-09 Thread Robert Fraser
Ary Borenszweig wrote: phobos: http://downloads.dsource.org/projects/descent/ddoc/phobos/ Tango: http://downloads.dsource.org/projects/descent/ddoc/tango/ *drool* I agree about the source code -- it's probably the main reason the Tango docs are so slow and it's useless 95% of the time.

Re: Descent generated documentation

2009-07-09 Thread torhu
On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source code? I never seen this feature in any other documentation generator. One should not need to see the source code to use the API.

Re: Descent generated documentation

2009-07-09 Thread Ary Borenszweig
torhu escribió: On 09.07.2009 16:18, Ary Borenszweig wrote: Jacob Carlborg escribió: Generated source code like the tango documentation has Why would you like to see the source code? I never seen this feature in any other documentation generator. One should not need to see the source code

Re: Descent generated documentation

2009-07-09 Thread Ary Borenszweig
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

Re: Descent generated documentation

2009-07-09 Thread Daniel Keep
Ary Borenszweig 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

Descent generated documentation

2009-07-08 Thread Ary Borenszweig
Hi all! So... I've been playing around with generating ddocs from Descent. I wanted several things: 1. Each reference to a symbol has a link to it. This applied to field types, functions and methods return types and parameters. 2. Get to know the supertype hierarchy of a given class. 3. Get