Building the docs with own changes

Steven Schveighoffer via Digitalmars-d digitalmars-d at puremagic.com
Mon Jun 8 06:34:16 PDT 2015


On 6/8/15 7:27 AM, 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.

If you just want to check that a file's content is going to show up, I use:

dmd -D -o- -c std/somemod.d

The output is not styled properly. But the output should have working links.

FWIW, I avoid building phobos docs. It's too painful. If I change 
dlang.org docs, I will build those, but not phobos.

-Steve


More information about the Digitalmars-d mailing list