Re: Draft release notes complete

On 08/29/2012 11:20 PM, Peter Eisentraut wrote:
> On Wed, 2012-08-29 at 22:23 -0400, Alvaro Herrera wrote:
>>>>> Where are we on building the development docs more frequently?
>>>> Still waiting for details on how it works to set that up on the
>>>> buildfarm client.
>>> Where are we on this?
>> Waiting on Andrew.
>>
>> As far as I can see, we need to update the machine to release 4.7, and
>> then install a "skip file" or something like that.  Andrew, can you
>> please explain how is that to be used?  I don't see it documented
>> anywhere.
> Why does this need to be tied into the build farm?  Someone can surely
> set up a script that just runs the docs build at every check-in, like it
> used to work.  What's being proposed now just sounds like a lot of
> complication for little or no actual gain -- net loss in fact.
>
>

It doesn't just build the docs. It makes the dist snapshots too. And the 
old script often broke badly, IIRC. The current setup doesn't install 
anything if the build fails, which is a distinct improvement. And you 
can see the causes of any failure via the buildfarm logs.

But I don't really have any stake in this, I just created a tiny Module 
to help Magnus do what he wanted.

In answer to Alvaro's question, you can disable most steps via a command 
line switch --skip-steps, the value of which is a space separated list 
of names. I haven't documented it mainly because it was really developed 
for use in development. The allowed values are:
   install   make   make-doc   install   make-contrib   install   install-check   contrib-install-check
pl-install-check  isolation-check   check   ecpg-check
 



cheers

andrew