This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
[COMMITTED] manual/startup.texi: Add explicit menu ordering.
- From: "Carlos O'Donell" <carlos at redhat dot com>
- To: GNU C Library <libc-alpha at sourceware dot org>, Allan McRae <allan at archlinux dot org>
- Date: Mon, 03 Feb 2014 13:08:08 -0500
- Subject: [COMMITTED] manual/startup.texi: Add explicit menu ordering.
- Authentication-results: sourceware.org; auth=none
Allan,
I've checked this in to fix manual build warnings when
building html, info and pdf manuals.
The warning seen is this:
~~~
LANGUAGE=C LC_ALL=C makeinfo -P /home/carlos/build/glibc-alex/manual/ --output=/home/carlos/build/glibc-alex/manual/libc.info libc.texinfo
make html./startup.texi:44: warning: node next `Program Arguments' in menu `Environment Variables' and in sectioning `Getopt' differ
./startup.texi:266: warning: node prev `Environment Variables' in menu `Program Arguments' and in sectioning `Argp' differ
make[2]: Leaving directory `/home/carlos/src/glibc-alex/manual'
make[1]: Leaving directory `/home/carlos/src/glibc-alex'
~~~
The automatically computed node layout in texinfo gets confused
by our mixed use of explicit and automatic use of next/prev/top
nodes.
Therefore this minimal patch fixes the warnings by specifying
the next/prev/top nodes.
2014-02-03 Carlos O'Donell <carlos@redhat.com>
* manual/startup.texi: Add next, previous, and top entries for
the `Program Arguments' and `Environment Variables' nodes.
diff --git a/manual/startup.texi b/manual/startup.texi
index 8078a53..a5d2d2f 100644
--- a/manual/startup.texi
+++ b/manual/startup.texi
@@ -41,7 +41,7 @@ see the event from the execor's point of view, see @ref{Executing a File}.
* Program Termination:: Telling the system you're done; return status
@end menu
-@node Program Arguments
+@node Program Arguments, Environment Variables, , Program Basics
@section Program Arguments
@cindex program arguments
@cindex command line arguments
@@ -263,7 +263,7 @@ example of the use of @code{getsubopt}:
@end smallexample
-@node Environment Variables
+@node Environment Variables, Auxiliary Vector, Program Arguments, Program Basics
@section Environment Variables
@cindex environment variable
---
Cheers,
Carlos.