[phobos] How to build the Phobos docs?

[Andrei Alexandrescu]

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