Building newlib PDFs and HTML

["Jon Beniston" <jon at beniston dot com>]

Hi,

I'm having some trouble building PDFs and HTML. For PDFs, the same problem
was reported nearly two years ago here:

http://sourceware.org/ml/newlib/2013/msg00057.html

But I can't see a resolution in the thread. It seems as though it was
related to texinfo 5 or a then recent version of texlive. Does anyone have
any idea how to fix this?

For make html, I get the following failure:

make[4]: Entering directory
'/home/Jon/t/esirisc/gcc/trunk/build/esirisc-elf/libgloss/doc'
makeinfo --split-size=5000000 --split-size=5000000 --html -I
../../../../gcc/libgloss/doc -o porting.html
../../../../gcc/libgloss/doc/porting.texi
../../../../gcc/libgloss/doc/porting.texi:73: @menu seen before first @node
../../../../gcc/libgloss/doc/porting.texi:73: perhaps your @top node should
be wrapped in @ifnottex rather than @ifinfo?
../../../../gcc/libgloss/doc/porting.texi:83: Prev reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:83: Up reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:350: warning: unreferenced node
`GCC'
../../../../gcc/libgloss/doc/porting.texi:350: Up reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:458: warning: unreferenced node
`Libraries'
../../../../gcc/libgloss/doc/porting.texi:458: Up reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:1104: warning: unreferenced node
`GDB'
../../../../gcc/libgloss/doc/porting.texi:1104: Up reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:1351: warning: unreferenced node
`Binutils'
../../../../gcc/libgloss/doc/porting.texi:1351: Up reference to nonexistent
`Top'
../../../../gcc/libgloss/doc/porting.texi:1353: warning: unreferenced node
`Code Listings'
../../../../gcc/libgloss/doc/porting.texi:1353: Up reference to nonexistent
`Top'
Makefile:68: recipe for target 'porting.html' failed

With earlier versions of makeinfo, the first two warnings seem to be output,
but it didn't exit, as it does now.

Replacing @ifinfo with @ifnottex as it suggests in libgloss/doc/porting.texi
gets it to build without error, although that probably isn't ideal, as you
then get the START-INFO-DIR-ENTRY text in the HTML file, which I presume it
shouldn't be. Should that just be wrapped in @ifinfo as in the attached
patch? Is there a better solution?

Cheers,
Jon

Attachment: porting.texi.patch
Description: Binary data