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.

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.

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.

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.
>>
>
>

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.

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.

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.
>