GIT version: remake docs

GIT version: remake docs

[Hans Aberg]

After first making (& installing) Guile from GIT,
   make pdf
   make clean
   make pdf
failed. It seems 'clean' also removes a file 'standard-library.texi',  
which is needed for 'make pdf'. It is in the guile-1.9.14  
distribution, so it is not a file generated by 'make'.

Re: GIT version: remake docs

[Andy Wingo]

On Mon 17 Jan 2011 10:47, Hans Aberg <haberg-1@telia.com> writes:

> After first making (& installing) Guile from GIT,
>   make pdf
>   make clean
>   make pdf
> failed. It seems 'clean' also removes a file 'standard-library.texi',
> which is needed for 'make pdf'. It is in the guile-1.9.14  distribution,
> so it is not a file generated by 'make'.

It is actually generated by make.  Run "make" between "make clean" and
"make pdf", and things will work.

I realize it's not that great of a solution, but that's the situation
for now.

Andy
-- 
http://wingolog.org/

Re: GIT version: remake docs

[Hans Aberg]

On 26 Jan 2011, at 21:02, Andy Wingo wrote:

>> After first making (& installing) Guile from GIT,
>>  make pdf
>>  make clean
>>  make pdf
>> failed. It seems 'clean' also removes a file 'standard-library.texi',
>> which is needed for 'make pdf'. It is in the guile-1.9.14   
>> distribution,
>> so it is not a file generated by 'make'.
>
> It is actually generated by make.  Run "make" between "make clean" and
> "make pdf", and things will work.
>
> I realize it's not that great of a solution, but that's the situation
> for now.

In view of the radical changes from 1.8 to 1.9, I decided to not  
install the pdf immediately, keeping the docs from 1.8. Then I made  
'make clean' only to discover that the docs I was reading did not  
exits anymore. And then they could not be remade.

I recall I copied the missing file from latest 1.9 package. So in  
those, they are not at least expected to be generated by 'make'.

But I now only have the docs from the 1.9 GIT version.

Re: GIT version: remake docs

[Andy Wingo]

Hi Hans,

On Wed 26 Jan 2011 23:37, Hans Aberg <haberg-1@telia.com> writes:

> Then I made 'make clean' only to discover that the docs I was reading
> did not exits anymore. And then they could not be remade.

Apologies for all the mess!  But I am unclear: do you have 1.8 and 1.9
docs now?  Is there a bug?  Let me know if you have a bug that we can
fix.  To my knowledge, the 1.9 documentation is perfectly buildable from
git.  Just do "make" before "make pdf".

Thanks,

Andy
-- 
http://wingolog.org/

Re: GIT version: remake docs

[Hans Aberg]

On 26 Jan 2011, at 23:57, Andy Wingo wrote:

>> Then I made 'make clean' only to discover that the docs I was reading
>> did not exits anymore. And then they could not be remade.
>
> Apologies for all the mess!  But I am unclear: do you have 1.8 and 1.9
> docs now?

I have only 1.9 now, as I made the transition. But I have the  
guile-1.8.8 binary which can be run from libguile/. I can probably get  
the 1.8 docs by 'make pdf' in this directory.

> Is there a bug?  Let me know if you have a bug that we can
> fix.  To my knowledge, the 1.9 documentation is perfectly buildable  
> from
> git.  Just do "make" before "make pdf".

The bug is this: first
   make
   make pdf
This produces the PDF. Then
   make clean
This takes away the pdf. Then try to repeat
   make pdf
This fails.

Now you say
   make
   make pdf
should succeed. I did not try that. Instead I noticed that the missing  
file was in the guile-1.9.14 distribution. So I just copied it into my  
GIT version, and then then 'make pdf' worked. After that installed the  
PDFs, overwriting those from 1.8. So now, I only have those from 1.9  
GIT.

Re: GIT version: remake docs

[Ludovic Courtès]

Hello!

Hans Aberg <haberg-1@telia.com> writes:

> The bug is this: first
>   make
>   make pdf
> This produces the PDF. Then
>   make clean
> This takes away the pdf. Then try to repeat
>   make pdf
> This fails.

I think commit 41d82ac9904c883a0c281cd1a89c03d9d968a801 fixes this.

Thanks,
Ludo’.

Re: GIT version: remake docs

[Hans Aberg]

On 29 Jan 2011, at 23:32, Ludovic Courtès wrote:

>> The bug is this: first
>>  make
>>  make pdf
>> This produces the PDF. Then
>>  make clean
>> This takes away the pdf. Then try to repeat
>>  make pdf
>> This fails.
>
> I think commit 41d82ac9904c883a0c281cd1a89c03d9d968a801 fixes this.

Fine. I have noticed in packages other than Guile that something may  
break when re-making. So I tend to unpack the whole distribution.