View mode: basic / threaded / horizontal-split · Log in · Help
August 21, 2011
where is ddoc.
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.
August 21, 2011
Re: where is ddoc.
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.
August 21, 2011
Re: where is ddoc.
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.
August 21, 2011
Re: where is ddoc.
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.
>>
>
>
August 21, 2011
Re: where is ddoc.
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.
August 22, 2011
Re: where is ddoc.
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.
August 22, 2011
Re: where is ddoc.
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.
>
Top | Discussion index | About this forum | D home