www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - where is ddoc.

reply maarten van damme <maartenvd1994 gmail.com> writes:
--000e0cd2dfe0134ba404ab025012
Content-Type: text/plain; charset=ISO-8859-1

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.

--000e0cd2dfe0134ba404ab025012
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

as with most tools mentioned on the digitalmars homepage I am unable to fin=
d ddoc.<div>I know it exists, judging by the whole page dedicated to it but=
 the tool itself is never mentioned in any download page.</div><div>Not to =
offend anyone but the digitalmars homepage really could use some rethinking=
. It was one of the reasons I almost didn&#39;t try d :p</div>
<div>I always get lost in it.</div><div>It would be great to also have a li=
nk to the full phobos documentation generated with candydoc on the digitalm=
ars d page instead of=A0<a href=3D"http://www.digitalmars.com/d/2.0/phobos/=
">http://www.digitalmars.com/d/2.0/phobos/</a>=A0, candydoc generates somet=
hing more readable and structured.</div>

--000e0cd2dfe0134ba404ab025012--
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 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
prev sibling next sibling parent maarten van damme <maartenvd1994 gmail.com> writes:
--000e0cd29e4cfe6bb404ab0518d0
Content-Type: text/plain; charset=ISO-8859-1

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.


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.


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.


--000e0cd29e4cfe6bb404ab0518d0 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable candydoc is abondonned but still functional I think.<div>I&#39;ve read ther= e was also a ddoc.exe but I think that was for d1? anyway It works now, tha= nk you<br><br><div class=3D"gmail_quote">2011/8/21 simendsjo <span dir=3D"l= tr">&lt;<a href=3D"mailto:simendsjo gmail.com">simendsjo gmail.com</a>&gt;<= /span><br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex;"><div class=3D"im">On <a href=3D"tel:21.08.2= 011%2013" value=3D"+12108201113" target=3D"_blank">21.08.2011 13</a>:38, si= mendsjo wrote:<br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex"> On <a href=3D"tel:21.08.2011%2013" value=3D"+12108201113" target=3D"_blank"=
21.08.2011 13</a>:32, maarten van damme wrote:<br>

x #ccc solid;padding-left:1ex"> as with most tools mentioned on the digitalmars homepage I am unable to<br> find ddoc.<br> I know it exists, judging by the whole page dedicated to it but the tool<br=

Not to offend anyone but the digitalmars homepage really could use some<br> rethinking. It was one of the reasons I almost didn&#39;t try d :p<br> I always get lost in it.<br> </blockquote></blockquote> <br></div> D&#39;s homepage is stored at github, so if you have any suggestions, you c= ould fork/modify/pull-request changes. I don&#39;t see any big problems wit= h the homepage myself. A better search feature (for phobos) would have been= nice.<div class=3D"im"> <br> <br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex"><blockquote class=3D"gmail_quote" style=3D"m= argin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> It would be great to also have a link to the full phobos documentation<br> generated with candydoc on the digitalmars d page instead of<br> <a href=3D"http://www.digitalmars.com/d/2.0/phobos/" target=3D"_blank">http= ://www.digitalmars.com/d/<u></u>2.0/phobos/</a> , candydoc generates someth= ing<br> more readable and structured.<br> </blockquote></blockquote> <br></div> Is candydoc still maintained? I see it hasn&#39;t been modified in 5 years,= so I guess it won&#39;t work on D2.<div><div></div><div class=3D"h5"><br> <br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex"> ddoc is embedded in dmd. It doesn&#39;t have a standalone executable.<br> <br> module t;<br> /// This is documented<br> void main() {}<br> <br> dmd -D t.d<br> <br> t.html now contains documentation.<br> </blockquote> <br> </div></div></blockquote></div><br></div> --000e0cd29e4cfe6bb404ab0518d0--
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 next sibling parent 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
prev sibling parent maarten van damme <maartenvd1994 gmail.com> writes:
--000e0cd2df60131c9a04ab1a8694
Content-Type: text/plain; charset=ISO-8859-1

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.

--000e0cd2df60131c9a04ab1a8694 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable wow, that site looks way nicer. Too bad google doesn&#39;t take it as first= result.<div>and the documentation is indeed much better :)<br><br><div cla= ss=3D"gmail_quote">2011/8/22 Mike Parker <span dir=3D"ltr">&lt;<a href=3D"m= ailto:aldacron gmail.com">aldacron gmail.com</a>&gt;</span><br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex;"><div class=3D"im">On 8/21/2011 8:32 PM, maa= rten van damme wrote:<br> <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p= x #ccc solid;padding-left:1ex"> <br> It would be great to also have a link to the full phobos documentation<br> generated with candydoc on the digitalmars d page instead of<br> <a href=3D"http://www.digitalmars.com/d/2.0/phobos/" target=3D"_blank">http= ://www.digitalmars.com/d/<u></u>2.0/phobos/</a> , candydoc generates someth= ing<br> more readable and structured.<br> </blockquote> <br></div> The new official D home page is at<br> <br> <a href=3D"http://d-programming-language.org/" target=3D"_blank">http://d-p= rogramming-language.<u></u>org/</a><br> <br> The Phobos documentation there is much nicer:<br> <br> <a href=3D"http://d-programming-language.org/phobos/index.html" target=3D"_= blank">http://d-programming-language.<u></u>org/phobos/index.html</a><br> <br> The output of ddoc is not static. It&#39;s a templated system that can be c= onfigured to look however you like.<br> </blockquote></div><br></div> --000e0cd2df60131c9a04ab1a8694--
Aug 22 2011