Re: Generating Phobos Doc

2014-07-19 Thread Nordlöw
On Thursday, 17 July 2014 at 18:03:45 UTC, H. S. Teoh via 
Digitalmars-d-learn wrote:

T


Thx


Generating Phobos Doc

2014-07-17 Thread Nordlöw

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.




Re: Generating Phobos Doc

2014-07-17 Thread H. S. Teoh via Digitalmars-d-learn
On Thu, Jul 17, 2014 at 05:54:21PM +, 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.