[manuals] Manuals failing to build on Ubuntu LTS 14.04

[Andre Vieira]

On 20/08/15 09:54, Corinna Vinschen wrote:
> On Aug 11 14:55, Jon TURNEY wrote:
>> On 11/08/2015 11:08, Andre Vieira wrote:
>>> On 10/08/15 14:38, Jon TURNEY wrote:
>>>> On 07/08/2015 11:13, Andre Vieira wrote:
>>>>> Building the manuals on Ubuntu LTS 14.04 (64-bit) using pdfTeX
>>>>> 3.1415926-2.5-1.40.14 (TeX Live 2013/Debian) is failing with the
>>>>> following error:
>>>>> "Transcript written on libc.log.
>>>>> /usr/bin/texi2dvi: pdfetex exited with bad status, quitting."
>>>>>
>>>>> libc.log complaints about the following:
>>>>>
>>>>> You can't use `@unskip' in vertical mode.
>>>>>
>> [...]
>>>>>
>>>>> This code has been around for a while, so it might have to do with a
>>>>> change in pdfTex?
>>
>> So it seems this problem has been around for a while, and looks like it is
>> due to a change in texi2dvi in texinfo 5.0 or late 4.x, see [1].
>>
>> I guess it's not very noticeable since it only occurs when doing 'make dvi',
>> which doesn't happen by default.
>>
>> Attached is a different and perhaps cleaner workaround to the one in that
>> thread.
>>
>> [1] https://sourceware.org/ml/newlib/2013/msg00057.html
>>
>
>>  From 4d386b5900b6c68e022004b447faa696be5ff8c7 Mon Sep 17 00:00:00 2001
>> From: Jon TURNEY <jon.turney@dronecode.org.uk>
>> Date: Tue, 11 Aug 2015 14:46:39 +0100
>> Subject: [PATCH] Use '@sp 1' rather than '@*' to workaround a change in
>>   texi2dvi.
>>
>> Since about TexInfo 5.0, using '@*' immediately after a table causes a 'You
>> can't use `@unskip' in vertical mode' error.
>>
>> See https://sourceware.org/ml/newlib/2013/msg00057.html
>>
>> Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
>> ---
>>   newlib/doc/doc.str | 2 +-
>>   1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/newlib/doc/doc.str b/newlib/doc/doc.str
>> index 51ecef7..aeef6f7 100644
>> --- a/newlib/doc/doc.str
>> +++ b/newlib/doc/doc.str
>> @@ -107,7 +107,7 @@
>>   	courierize
>>   	do_fancy_stuff
>>   	catstr
>> -	"@*\n" catstr
>> +	"@sp 1\n" catstr
>>   	;
>>
>>   : asection
>> --
>> 2.4.5
>
> Patch applied.
>
>
> Thanks,
> Corinna
>

Thanks Corinna, sorry for the late reply. It did seem to fix the issue, 
though I now run into another issue when building the manuals, which I 
think is unrelated.

It occurs when executing makeinfo:

makeinfo --split-size=5000000 --split-size=5000000 --html -I 
<PATH>/src/newlib/libgloss/doc -o porting.html 
<PATH>/src/newlib/libgloss/doc/porting.texi
<PATH>/src/newlib/libgloss/doc/porting.texi:73: @menu seen before first 
@node
<PATH>/src/newlib/libgloss/doc/porting.texi:73: perhaps your @top node 
should be wrapped in @ifnottex rather than @ifinfo?
<PATH>/src/newlib/libgloss/doc/porting.texi:83: Prev reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:83: Up reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:350: warning: unreferenced 
node `GCC'
<PATH>/src/newlib/libgloss/doc/porting.texi:350: Up reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:458: warning: unreferenced 
node `Libraries'
<PATH>/src/newlib/libgloss/doc/porting.texi:458: Up reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:1104: warning: unreferenced 
node `GDB'
<PATH>/src/newlib/libgloss/doc/porting.texi:1104: Up reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:1351: warning: unreferenced 
node `Binutils'
<PATH>/src/newlib/libgloss/doc/porting.texi:1351: Up reference to 
nonexistent `Top'
<PATH>/src/newlib/libgloss/doc/porting.texi:1353: warning: unreferenced 
node `Code Listings'
<PATH>/src/newlib/libgloss/doc/porting.texi:1353: Up reference to 
nonexistent `Top'


The same issue has been reported earlier in: 
https://sourceware.org/ml/newlib/2014/msg00509.html .

BR,