how to build doc from source?

[H. S. Teoh]

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