gettext-info.patch

   1 --- gettext-0.12.1/gettext-tools/doc/gettext.texi.orig  2003-05-05 11:09:21.000000000 +0200
   2 +++ gettext-0.12.1/gettext-tools/doc/gettext.texi       2003-06-07 20:17:27.000000000 +0200
   3 @@ -31,28 +31,28 @@
   4
   5  @include version.texi
   6
   7 -@dircategory GNU Gettext Utilities
   8 +@dircategory Programming tools:
   9  @direntry
  10 -* gettext: (gettext).                          GNU gettext utilities.
  11 -* autopoint: (gettext)autopoint Invocation.    Copy gettext infrastructure.
  12 -* gettextize: (gettext)gettextize Invocation.  Prepare a package for gettext.
  13 -* msgattrib: (gettext)msgattrib Invocation.    Select part of a PO file.
  14 -* msgcat: (gettext)msgcat Invocation.          Combine several PO files.
  15 -* msgcmp: (gettext)msgcmp Invocation.          Compare a PO file and template.
  16 -* msgcomm: (gettext)msgcomm Invocation.        Match two PO files.
  17 -* msgconv: (gettext)msgconv Invocation.        Convert PO file to encoding.
  18 -* msgen: (gettext)msgen Invocation.            Create an English PO file.
  19 -* msgexec: (gettext)msgexec Invocation.        Process a PO file.
  20 -* msgfilter: (gettext)msgfilter Invocation.    Pipe a PO file through a filter.
  21 -* msgfmt: (gettext)msgfmt Invocation.          Make MO files out of PO files.
  22 -* msggrep: (gettext)msggrep Invocation.        Select part of a PO file.
  23 -* msginit: (gettext)msginit Invocation.        Create a fresh PO file.
  24 -* msgmerge: (gettext)msgmerge Invocation.      Update a PO file from template.
  25 -* msgunfmt: (gettext)msgunfmt Invocation.      Uncompile MO file into PO file.
  26 -* msguniq: (gettext)msguniq Invocation.        Unify duplicates for PO file.
  27 -* xgettext: (gettext)xgettext Invocation.      Extract strings into a PO file.
  28 -* ISO639: (gettext)Language Codes.             ISO 639 language codes.
  29 -* ISO3166: (gettext)Country Codes.             ISO 3166 country codes.
  30 +* gettext: (gettext).                  GNU gettext utilities
  31 +* autopoint: (gettext)autopoint.       Copy gettext infrastructure
  32 +* gettextize: (gettext)gettextize.     Prepare a package for gettext
  33 +* msgattrib: (gettext)msgattrib.       Select part of a PO file
  34 +* msgcat: (gettext)msgcat.             Combine several PO files
  35 +* msgcmp: (gettext)msgcmp.             Compare a PO file and template
  36 +* msgcomm: (gettext)msgcomm.           Match two PO files
  37 +* msgconv: (gettext)msgconv.           Convert PO file to encoding
  38 +* msgen: (gettext)msgen.               Create an English PO file
  39 +* msgexec: (gettext)msgexec.           Process a PO file
  40 +* msgfilter: (gettext)msgfilter.       Pipe a PO file through a filter
  41 +* msgfmt: (gettext)msgfmt.             Make MO files out of PO files
  42 +* msggrep: (gettext)msggrep.           Select part of a PO file
  43 +* msginit: (gettext)msginit.           Create a fresh PO file
  44 +* msgmerge: (gettext)msgmerge.         Update a PO file from template
  45 +* msgunfmt: (gettext)msgunfmt.         Uncompile MO file into PO file
  46 +* msguniq: (gettext)msguniq.           Unify duplicates for PO file
  47 +* xgettext: (gettext)xgettext.         Extract strings into a PO file
  48 +* ISO639: (gettext)Language Codes.     ISO 639 language codes
  49 +* ISO3166: (gettext)Country Codes.     ISO 3166 country codes
  50  @end direntry
  51
  52  @ifinfo
  53 @@ -175,16 +175,16 @@
  54
  55  Making the PO Template File
  56
  57 -* xgettext Invocation::         Invoking the @code{xgettext} Program
  58 +* xgettext::                    Invoking the @code{xgettext} Program
  59
  60  Creating a New PO File
  61
  62 -* msginit Invocation::          Invoking the @code{msginit} Program
  63 +* msginit::                     Invoking the @code{msginit} Program
  64  * Header Entry::                Filling in the Header Entry
  65
  66  Updating Existing PO Files
  67
  68 -* msgmerge Invocation::         Invoking the @code{msgmerge} Program
  69 +* msgmerge::                    Invoking the @code{msgmerge} Program
  70  * Translated Entries::          Translated Entries
  71  * Fuzzy Entries::               Fuzzy Entries
  72  * Untranslated Entries::        Untranslated Entries
  73 @@ -203,22 +203,22 @@
  74
  75  Manipulating PO Files
  76
  77 -* msgcat Invocation::           Invoking the @code{msgcat} Program
  78 -* msgconv Invocation::          Invoking the @code{msgconv} Program
  79 -* msggrep Invocation::          Invoking the @code{msggrep} Program
  80 -* msgfilter Invocation::        Invoking the @code{msgfilter} Program
  81 -* msguniq Invocation::          Invoking the @code{msguniq} Program
  82 -* msgcomm Invocation::          Invoking the @code{msgcomm} Program
  83 -* msgcmp Invocation::           Invoking the @code{msgcmp} Program
  84 -* msgattrib Invocation::        Invoking the @code{msgattrib} Program
  85 -* msgen Invocation::            Invoking the @code{msgen} Program
  86 -* msgexec Invocation::          Invoking the @code{msgexec} Program
  87 +* msgcat::                      Invoking the @code{msgcat} Program
  88 +* msgconv::                     Invoking the @code{msgconv} Program
  89 +* msggrep::                     Invoking the @code{msggrep} Program
  90 +* msgfilter::                   Invoking the @code{msgfilter} Program
  91 +* msguniq::                     Invoking the @code{msguniq} Program
  92 +* msgcomm::                     Invoking the @code{msgcomm} Program
  93 +* msgcmp::                      Invoking the @code{msgcmp} Program
  94 +* msgattrib::                   Invoking the @code{msgattrib} Program
  95 +* msgen::                       Invoking the @code{msgen} Program
  96 +* msgexec::                     Invoking the @code{msgexec} Program
  97  * libgettextpo::                Writing your own programs that process PO files
  98
  99  Producing Binary MO Files
 100
 101 -* msgfmt Invocation::           Invoking the @code{msgfmt} Program
 102 -* msgunfmt Invocation::         Invoking the @code{msgunfmt} Program
 103 +* msgfmt::                      Invoking the @code{msgfmt} Program
 104 +* msgunfmt::                    Invoking the @code{msgunfmt} Program
 105  * MO Files::                    The Format of GNU MO Files
 106
 107  The User's View
 108 @@ -282,7 +282,7 @@
 109
 110  * Flat and Non-Flat::           Flat or Non-Flat Directory Structures
 111  * Prerequisites::               Prerequisite Works
 112 -* gettextize Invocation::       Invoking the @code{gettextize} Program
 113 +* gettextize::                  Invoking the @code{gettextize} Program
 114  * Adjusting Files::             Files You Must Create or Alter
 115  * autoconf macros::             Autoconf macros for use in @file{configure.in}
 116  * CVS Issues::                  Integrating with CVS
 117 @@ -313,7 +313,7 @@
 118
 119  * Distributed CVS::             Avoiding version mismatch in distributed development
 120  * Files under CVS::             Files to put under CVS version control
 121 -* autopoint Invocation::        Invoking the @code{autopoint} Program
 122 +* autopoint::                   Invoking the @code{autopoint} Program
 123
 124  Other Programming Languages
 125
 126 @@ -856,7 +856,7 @@
 127  exactly where in C sources each string is used.  All translations
 128  are set to empty.  The letter @code{t} in @file{.pot} marks this as
 129  a Template PO file, not yet oriented towards any particular language.
 130 -@xref{xgettext Invocation}, for more details about how one calls the
 131 +@xref{xgettext}, for more details about how one calls the
 132  @code{xgettext} program.  If you are @emph{really} lazy, you might
 133  be interested at working a lot more right away, and preparing the
 134  whole distribution setup (@pxref{Maintainers}).  By doing so, you
 135 @@ -933,7 +933,7 @@
 136  which are no longer used in the program sources (@pxref{Obsolete
 137  Entries}).  It finally discovers new strings and inserts them in
 138  the resulting PO file as untranslated entries (@pxref{Untranslated
 139 -Entries}).  @xref{msgmerge Invocation}, for more information about what
 140 +Entries}).  @xref{msgmerge}, for more information about what
 141  @code{msgmerge} really does.
 142
 143  Whatever route or means taken, the goal is to obtain an updated
 144 @@ -957,8 +957,8 @@
 145  Once the PO file is complete and dependable, the @code{msgfmt} program
 146  is used for turning the PO file into a machine-oriented format, which
 147  may yield efficient retrieval of translations by the programs of the
 148 -package, whenever needed at runtime (@pxref{MO Files}).  @xref{msgfmt
 149 -Invocation}, for more information about all modes of execution
 150 +package, whenever needed at runtime (@pxref{MO Files}).  @xref{msgfmt},
 151 +for more information about all modes of execution
 152  for the @code{msgfmt} program.
 153
 154  Finally, the modified and marked C sources are compiled and linked
 155 @@ -1138,7 +1138,7 @@
 156
 157  In case the @code{c-format} flag is given for a string the @code{msgfmt}
 158  does some more tests to check to validity of the translation.
 159 -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}.
 160 +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}.
 161
 162  @item python-format
 163  @kwindex python-format@r{ flag}
 164 @@ -2344,7 +2344,7 @@
 165
 166  If a string is marked with @code{c-format} and this is not correct the
 167  user can find out who is responsible for the decision.  See
 168 -@ref{xgettext Invocation} to see how the @code{--debug} option can be
 169 +@ref{xgettext} to see how the @code{--debug} option can be
 170  used for solving this problem.
 171
 172  @node Special cases, Names, c-format Flag, Sources
 173 @@ -2376,7 +2376,7 @@
 174  While it is no problem to mark the string @code{"a default message"} it
 175  is not possible to mark the string initializers for @code{messages}.
 176  What is to be done?  We have to fulfill two tasks.  First we have to mark the
 177 -strings so that the @code{xgettext} program (@pxref{xgettext Invocation})
 178 +strings so that the @code{xgettext} program (@pxref{xgettext})
 179  can find them, and second we have to translate the string at runtime
 180  before printing them.
 181
 182 @@ -2406,8 +2406,7 @@
 183
 184  Please convince yourself that the string which is written by
 185  @code{fputs} is translated in any case.  How to get @code{xgettext} know
 186 -the additional keyword @code{gettext_noop} is explained in @ref{xgettext
 187 -Invocation}.
 188 +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}.
 189
 190  The above is of course not the only solution.  You could also come along
 191  with the following one:
 192 @@ -2529,10 +2528,10 @@
 193  @c FIXME: Rewrite.
 194
 195  @menu
 196 -* xgettext Invocation::         Invoking the @code{xgettext} Program
 197 +* xgettext::                    Invoking the @code{xgettext} Program
 198  @end menu
 199
 200 -@node xgettext Invocation,  , Template, Template
 201 +@node xgettext,  , Template, Template
 202  @section Invoking the @code{xgettext} Program
 203
 204  @include xgettext.texi
 205 @@ -2561,16 +2560,16 @@
 206  the header entry of this file.
 207
 208  @menu
 209 -* msginit Invocation::          Invoking the @code{msginit} Program
 210 +* msginit::                     Invoking the @code{msginit} Program
 211  * Header Entry::                Filling in the Header Entry
 212  @end menu
 213
 214 -@node msginit Invocation, Header Entry, Creating, Creating
 215 +@node msginit, Header Entry, Creating, Creating
 216  @section Invoking the @code{msginit} Program
 217
 218  @include msginit.texi
 219
 220 -@node Header Entry,  , msginit Invocation, Creating
 221 +@node Header Entry,  , msginit, Creating
 222  @section Filling in the Header Entry
 223  @cindex header entry of a PO file
 224
 225 @@ -2745,7 +2744,7 @@
 226  @c FIXME: Rewrite.
 227
 228  @menu
 229 -* msgmerge Invocation::         Invoking the @code{msgmerge} Program
 230 +* msgmerge::                    Invoking the @code{msgmerge} Program
 231  * Translated Entries::          Translated Entries
 232  * Fuzzy Entries::               Fuzzy Entries
 233  * Untranslated Entries::        Untranslated Entries
 234 @@ -2758,12 +2757,12 @@
 235  * Compendium::                  Using Translation Compendia
 236  @end menu
 237
 238 -@node msgmerge Invocation, Translated Entries, Updating, Updating
 239 +@node msgmerge, Translated Entries, Updating, Updating
 240  @section Invoking the @code{msgmerge} Program
 241
 242  @include msgmerge.texi
 243
 244 -@node Translated Entries, Fuzzy Entries, msgmerge Invocation, Updating
 245 +@node Translated Entries, Fuzzy Entries, msgmerge, Updating
 246  @section Translated Entries
 247  @cindex translated entries
 248
 249 @@ -3805,70 +3804,70 @@
 250  write other specialized programs that process PO files.
 251
 252  @menu
 253 -* msgcat Invocation::           Invoking the @code{msgcat} Program
 254 -* msgconv Invocation::          Invoking the @code{msgconv} Program
 255 -* msggrep Invocation::          Invoking the @code{msggrep} Program
 256 -* msgfilter Invocation::        Invoking the @code{msgfilter} Program
 257 -* msguniq Invocation::          Invoking the @code{msguniq} Program
 258 -* msgcomm Invocation::          Invoking the @code{msgcomm} Program
 259 -* msgcmp Invocation::           Invoking the @code{msgcmp} Program
 260 -* msgattrib Invocation::        Invoking the @code{msgattrib} Program
 261 -* msgen Invocation::            Invoking the @code{msgen} Program
 262 -* msgexec Invocation::          Invoking the @code{msgexec} Program
 263 +* msgcat::                      Invoking the @code{msgcat} Program
 264 +* msgconv::                     Invoking the @code{msgconv} Program
 265 +* msggrep::                     Invoking the @code{msggrep} Program
 266 +* msgfilter::                   Invoking the @code{msgfilter} Program
 267 +* msguniq::                     Invoking the @code{msguniq} Program
 268 +* msgcomm::                     Invoking the @code{msgcomm} Program
 269 +* msgcmp::                      Invoking the @code{msgcmp} Program
 270 +* msgattrib::                   Invoking the @code{msgattrib} Program
 271 +* msgen::                       Invoking the @code{msgen} Program
 272 +* msgexec::                     Invoking the @code{msgexec} Program
 273  * libgettextpo::                Writing your own programs that process PO files
 274  @end menu
 275
 276 -@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating
 277 +@node msgcat, msgconv, Manipulating, Manipulating
 278  @section Invoking the @code{msgcat} Program
 279
 280  @include msgcat.texi
 281
 282 -@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating
 283 +@node msgconv, msggrep, msgcat, Manipulating
 284  @section Invoking the @code{msgconv} Program
 285
 286  @include msgconv.texi
 287
 288 -@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating
 289 +@node msggrep, msgfilter, msgconv, Manipulating
 290  @section Invoking the @code{msggrep} Program
 291
 292  @include msggrep.texi
 293
 294 -@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating
 295 +@node msgfilter, msguniq, msggrep, Manipulating
 296  @section Invoking the @code{msgfilter} Program
 297
 298  @include msgfilter.texi
 299
 300 -@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating
 301 +@node msguniq, msgcomm, msgfilter, Manipulating
 302  @section Invoking the @code{msguniq} Program
 303
 304  @include msguniq.texi
 305
 306 -@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating
 307 +@node msgcomm, msgcmp, msguniq, Manipulating
 308  @section Invoking the @code{msgcomm} Program
 309
 310  @include msgcomm.texi
 311
 312 -@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating
 313 +@node msgcmp, msgattrib, msgcomm, Manipulating
 314  @section Invoking the @code{msgcmp} Program
 315
 316  @include msgcmp.texi
 317
 318 -@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating
 319 +@node msgattrib, msgen, msgcmp, Manipulating
 320  @section Invoking the @code{msgattrib} Program
 321
 322  @include msgattrib.texi
 323
 324 -@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating
 325 +@node msgen, msgexec, msgattrib, Manipulating
 326  @section Invoking the @code{msgen} Program
 327
 328  @include msgen.texi
 329
 330 -@node msgexec Invocation, libgettextpo, msgen Invocation, Manipulating
 331 +@node msgexec, libgettextpo, msgen, Manipulating
 332  @section Invoking the @code{msgexec} Program
 333
 334  @include msgexec.texi
 335
 336 -@node libgettextpo,  , msgexec Invocation, Manipulating
 337 +@node libgettextpo,  , msgexec, Manipulating
 338  @section Writing your own programs that process PO files
 339
 340  For the tasks for which a combination of @samp{msgattrib}, @samp{msgcat} etc.
 341 @@ -4002,22 +4001,22 @@
 342  @c FIXME: Rewrite.
 343
 344  @menu
 345 -* msgfmt Invocation::           Invoking the @code{msgfmt} Program
 346 -* msgunfmt Invocation::         Invoking the @code{msgunfmt} Program
 347 +* msgfmt::                      Invoking the @code{msgfmt} Program
 348 +* msgunfmt::                    Invoking the @code{msgunfmt} Program
 349  * MO Files::                    The Format of GNU MO Files
 350  @end menu
 351
 352 -@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries
 353 +@node msgfmt, msgunfmt, Binaries, Binaries
 354  @section Invoking the @code{msgfmt} Program
 355
 356  @include msgfmt.texi
 357
 358 -@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries
 359 +@node msgunfmt, MO Files, msgfmt, Binaries
 360  @section Invoking the @code{msgunfmt} Program
 361
 362  @include msgunfmt.texi
 363
 364 -@node MO Files,  , msgunfmt Invocation, Binaries
 365 +@node MO Files,  , msgunfmt, Binaries
 366  @section The Format of GNU MO Files
 367  @cindex MO file's format
 368  @cindex file format, @file{.mo}
 369 @@ -6014,7 +6013,7 @@
 370  @menu
 371  * Flat and Non-Flat::           Flat or Non-Flat Directory Structures
 372  * Prerequisites::               Prerequisite Works
 373 -* gettextize Invocation::       Invoking the @code{gettextize} Program
 374 +* gettextize::                  Invoking the @code{gettextize} Program
 375  * Adjusting Files::             Files You Must Create or Alter
 376  * autoconf macros::             Autoconf macros for use in @file{configure.in}
 377  * CVS Issues::                  Integrating with CVS
 378 @@ -6046,7 +6045,7 @@
 379  described in the remaining of this chapter.  Some maintainers might
 380  use this as an opportunity to unflatten their package structure.
 381
 382 -@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers
 383 +@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers
 384  @section Prerequisite Works
 385  @cindex converting a package to use @code{gettext}
 386  @cindex migration from earlier versions of @code{gettext}
 387 @@ -6131,12 +6130,12 @@
 388  a maintainer, ever think there is a real problem with a team, please
 389  never try to @emph{solve} a team's problem on your own.
 390
 391 -@node gettextize Invocation, Adjusting Files, Prerequisites, Maintainers
 392 +@node gettextize, Adjusting Files, Prerequisites, Maintainers
 393  @section Invoking the @code{gettextize} Program
 394
 395  @include gettextize.texi
 396
 397 -@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers
 398 +@node Adjusting Files, autoconf macros, gettextize, Maintainers
 399  @section Files You Must Create or Alter
 400  @cindex @code{gettext} files
 401
 402 @@ -6911,7 +6910,7 @@
 403  @menu
 404  * Distributed CVS::             Avoiding version mismatch in distributed development
 405  * Files under CVS::             Files to put under CVS version control
 406 -* autopoint Invocation::        Invoking the @code{autopoint} Program
 407 +* autopoint::                   Invoking the @code{autopoint} Program
 408  @end menu
 409
 410  @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues
 411 @@ -6953,7 +6952,7 @@
 412  undiscovered due to this constellation.
 413  @end itemize
 414
 415 -@node Files under CVS, autopoint Invocation, Distributed CVS, CVS Issues
 416 +@node Files under CVS, autopoint, Distributed CVS, CVS Issues
 417  @subsection Files to put under CVS version control
 418
 419  There are basically three ways to deal with generated files in the
 420 @@ -7020,7 +7019,7 @@
 421  @code{autopoint} invocation will copy into the right place the
 422  @code{gettext} infrastructure files that have been omitted from the CVS.
 423
 424 -@node autopoint Invocation,  , Files under CVS, CVS Issues
 425 +@node autopoint,  , Files under CVS, CVS Issues
 426  @subsection Invoking the @code{autopoint} Program
 427
 428  @include autopoint.texi
 429 --- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig       2003-05-05 11:09:21.000000000 +0200
 430 +++ gettext-0.12.1/gettext-tools/doc/gettextize.texi    2003-06-07 20:10:53.000000000 +0200
 431 @@ -177,4 +177,4 @@
 432  of the GNU build system, in the sense that it should not be invoked
 433  automatically, and not be invoked by someone who doesn't assume the
 434  responsibilities of a package maintainer.  For the latter purpose, a
 435 -separate tool is provided, see @ref{autopoint Invocation}.
 436 +separate tool is provided, see @ref{autopoint}.
 437 --- gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi.orig      Fri May 30 16:30:21 2003
 438 +++ gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi   Mon Dec  1 15:52:12 2003
 439 @@ -15,9 +15,9 @@
 440  @c %**end of header
 441  @set VERSION 1.0
 442
 443 -@dircategory C++ libraries
 444 +@dircategory Libraries:
 445  @direntry
 446 -* autosprintf: (autosprintf).   Support for printf format strings in C++.
 447 +* autosprintf: (autosprintf).          Support for printf format strings in C++
 448  @end direntry
 449
 450  @ifinfo