dlang.org makefile pains

[Vladimir Panteleev via Digitalmars-d]

On Tuesday, 15 March 2016 at 11:15:12 UTC, Jakob Ovrum wrote:
> I used to contribute to dlang.org now and then before the 
> makefile revamp. Now every time I try, I end up fighting with 
> the makefile.
>
>> make -f posix.mak apidocs-serve
>> LATEST=2.070.2 <-- place in the command line to skip network 
>> traffic
>> *starts downloading crap from downloads.dlang.org that I 
>> already have*
>
> Alright, let's try that again.
>
>> make -f posix.mak apidocs-serve LATEST=2.070.2
>> *still downloads crap I already have*
>> *Phobos build errors because latest Phobos isn't compatible 
>> with DMD 2.069.2*
>
> How do I make it use ../dmd and ../phobos? I've looked at 
> CONTRIBUTING.md and the Wiki and I don't see this explained 
> anywhere.
>
> All I want to do is test DDox with local dlang.org changes and 
> local Phobos changes.

What is it downloading?

It needs to get the stable versions of dmd/phobos to build the 
stable documentation. It places those in 
../{dmd,phobos,druntime}-$LATEST.

It also needs to have a host D compiler to build DMD. I don't 
remember what the default is, but IIRC you can set either 
HOST_DMD to the full path to a working DMD binary, or 
AUTO_BOOTSTRAP=1 to have it download one.

(BTW, Digger can build dlang.org if you specify --with=website, 
but it will also download stuff you may already have.)