www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - where is ddoc.

reply maarten van damme <maartenvd1994 gmail.com> writes:
as with most tools mentioned on the digitalmars homepage I am unable to find
ddoc.
I know it exists, judging by the whole page dedicated to it but the tool
itself is never mentioned in any download page.
Not to offend anyone but the digitalmars homepage really could use some
rethinking. It was one of the reasons I almost didn't try d :p
I always get lost in it.
It would be great to also have a link to the full phobos documentation
generated with candydoc on the digitalmars d page instead of
http://www.digitalmars.com/d/2.0/phobos/ , candydoc generates something more
readable and structured.
Aug 21 2011
next sibling parent reply simendsjo <simendsjo gmail.com> writes:
On 21.08.2011 13:32, maarten van damme wrote:

 as with most tools mentioned on the digitalmars homepage I am unable to
 find ddoc.
 I know it exists, judging by the whole page dedicated to it but the tool
 itself is never mentioned in any download page.
 Not to offend anyone but the digitalmars homepage really could use some
 rethinking. It was one of the reasons I almost didn't try d :p
 I always get lost in it.
 It would be great to also have a link to the full phobos documentation
 generated with candydoc on the digitalmars d page instead of
 http://www.digitalmars.com/d/2.0/phobos/ , candydoc generates something
 more readable and structured.


ddoc is embedded in dmd. It doesn't have a standalone executable.

module t;
/// This is documented
void main() {}

dmd -D t.d

t.html now contains documentation.
Aug 21 2011
parent reply simendsjo <simendsjo gmail.com> writes:
On 21.08.2011 13:38, simendsjo wrote:

 On 21.08.2011 13:32, maarten van damme wrote:

 as with most tools mentioned on the digitalmars homepage I am unable to
 find ddoc.
 I know it exists, judging by the whole page dedicated to it but the tool
 itself is never mentioned in any download page.
 Not to offend anyone but the digitalmars homepage really could use some
 rethinking. It was one of the reasons I almost didn't try d :p
 I always get lost in it.




D's homepage is stored at github, so if you have any suggestions, you 
could fork/modify/pull-request changes. I don't see any big problems 
with the homepage myself. A better search feature (for phobos) would 
have been nice.


 It would be great to also have a link to the full phobos documentation
 generated with candydoc on the digitalmars d page instead of
 http://www.digitalmars.com/d/2.0/phobos/ , candydoc generates something
 more readable and structured.




Is candydoc still maintained? I see it hasn't been modified in 5 years, 
so I guess it won't work on D2.


 ddoc is embedded in dmd. It doesn't have a standalone executable.

 module t;
 /// This is documented
 void main() {}

 dmd -D t.d

 t.html now contains documentation.
Aug 21 2011
parent maarten van damme <maartenvd1994 gmail.com> writes:
candydoc is abondonned but still functional I think.
I've read there was also a ddoc.exe but I think that was for d1? anyway It
works now, thank you

2011/8/21 simendsjo <simendsjo gmail.com>


 On 21.08.2011 13:38, simendsjo wrote:


 On 21.08.2011 13:32, maarten van damme wrote:


 as with most tools mentioned on the digitalmars homepage I am unable to
 find ddoc.
 I know it exists, judging by the whole page dedicated to it but the tool
 itself is never mentioned in any download page.
 Not to offend anyone but the digitalmars homepage really could use some
 rethinking. It was one of the reasons I almost didn't try d :p
 I always get lost in it.




 D's homepage is stored at github, so if you have any suggestions, you could
 fork/modify/pull-request changes. I don't see any big problems with the
 homepage myself. A better search feature (for phobos) would have been nice.


  It would be great to also have a link to the full phobos documentation

 generated with candydoc on the digitalmars d page instead of
 http://www.digitalmars.com/d/**2.0/phobos/<http://www.digitalmars
com/d/2.0/phobos/>, candydoc generates something
 more readable and structured.




 Is candydoc still maintained? I see it hasn't been modified in 5 years, so
 I guess it won't work on D2.


  ddoc is embedded in dmd. It doesn't have a standalone executable.

 module t;
 /// This is documented
 void main() {}

 dmd -D t.d

 t.html now contains documentation.
Aug 21 2011
prev sibling next sibling parent Jesse Phillips <jessekphillips+d gmail.com> writes:
On Sun, 21 Aug 2011 13:32:08 +0200, maarten van damme wrote:


 as with most tools mentioned on the digitalmars homepage I am unable to
 find ddoc.


CandyDoc is DDoc. Or at least CandyDoc is just a bunch of macros and CSS 
files for DDoc.

DDoc is D's documentation standard. At one time it was its own 
implementation but it was merged into dmd early one.
Aug 21 2011
prev sibling parent reply Mike Parker <aldacron gmail.com> writes:
On 8/21/2011 8:32 PM, maarten van damme wrote:

 It would be great to also have a link to the full phobos documentation
 generated with candydoc on the digitalmars d page instead of
 http://www.digitalmars.com/d/2.0/phobos/ , candydoc generates something
 more readable and structured.


The new official D home page is at

http://d-programming-language.org/

The Phobos documentation there is much nicer:

http://d-programming-language.org/phobos/index.html

The output of ddoc is not static. It's a templated system that can be 
configured to look however you like.
Aug 21 2011
parent maarten van damme <maartenvd1994 gmail.com> writes:
wow, that site looks way nicer. Too bad google doesn't take it as first
result.
and the documentation is indeed much better :)

2011/8/22 Mike Parker <aldacron gmail.com>


 On 8/21/2011 8:32 PM, maarten van damme wrote:


 It would be great to also have a link to the full phobos documentation
 generated with candydoc on the digitalmars d page instead of
 http://www.digitalmars.com/d/**2.0/phobos/<http://www.digitalmars
com/d/2.0/phobos/>, candydoc generates something
 more readable and structured.


 The new official D home page is at

 http://d-programming-language.**org/ <http://d-programming-language.org/>

 The Phobos documentation there is much nicer:

 http://d-programming-language.**org/phobos/index.html<http://d-programming-language.org/phobos/index.html>

 The output of ddoc is not static. It's a templated system that can be
 configured to look however you like.
Aug 22 2011