[phobos] How to build the Phobos docs?

[Steve Schveighoffer]

IMO the site documentation should require the library, not the other way around.  Why should I care if the D spec is built if I just want to build the library?

Why not move the makefile bits that build the documentation into a documentation makefile (inside the d-programming-language.org project), which requires phobos/druntime to be in a certain spot?

Alternatively, you could build the *library* part of the docs in phobos' makefile, and have the site makefile call that one recursively.

-Steve



----- Original Message -----
> From:Andrei Alexandrescu <andrei at erdani.com>
> To:Discuss the phobos library for D <phobos at puremagic.com>
> Cc:
> Sent:Thursday, February 3, 2011 2:28 PM
> Subject:Re: [phobos] How to build the Phobos docs?
> 
> I looked into this and I don't know what the best way is.
> 
> Essentially it makes little sense to build Phobos without having the 
> site around. Practically this is because std.ddoc is in the 
> d-programming-language.org repository (as I think it should).
> 
> If you have this structure:
> 
> somedir/
>    phobos/
>    d-programming-language.org/
> 
> it all works automatically. If you have d-programming-language.org 
> elsewhere, do this:
> 
> make html DOCSRC=/path/to/d-programming-language.org
> 
> Suggestions for improving this are welcome.
> 
> Andrei
> 
> On 2/3/11 5:16 AM, Lars Tandle Kyllingstad wrote:
> > When I run "make -f posix.mak html" I now get the message
> >
> >           make: *** No rule to make target
> >          `../web/phobos-prerelease/phobos.html', needed by `html'. 
> Stop.
> >
> > If I create the file manually, I get more of the same:
> >
> >          make: *** No rule to make target
> >          `../web/phobos-prerelease/std_algorithm.html', needed by 
> `html'.
> >          Stop.
> >
> > Is the makefile broken, or is there something I need to do before
> > running make?
> >
> > -Lars
> >
> > _______________________________________________
> > phobos mailing list
> > phobos at puremagic.com
> > http://lists.puremagic.com/mailman/listinfo/phobos
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos