On Thu, Dec 05, 2013 at 10:09:59AM -0800, Timothee Cour wrote: > The instructions in http://wiki.dlang.org/Building_DMD are full of bugs > (noone bothered to run those apparently), and running make -f posix.mak > from dlang.org has issues, eg dependency on kindlegen.
The original instructions on that page were only intended for dmd, druntime, and phobos, and they were tested and worked. The "building the docs" section was added later, and looks like they forgot to mention build dependencies. > Furthermore, dlang.org's posix.mak requires a git clone, and clones an > entire copy of phobos under phobos.2.064.2 (currently), alongside the > already cloned phobos clone. > > How to I simply build docs that correspond to the currently checked > out phobos repo ? (no additional clone, and no external dependency on > kindlegen or other tool) I find this an utter annoyance too. Somebody needs to document how to build the docs for *html only*, not all of the other jazz like git cloning release tarballs, running kindlegen, etc.. (Well, somebody needs to make it possible to do just this, in the first place.) I stopped working on docs after dlang.org started pulling in all kinds of dependencies that I don't have the time to figure out how to install / disable (I'm not exactly interested in generating the docs in kindle format, just so I can test my ddoc changes to Phobos!). T -- Let's not fight disease by killing the patient. -- Sean 'Shaleh' Perry
