how to build doc from source?

[Timothee Cour]

On Thu, Dec 5, 2013 at 11:40 AM, H. S. Teoh <hsteoh at quickfur.ath.cx> wrote:

> 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.
>

that's the one that's full of bugs.
eg:
git cline instead of clone
make instead of make -f ...
etc.



>
>
> > 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puremagic.com/pipermail/digitalmars-d-learn/attachments/20131205/2f4e5d89/attachment.html>