Generating Phobos Doc

[H. S. Teoh via Digitalmars-d-learn]

On Thu, Jul 17, 2014 at 05:54:21PM +0000, "Nordlöw" via Digitalmars-d-learn wrote:
> How do I generate the Phobos docs?
> 
> My try
> 
>     make -f posix.mak html
> 
> fails as
> 
> make: *** No rule to make target `../web/phobos-prerelease/index.html',
> needed by `html'.  Stop.

You need to checkout the dlang.org repository as well.

One way to do it is to have this directory structure:

	/usr/src/d
	/usr/src/d/dmd
	/usr/src/d/druntime
	/usr/src/d/phobos
	/usr/src/d/dlang.org

First, build dmd, druntime, phobos without 'html' to get a working
toolchain, then cd to dlang.org and run `make -f posix.mak html`. This
creates:

	/usr/src/d/dlang.org/web

Symlink this to:

	/usr/src/d/web

Then go back to phobos and run `make -f posix.mak html`. Now it should
work.

(Incidentally, it looks like the expected directory structure is:

	/usr/src/d
	/usr/src/d/dlang.org
	/usr/src/d/dlang.org/dmd
	/usr/src/d/dlang.org/druntime
	/usr/src/d/dlang.org/phobos

But I don't really like that because it requires embedding copies of git
repositories inside each other, which may cause strange git behaviour if
you don't know what you're doing.)


T

-- 
"A one-question geek test. If you get the joke, you're a geek: Seen on a California license plate on a VW Beetle: 'FEATURE'..." -- Joshua D. Wachs - Natural Intelligence, Inc.