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