This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[COMMITTED] manual/startup.texi: Add explicit menu ordering.


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.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]