[phobos] How to build the Phobos docs?

[Jonathan M Davis]

On Thursday, February 03, 2011 11:28:47 Andrei Alexandrescu wrote:
> I looked into this and I don't know what the best way is.
> 
> Essentially it makes little sense to build Phobos without having the
> site around. Practically this is because std.ddoc is in the
> d-programming-language.org repository (as I think it should).
> 
> If you have this structure:
> 
> somedir/
>    phobos/
>    d-programming-language.org/
> 
> it all works automatically. If you have d-programming-language.org
> elsewhere, do this:
> 
> make html DOCSRC=/path/to/d-programming-language.org
> 
> Suggestions for improving this are welcome.

That seems reasonable. The other option is to just have it build with the 
default settings if ../d-programming-language.org isn't there and DOCSRC isn't 
set, but that's of limited use, since the default settings look very different 
from what you get when building with std.ddoc.

- Jonathan M Davis