[PATCH] libgloss: add a little build system generation documentation

[Mike Frysinger]

On 02 Mar 2022 13:10, Tamar Christina wrote:
> This commit seems to break the build:
> 
> make[3]: Entering directory '/newlib/aarch64-none-elf/libgloss'
>   MAKEINFO /src-newlib/libgloss/doc/porting.info
> /src-newlib/libgloss/doc/porting.texi:360: warning: node `Board support' is prev for `Build System Internals' in sectioning but not in menu
> /src-newlib/libgloss/doc/porting.texi:360: warning: node `Libgloss' is up for `Build System Internals' in sectioning but not in menu
> /src-newlib/libgloss/doc/porting.texi:87: node `Libgloss' lacks menu item for `Build System Internals' despite being its Up target
> make[3]: *** [Makefile:1233: /src-newlib/libgloss/doc/porting.info] Error 1
> make[3]: Leaving directory '/newlib/aarch64-none-elf/libgloss'
> make[2]: *** [Makefile:1439: all-recursive] Error 1

builds fine for me w/texinfo-6.8.  what version are you using ?

current texinfo guidelines is to omit the 2nd+ args for @node.
wonder if that would fix the build for you.
-mike

--- a/libgloss/doc/porting.texi
+++ b/libgloss/doc/porting.texi
@@ -311,7 +311,7 @@
 and uninstalled object tree. It also makes it easier to debug the other
 tools using libgloss's test suites.
 
-@node Board support, , Building libgloss, Libgloss
+@node Board support
 @section Adding Support for a New Board
 
 This section explains how to add support for a new board to libgloss.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/newlib/attachments/20220302/ccb85e8a/attachment.sig>