<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Dec 5, 2013 at 11:40 AM, H. S. Teoh <span dir="ltr"><<a href="mailto:hsteoh@quickfur.ath.cx" target="_blank">hsteoh@quickfur.ath.cx</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="im">On Thu, Dec 05, 2013 at 10:09:59AM -0800, Timothee Cour wrote:<br>

> The instructions in <a href="http://wiki.dlang.org/Building_DMD" target="_blank">http://wiki.dlang.org/Building_DMD</a> are full of bugs<br>
> (noone bothered to run those apparently), and running make -f posix.mak<br>
> from <a href="http://dlang.org" target="_blank">dlang.org</a> has issues, eg dependency on kindlegen.<br>
<br>
</div>The original instructions on that page were only intended for dmd,<br>
druntime, and phobos, and they were tested and worked. The "building the<br>
docs" section was added later, and looks like they forgot to mention<br>
build dependencies.<br></blockquote><div><br></div><div>that's the one that's full of bugs.</div><div>eg: </div><div>git cline instead of clone</div><div>make instead of make -f ...<br></div><div>etc.</div><div><br>
</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div class="im"><br>
<br>
> Furthermore, <a href="http://dlang.org" target="_blank">dlang.org</a>'s posix.mak requires a git clone, and clones an<br>
> entire copy of phobos under phobos.2.064.2 (currently), alongside the<br>
> already cloned phobos clone.<br>
><br>
> How to I simply build docs that correspond to the currently checked<br>
> out phobos repo ? (no additional clone, and no external dependency on<br>
> kindlegen or other tool)<br>
<br>
</div>I find this an utter annoyance too. Somebody needs to document how to<br>
build the docs for *html only*, not all of the other jazz like git<br>
cloning release tarballs, running kindlegen, etc.. (Well, somebody needs<br>
to make it possible to do just this, in the first place.)<br>
<br>
I stopped working on docs after <a href="http://dlang.org" target="_blank">dlang.org</a> started pulling in all kinds<br>
of dependencies that I don't have the time to figure out how to install<br>
/ disable (I'm not exactly interested in generating the docs in kindle<br>
format, just so I can test my ddoc changes to Phobos!).<br>
<span class=""><font color="#888888"><br>
<br>
T<br>
<br>
--<br>
Let's not fight disease by killing the patient. -- Sean 'Shaleh' Perry<br>
</font></span></blockquote></div><br></div></div>