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

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
> 

Yah I got that one. The problem is that the d-programming-language.org repo needs vital info in the Phobos makefile (such as the module list) in order to build. The most natural way to do that is plant a html target inside phobos that is invoked by d-p-l.


Andrei

On 2/3/11 2:21 PM, Brad Roberts wrote:
> 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
>>
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos