Building the docs with own changes

anonymous via Digitalmars-d digitalmars-d at puremagic.com
Mon Jun 8 06:33:59 PDT 2015


On Monday, 8 June 2015 at 11:27:58 UTC, John Colvin wrote:
> Is there any non-insane way of changing some documentation in a 
> module and checking that any links/xrefs you may have added 
> actually work?
>
> The dlang.org makefile appears to happily erase uncommitted 
> changes in ../druntime and ../phobos. I'm really struggling for 
> words to describe how infuriating that is. I ran make and it 
> deleted my work in a separate folder. Not OK.

This shouldn't happen. Are you sure you worked in the "phobos" 
directory and not in some versioned one like "phobos-2.067.1"? 
That would be a directory created by dlang.org.

Slightly different topic, related to changing documentation 
without losing your sanity: When building dlang.org, changes in 
druntime/phobos are not properly picked up.

You can try deleting a strategic file like 
dlang.org/web/phobos-prerelease/index.html which should trigger a 
rebuild. See posix.mak for what files are dependencies to the 
different targets.

Or just do a fresh build every time: `make -f posix.mak clean; 
make -f posix.mak phobos-prerelease`.

I have an open pull request that's supposed to fix this:
https://github.com/D-Programming-Language/dlang.org/pull/993


More information about the Digitalmars-d mailing list