[phobos] How to build the Phobos docs?

Brad Roberts braddr at puremagic.com
Thu Feb 3 12:21:44 PST 2011


This is exactly what I said about a week ago.  I guess it was lost in the 
noise.  Phobos' build should not depend on the d-p-l repository, imho.

On Thu, 3 Feb 2011, Steve Schveighoffer wrote:

> Date: Thu, 3 Feb 2011 11:52:22 -0800 (PST)
> From: Steve Schveighoffer <schveiguy at yahoo.com>
> To: Discuss the phobos library for D <phobos at puremagic.com>
> Subject: Re: [phobos] How to build the Phobos docs?
> 
> 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
> 
> 
> 
>       
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos
> 


More information about the phobos mailing list