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<

Re: Descent generated documentation

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

Re: Descent generated documentation

2009-07-10 Thread Steven Schveighoffer
On Fri, 10 Jul 2009 10:05:38 -0400, Steven Schveighoffer 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 it's better than dd

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 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:/

Re: Descent generated documentation

2009-07-10 Thread Robert Fraser
Steven Schveighoffer wrote: On Fri, 10 Jul 2009 01:17:29 -0400, 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

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 Lutger
Cool, can you do preconditions and class invariants too?

Re: Descent generated documentation

2009-07-10 Thread BCS
Hello Ary, (unfortunately the listing will be "unit test 1", "unit test 2", etc., because there's no way to name unit tests, grr) /// General usage unittest { ... } /// Multi threaded usage unittest { } . . .

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 Ary Borenszweig
Steven Schveighoffer wrote: On Thu, 09 Jul 2009 19:01:02 -0400, Ary Borenszweig 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 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

Re: Descent generated documentation

2009-07-10 Thread Steven Schveighoffer
On Thu, 09 Jul 2009 19:01:02 -0400, Ary Borenszweig 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" in any other docu

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 Ary Borenszweig
Gide Nwawudu escribió: On Thu, 09 Jul 2009 20:01:02 -0300, Ary Borenszweig 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 "featu

Re: Descent generated documentation

2009-07-10 Thread Daniel Keep
Robert Fraser wrote: > 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. dmd and kandil. I've used the Tango docs fairly well without the interlinks; it'

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 Gide Nwawudu
On Thu, 09 Jul 2009 20:01:02 -0300, Ary Borenszweig 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" >>> i