-diff -Nru gettext-0.10.35/doc/gettext.texi gettext-0.10.35.new/doc/gettext.texi
---- gettext-0.10.35/doc/gettext.texi Fri May 1 07:53:32 1998
-+++ gettext-0.10.35.new/doc/gettext.texi Fri Apr 9 18:09:45 1999
-@@ -7,13 +7,13 @@
+--- gettext-0.14/gettext-tools/doc/gettext.texi.orig 2004-01-17 14:37:22.000000000 +0100
++++ gettext-0.14/gettext-tools/doc/gettext.texi 2004-01-29 20:56:03.715853216 +0100
+@@ -31,30 +31,30 @@
@include version.texi
-@dircategory GNU Gettext Utilities
-+@dircategory GNU Gettext Utilities:
++@dircategory Programming tools:
@direntry
--* Gettext: (gettext). GNU gettext utilities.
--* gettextize: (gettext)gettextize Invocation. Prepare a package for gettext.
--* msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files.
--* msgmerge: (gettext)msgmerge Invocation. Update two PO files into one.
--* xgettext: (gettext)xgettext Invocation. Extract strings into a PO file.
-+* Gettext: (gettext) GNU gettext utilities
-+* gettextize: (gettext)gettextize Prepare a package for gettext
-+* msgfmt: (gettext)msgfmt Make MO files out of PO files
-+* msgmerge: (gettext)msgmerge Update two PO files into one
-+* xgettext: (gettext)xgettext Extract strings into a PO file
+-* gettext: (gettext). GNU gettext utilities.
+-* autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure.
+-* envsubst: (gettext)envsubst Invocation. Expand environment variables.
+-* gettextize: (gettext)gettextize Invocation. Prepare a package for gettext.
+-* msgattrib: (gettext)msgattrib Invocation. Select part of a PO file.
+-* msgcat: (gettext)msgcat Invocation. Combine several PO files.
+-* msgcmp: (gettext)msgcmp Invocation. Compare a PO file and template.
+-* msgcomm: (gettext)msgcomm Invocation. Match two PO files.
+-* msgconv: (gettext)msgconv Invocation. Convert PO file to encoding.
+-* msgen: (gettext)msgen Invocation. Create an English PO file.
+-* msgexec: (gettext)msgexec Invocation. Process a PO file.
+-* msgfilter: (gettext)msgfilter Invocation. Pipe a PO file through a filter.
+-* msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files.
+-* msggrep: (gettext)msggrep Invocation. Select part of a PO file.
+-* msginit: (gettext)msginit Invocation. Create a fresh PO file.
+-* msgmerge: (gettext)msgmerge Invocation. Update a PO file from template.
+-* msgunfmt: (gettext)msgunfmt Invocation. Uncompile MO file into PO file.
+-* msguniq: (gettext)msguniq Invocation. Unify duplicates for PO file.
+-* ngettext: (gettext)ngettext Invocation. Translate a message with plural.
+-* xgettext: (gettext)xgettext Invocation. Extract strings into a PO file.
+-* ISO639: (gettext)Language Codes. ISO 639 language codes.
+-* ISO3166: (gettext)Country Codes. ISO 3166 country codes.
++* gettext: (gettext). GNU gettext utilities
++* autopoint: (gettext)autopoint. Copy gettext infrastructure
++* envsubst: (gettext)envsubst. Expand environment variables
++* gettextize: (gettext)gettextize. Prepare a package for gettext
++* msgattrib: (gettext)msgattrib. Select part of a PO file
++* msgcat: (gettext)msgcat. Combine several PO files
++* msgcmp: (gettext)msgcmp. Compare a PO file and template
++* msgcomm: (gettext)msgcomm. Match two PO files
++* msgconv: (gettext)msgconv. Convert PO file to encoding
++* msgen: (gettext)msgen. Create an English PO file
++* msgexec: (gettext)msgexec. Process a PO file
++* msgfilter: (gettext)msgfilter. Pipe a PO file through a filter
++* msgfmt: (gettext)msgfmt. Make MO files out of PO files
++* msggrep: (gettext)msggrep. Select part of a PO file
++* msginit: (gettext)msginit. Create a fresh PO file
++* msgmerge: (gettext)msgmerge. Update a PO file from template
++* msgunfmt: (gettext)msgunfmt. Uncompile MO file into PO file
++* msguniq: (gettext)msguniq. Unify duplicates for PO file
++* ngettext: (gettext)ngettext. Translate a message with plural
++* xgettext: (gettext)xgettext. Extract strings into a PO file
++* ISO639: (gettext)Language Codes. ISO 639 language codes
++* ISO3166: (gettext)Country Codes. ISO 3166 country codes
@end direntry
@ifinfo
-@@ -118,13 +118,13 @@
+@@ -178,16 +178,16 @@
- Making the Initial PO File
+ Making the PO Template File
-* xgettext Invocation:: Invoking the @code{xgettext} Program
-+* xgettext:: Invoking the @code{xgettext} Program
- * C Sources Context:: C Sources Context
- * Compendium:: Using Translation Compendiums
++* xgettext:: Invoking the @code{xgettext} Program
+
+ Creating a New PO File
+
+-* msginit Invocation:: Invoking the @code{msginit} Program
++* msginit:: Invoking the @code{msginit} Program
+ * Header Entry:: Filling in the Header Entry
Updating Existing PO Files
-* msgmerge Invocation:: Invoking the @code{msgmerge} Program
-+* msgmerge:: Invoking the @code{msgmerge} Program
- * Translated Entries::
- * Fuzzy Entries:: Fuzzy translated Entries
++* msgmerge:: Invoking the @code{msgmerge} Program
+ * Translated Entries:: Translated Entries
+ * Fuzzy Entries:: Fuzzy Entries
* Untranslated Entries:: Untranslated Entries
-@@ -135,7 +135,7 @@
+@@ -206,22 +206,22 @@
+
+ Manipulating PO Files
+
+-* msgcat Invocation:: Invoking the @code{msgcat} Program
+-* msgconv Invocation:: Invoking the @code{msgconv} Program
+-* msggrep Invocation:: Invoking the @code{msggrep} Program
+-* msgfilter Invocation:: Invoking the @code{msgfilter} Program
+-* msguniq Invocation:: Invoking the @code{msguniq} Program
+-* msgcomm Invocation:: Invoking the @code{msgcomm} Program
+-* msgcmp Invocation:: Invoking the @code{msgcmp} Program
+-* msgattrib Invocation:: Invoking the @code{msgattrib} Program
+-* msgen Invocation:: Invoking the @code{msgen} Program
+-* msgexec Invocation:: Invoking the @code{msgexec} Program
++* msgcat:: Invoking the @code{msgcat} Program
++* msgconv:: Invoking the @code{msgconv} Program
++* msggrep:: Invoking the @code{msggrep} Program
++* msgfilter:: Invoking the @code{msgfilter} Program
++* msguniq:: Invoking the @code{msguniq} Program
++* msgcomm:: Invoking the @code{msgcomm} Program
++* msgcmp:: Invoking the @code{msgcmp} Program
++* msgattrib:: Invoking the @code{msgattrib} Program
++* msgen:: Invoking the @code{msgen} Program
++* msgexec:: Invoking the @code{msgexec} Program
+ * libgettextpo:: Writing your own programs that process PO files
Producing Binary MO Files
-* msgfmt Invocation:: Invoking the @code{msgfmt} Program
-+* msgfmt:: Invoking the @code{msgfmt} Program
+-* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
++* msgfmt:: Invoking the @code{msgfmt} Program
++* msgunfmt:: Invoking the @code{msgunfmt} Program
* MO Files:: The Format of GNU MO Files
The User's View
-@@ -195,7 +195,7 @@
+@@ -285,7 +285,7 @@
* Flat and Non-Flat:: Flat or Non-Flat Directory Structures
* Prerequisites:: Prerequisite Works
-* gettextize Invocation:: Invoking the @code{gettextize} Program
-+* gettextize:: Invoking the @code{gettextize} Program
++* gettextize:: Invoking the @code{gettextize} Program
* Adjusting Files:: Files You Must Create or Alter
-
- Files You Must Create or Alter
-@@ -634,7 +634,7 @@
+ * autoconf macros:: Autoconf macros for use in @file{configure.in}
+ * CVS Issues:: Integrating with CVS
+@@ -316,7 +316,7 @@
+
+ * Distributed CVS:: Avoiding version mismatch in distributed development
+ * Files under CVS:: Files to put under CVS version control
+-* autopoint Invocation:: Invoking the @code{autopoint} Program
++* autopoint:: Invoking the @code{autopoint} Program
+
+ Other Programming Languages
+
+@@ -375,11 +375,11 @@
+
+ * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
+ * gettext.sh:: Contents of @code{gettext.sh}
+-* gettext Invocation:: Invoking the @code{gettext} program
+-* ngettext Invocation:: Invoking the @code{ngettext} program
+-* envsubst Invocation:: Invoking the @code{envsubst} program
+-* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
+-* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
++* gettext Invocation:: Invoking the @code{gettext} program
++* ngettext:: Invoking the @code{ngettext} program
++* envsubst:: Invoking the @code{envsubst} program
++* eval_gettext:: Invoking the @code{eval_gettext} function
++* eval_ngettext:: Invoking the @code{eval_ngettext} function
+
+ Perl
+
+@@ -889,7 +889,7 @@
exactly where in C sources each string is used. All translations
- are set to empty. The letter @kbd{t} in @file{.pot} marks this as
+ are set to empty. The letter @code{t} in @file{.pot} marks this as
a Template PO file, not yet oriented towards any particular language.
-@xref{xgettext Invocation}, for more details about how one calls the
+@xref{xgettext}, for more details about how one calls the
@code{xgettext} program. If you are @emph{really} lazy, you might
be interested at working a lot more right away, and preparing the
whole distribution setup (@pxref{Maintainers}). By doing so, you
-@@ -710,7 +710,7 @@
+@@ -966,7 +966,7 @@
which are no longer used in the program sources (@pxref{Obsolete
Entries}). It finally discovers new strings and inserts them in
the resulting PO file as untranslated entries (@pxref{Untranslated
@code{msgmerge} really does.
Whatever route or means taken, the goal is to obtain an updated
-@@ -736,9 +736,9 @@
+@@ -990,8 +990,8 @@
Once the PO file is complete and dependable, the @code{msgfmt} program
is used for turning the PO file into a machine-oriented format, which
may yield efficient retrieval of translations by the programs of the
-package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt
--Invocation}, for more information about all modalities of execution
--for the @code{msgfmt} program.
+-Invocation}, for more information about all modes of execution
+package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt},
-+for more information about all modalities of execution for the @code{msgfmt}
-+program.
++for more information about all modes of execution
+ for the @code{msgfmt} program.
Finally, the modified and marked C sources are compiled and linked
- with the GNU @code{gettext} library, usually through the operation of
-@@ -890,7 +890,7 @@
+@@ -1171,7 +1171,7 @@
- In case the @kbd{c-format} flag is given for a string the @code{msgfmt}
+ In case the @code{c-format} flag is given for a string the @code{msgfmt}
does some more tests to check to validity of the translation.
--@xref{msgfmt Invocation}.
-+@xref{msgfmt}.
-
- @end table
+-@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}.
++@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}.
-@@ -1678,15 +1678,14 @@
- to use must contain the string @kbd{xgettext:no-c-format}.
+ @item objc-format
+ @kwindex objc-format@r{ flag}
+@@ -2451,7 +2451,7 @@
- If a string is marked with @kbd{c-format} and this is not correct the
--user can find out who is responsible for the decision. @xref{xgettext
--Invocation} to see how the @kbd{--debug} option can be used for solving
--this problem.
-+user can find out who is responsible for the decision. @xref{xgettext},
-+to see how the @kbd{--debug} option can be used for solving this problem.
+ If a string is marked with @code{c-format} and this is not correct the
+ user can find out who is responsible for the decision. See
+-@ref{xgettext Invocation} to see how the @code{--debug} option can be
++@ref{xgettext} to see how the @code{--debug} option can be
+ used for solving this problem.
- @node Special cases, , c-format, Sources
- @section Special Cases of Translatable Strings
-
- The attentive reader might now point out that it is not always possible
--to mark translatable string with @code{gettext} or something like this.
-+to mark translatable string with @code{gettext}, or something like this.
- Consider the following case:
-
- @example
-@@ -1710,7 +1709,7 @@
+ @node Special cases, Names, c-format Flag, Sources
+@@ -2483,7 +2483,7 @@
While it is no problem to mark the string @code{"a default message"} it
is not possible to mark the string initializers for @code{messages}.
What is to be done? We have to fulfill two tasks. First we have to mark the
can find them, and second we have to translate the string at runtime
before printing them.
-@@ -1740,8 +1739,7 @@
+@@ -2513,8 +2513,7 @@
Please convince yourself that the string which is written by
@code{fputs} is translated in any case. How to get @code{xgettext} know
The above is of course not the only solution. You could also come along
with the following one:
-@@ -1783,12 +1781,12 @@
+@@ -2736,10 +2735,10 @@
@c FIXME: Rewrite.
@menu
-* xgettext Invocation:: Invoking the @code{xgettext} Program
-+* xgettext:: Invoking the @code{xgettext} Program
- * C Sources Context:: C Sources Context
- * Compendium:: Using Translation Compendiums
++* xgettext:: Invoking the @code{xgettext} Program
@end menu
--@node xgettext Invocation, C Sources Context, Initial, Initial
-+@node xgettext, C Sources Context, Initial, Initial
+-@node xgettext Invocation, , Template, Template
++@node xgettext, , Template, Template
@section Invoking the @code{xgettext} Program
- @c FIXME: Rewrite.
-@@ -1915,7 +1913,7 @@
- cases, like strings in preprocessor macros, ANSI concatenation of
- adjacent strings, and escaped end of lines for continued strings.
+ @include xgettext.texi
+@@ -2768,16 +2767,16 @@
+ the header entry of this file.
+
+ @menu
+-* msginit Invocation:: Invoking the @code{msginit} Program
++* msginit:: Invoking the @code{msginit} Program
+ * Header Entry:: Filling in the Header Entry
+ @end menu
+
+-@node msginit Invocation, Header Entry, Creating, Creating
++@node msginit, Header Entry, Creating, Creating
+ @section Invoking the @code{msginit} Program
+
+ @include msginit.texi
--@node C Sources Context, Compendium, xgettext Invocation, Initial
-+@node C Sources Context, Compendium, xgettext, Initial
- @section C Sources Context
+-@node Header Entry, , msginit Invocation, Creating
++@node Header Entry, , msginit, Creating
+ @section Filling in the Header Entry
+ @cindex header entry of a PO file
- PO mode is particularily powerful when used with PO files
-@@ -2040,7 +2038,7 @@
+@@ -2952,7 +2951,7 @@
@c FIXME: Rewrite.
@menu
-* msgmerge Invocation:: Invoking the @code{msgmerge} Program
-+* msgmerge:: Invoking the @code{msgmerge} Program
- * Translated Entries::
- * Fuzzy Entries::
++* msgmerge:: Invoking the @code{msgmerge} Program
+ * Translated Entries:: Translated Entries
+ * Fuzzy Entries:: Fuzzy Entries
* Untranslated Entries:: Untranslated Entries
-@@ -2050,7 +2048,7 @@
- * Auxiliary:: Consulting Auxiliary PO Files
+@@ -2965,12 +2964,12 @@
+ * Compendium:: Using Translation Compendia
@end menu
-@node msgmerge Invocation, Translated Entries, Updating, Updating
+@node msgmerge, Translated Entries, Updating, Updating
@section Invoking the @code{msgmerge} Program
- @c FIXME: Rewrite.
-@@ -2642,11 +2640,11 @@
+ @include msgmerge.texi
+
+-@node Translated Entries, Fuzzy Entries, msgmerge Invocation, Updating
++@node Translated Entries, Fuzzy Entries, msgmerge, Updating
+ @section Translated Entries
+ @cindex translated entries
+
+@@ -4012,70 +4011,70 @@
+ write other specialized programs that process PO files.
+
+ @menu
+-* msgcat Invocation:: Invoking the @code{msgcat} Program
+-* msgconv Invocation:: Invoking the @code{msgconv} Program
+-* msggrep Invocation:: Invoking the @code{msggrep} Program
+-* msgfilter Invocation:: Invoking the @code{msgfilter} Program
+-* msguniq Invocation:: Invoking the @code{msguniq} Program
+-* msgcomm Invocation:: Invoking the @code{msgcomm} Program
+-* msgcmp Invocation:: Invoking the @code{msgcmp} Program
+-* msgattrib Invocation:: Invoking the @code{msgattrib} Program
+-* msgen Invocation:: Invoking the @code{msgen} Program
+-* msgexec Invocation:: Invoking the @code{msgexec} Program
++* msgcat:: Invoking the @code{msgcat} Program
++* msgconv:: Invoking the @code{msgconv} Program
++* msggrep:: Invoking the @code{msggrep} Program
++* msgfilter:: Invoking the @code{msgfilter} Program
++* msguniq:: Invoking the @code{msguniq} Program
++* msgcomm:: Invoking the @code{msgcomm} Program
++* msgcmp:: Invoking the @code{msgcmp} Program
++* msgattrib:: Invoking the @code{msgattrib} Program
++* msgen:: Invoking the @code{msgen} Program
++* msgexec:: Invoking the @code{msgexec} Program
+ * libgettextpo:: Writing your own programs that process PO files
+ @end menu
+
+-@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating
++@node msgcat, msgconv, Manipulating, Manipulating
+ @section Invoking the @code{msgcat} Program
+
+ @include msgcat.texi
+
+-@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating
++@node msgconv, msggrep, msgcat, Manipulating
+ @section Invoking the @code{msgconv} Program
+
+ @include msgconv.texi
+
+-@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating
++@node msggrep, msgfilter, msgconv, Manipulating
+ @section Invoking the @code{msggrep} Program
+
+ @include msggrep.texi
+
+-@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating
++@node msgfilter, msguniq, msggrep, Manipulating
+ @section Invoking the @code{msgfilter} Program
+
+ @include msgfilter.texi
+
+-@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating
++@node msguniq, msgcomm, msgfilter, Manipulating
+ @section Invoking the @code{msguniq} Program
+
+ @include msguniq.texi
+
+-@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating
++@node msgcomm, msgcmp, msguniq, Manipulating
+ @section Invoking the @code{msgcomm} Program
+
+ @include msgcomm.texi
+
+-@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating
++@node msgcmp, msgattrib, msgcomm, Manipulating
+ @section Invoking the @code{msgcmp} Program
+
+ @include msgcmp.texi
+
+-@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating
++@node msgattrib, msgen, msgcmp, Manipulating
+ @section Invoking the @code{msgattrib} Program
+
+ @include msgattrib.texi
+
+-@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating
++@node msgen, msgexec, msgattrib, Manipulating
+ @section Invoking the @code{msgen} Program
+
+ @include msgen.texi
+
+-@node msgexec Invocation, libgettextpo, msgen Invocation, Manipulating
++@node msgexec, libgettextpo, msgen, Manipulating
+ @section Invoking the @code{msgexec} Program
+
+ @include msgexec.texi
+
+-@node libgettextpo, , msgexec Invocation, Manipulating
++@node libgettextpo, , msgexec, Manipulating
+ @section Writing your own programs that process PO files
+
+ For the tasks for which a combination of @samp{msgattrib}, @samp{msgcat} etc.
+@@ -4209,22 +4208,22 @@
@c FIXME: Rewrite.
@menu
-* msgfmt Invocation:: Invoking the @code{msgfmt} Program
-+* msgfmt:: Invoking the @code{msgfmt} Program
+-* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
++* msgfmt:: Invoking the @code{msgfmt} Program
++* msgunfmt:: Invoking the @code{msgunfmt} Program
* MO Files:: The Format of GNU MO Files
@end menu
--@node msgfmt Invocation, MO Files, Binaries, Binaries
-+@node msgfmt, MO Files, Binaries, Binaries
+-@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries
++@node msgfmt, msgunfmt, Binaries, Binaries
@section Invoking the @code{msgfmt} Program
- @c FIXME: Rewrite.
-@@ -2722,7 +2720,7 @@
- If input file is @samp{-}, standard input is read. If output file
- is @samp{-}, output is written to standard output.
+ @include msgfmt.texi
--@node MO Files, , msgfmt Invocation, Binaries
-+@node MO Files, , msgfmt, Binaries
- @section The Format of GNU MO Files
+-@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries
++@node msgunfmt, MO Files, msgfmt, Binaries
+ @section Invoking the @code{msgunfmt} Program
+
+ @include msgunfmt.texi
- The format of the generated MO files is best described by a picture,
-@@ -3078,7 +3076,7 @@
- method of normal file handling (open-use-close) and that it does not
- burden the programmer so many task, especially the unique key handling.
- Of course here is also a unique key needed, but this key is the
--message itself (how long or short it is). @xref{Comparison} for a
-+message itself (how long or short it is). @xref{Comparison}, for a
- more detailed comparison of the two methods.
-
- The following section contains a rather detailed description of the
-@@ -4146,7 +4144,7 @@
+-@node MO Files, , msgunfmt Invocation, Binaries
++@node MO Files, , msgunfmt, Binaries
+ @section The Format of GNU MO Files
+ @cindex MO file's format
+ @cindex file format, @file{.mo}
+@@ -6237,7 +6236,7 @@
@menu
* Flat and Non-Flat:: Flat or Non-Flat Directory Structures
* Prerequisites:: Prerequisite Works
-* gettextize Invocation:: Invoking the @code{gettextize} Program
-+* gettextize:: Invoking the @code{gettextize} Program
++* gettextize:: Invoking the @code{gettextize} Program
* Adjusting Files:: Files You Must Create or Alter
- @end menu
-
-@@ -4181,7 +4179,7 @@
- to flat distributions, we might add some notes about how to proceed
- in flat situations.
+ * autoconf macros:: Autoconf macros for use in @file{configure.in}
+ * CVS Issues:: Integrating with CVS
+@@ -6269,7 +6268,7 @@
+ described in the remaining of this chapter. Some maintainers might
+ use this as an opportunity to unflatten their package structure.
-@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers
+@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers
@section Prerequisite Works
-
- There are some works which are required for using GNU @code{gettext}
-@@ -4261,7 +4259,7 @@
+ @cindex converting a package to use @code{gettext}
+ @cindex migration from earlier versions of @code{gettext}
+@@ -6354,12 +6353,12 @@
a maintainer, ever think there is a real problem with a team, please
never try to @emph{solve} a team's problem on your own.
+@node gettextize, Adjusting Files, Prerequisites, Maintainers
@section Invoking the @code{gettextize} Program
- Some files are consistently and identically needed in every package
-@@ -4353,7 +4351,7 @@
- directory needs its own @file{Makefile}, and it has been designed so
- it can be identical in all packages.
+ @include gettextize.texi
--@node Adjusting Files, , gettextize Invocation, Maintainers
-+@node Adjusting Files, , gettextize, Maintainers
+-@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers
++@node Adjusting Files, autoconf macros, gettextize, Maintainers
@section Files You Must Create or Alter
+ @cindex @code{gettext} files
+
+@@ -7137,7 +7136,7 @@
+ @menu
+ * Distributed CVS:: Avoiding version mismatch in distributed development
+ * Files under CVS:: Files to put under CVS version control
+-* autopoint Invocation:: Invoking the @code{autopoint} Program
++* autopoint:: Invoking the @code{autopoint} Program
+ @end menu
+
+ @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues
+@@ -7179,7 +7178,7 @@
+ undiscovered due to this constellation.
+ @end itemize
+
+-@node Files under CVS, autopoint Invocation, Distributed CVS, CVS Issues
++@node Files under CVS, autopoint, Distributed CVS, CVS Issues
+ @subsection Files to put under CVS version control
+
+ There are basically three ways to deal with generated files in the
+@@ -7246,7 +7245,7 @@
+ @code{autopoint} invocation will copy into the right place the
+ @code{gettext} infrastructure files that have been omitted from the CVS.
+
+-@node autopoint Invocation, , Files under CVS, CVS Issues
++@node autopoint, , Files under CVS, CVS Issues
+ @subsection Invoking the @code{autopoint} Program
- Besides files which are automatically added through @code{gettextize},
+ @include autopoint.texi
+@@ -7843,11 +7842,11 @@
+ @menu
+ * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
+ * gettext.sh:: Contents of @code{gettext.sh}
+-* gettext Invocation:: Invoking the @code{gettext} program
+-* ngettext Invocation:: Invoking the @code{ngettext} program
+-* envsubst Invocation:: Invoking the @code{envsubst} program
+-* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
+-* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
++* gettext Invocation:: Invoking the @code{gettext} program
++* ngettext:: Invoking the @code{ngettext} program
++* envsubst:: Invoking the @code{envsubst} program
++* eval_gettext:: Invoking the @code{eval_gettext} function
++* eval_ngettext:: Invoking the @code{eval_ngettext} function
+ @end menu
+
+ @node Preparing Shell Scripts, gettext.sh, sh, sh
+@@ -7868,8 +7867,8 @@
+
+ near the top of the script. @code{gettext.sh} is a shell function library
+ that provides the functions
+-@code{eval_gettext} (see @ref{eval_gettext Invocation}) and
+-@code{eval_ngettext} (see @ref{eval_ngettext Invocation}).
++@code{eval_gettext} (see @ref{eval_gettext}) and
++@code{eval_ngettext} (see @ref{eval_ngettext}).
+ You have to ensure that @code{gettext.sh} can be found in the @code{PATH}.
+
+ @item
+@@ -7930,7 +7929,7 @@
+ @samp{eval_ngettext}, followed by a no-argument @samp{echo} command.
+ @end enumerate
+
+-@node gettext.sh, gettext Invocation, Preparing Shell Scripts, sh
++@node gettext.sh, gettext Invocation, Preparing Shell Scripts, sh
+ @subsubsection Contents of @code{gettext.sh}
+
+ @code{gettext.sh}, contained in the run-time package of GNU gettext, provides
+@@ -7942,28 +7941,28 @@
+ and a newline, without interpreting backslashes in the argument string.
+
+ @item eval_gettext
+-See @ref{eval_gettext Invocation}.
++See @ref{eval_gettext}.
+
+ @item eval_ngettext
+-See @ref{eval_ngettext Invocation}.
++See @ref{eval_ngettext}.
+ @end itemize
+
+-@node gettext Invocation, ngettext Invocation, gettext.sh, sh
++@node gettext Invocation, ngettext, gettext.sh, sh
+ @subsubsection Invoking the @code{gettext} program
+
+ @include rt-gettext.texi
+
+-@node ngettext Invocation, envsubst Invocation, gettext Invocation, sh
++@node ngettext, envsubst, gettext Invocation, sh
+ @subsubsection Invoking the @code{ngettext} program
+
+ @include rt-ngettext.texi
+
+-@node envsubst Invocation, eval_gettext Invocation, ngettext Invocation, sh
++@node envsubst, eval_gettext, ngettext, sh
+ @subsubsection Invoking the @code{envsubst} program
+
+ @include rt-envsubst.texi
+
+-@node eval_gettext Invocation, eval_ngettext Invocation, envsubst Invocation, sh
++@node eval_gettext, eval_ngettext, envsubst, sh
+ @subsubsection Invoking the @code{eval_gettext} function
+
+ @cindex @code{eval_gettext} function, usage
+@@ -7976,7 +7975,7 @@
+ performing dollar-substitution on the result. Note that only shell variables
+ mentioned in @var{msgid} will be dollar-substituted in the result.
+
+-@node eval_ngettext Invocation, , eval_gettext Invocation, sh
++@node eval_ngettext, , eval_gettext, sh
+ @subsubsection Invoking the @code{eval_ngettext} function
+
+ @cindex @code{eval_ngettext} function, usage
+--- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig 2003-05-05 11:09:21.000000000 +0200
++++ gettext-0.12.1/gettext-tools/doc/gettextize.texi 2003-06-07 20:10:53.000000000 +0200
+@@ -177,4 +177,4 @@
+ of the GNU build system, in the sense that it should not be invoked
+ automatically, and not be invoked by someone who doesn't assume the
+ responsibilities of a package maintainer. For the latter purpose, a
+-separate tool is provided, see @ref{autopoint Invocation}.
++separate tool is provided, see @ref{autopoint}.
+--- gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi.orig Fri May 30 16:30:21 2003
++++ gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi Mon Dec 1 15:52:12 2003
+@@ -15,9 +15,9 @@
+ @c %**end of header
+ @set VERSION 1.0
+
+-@dircategory C++ libraries
++@dircategory Libraries:
+ @direntry
+-* autosprintf: (autosprintf). Support for printf format strings in C++.
++* autosprintf: (autosprintf). Support for printf format strings in C++
+ @end direntry
+
+ @ifinfo