Re: [manuals] Manuals failing to build on Ubuntu LTS 14.04

[Andre Vieira <Andre dot SimoesDiasVieira at arm dot com>]

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,