gettext-tools/doc/autopoint.texi

   1 @pindex autopoint
   2 @cindex @code{autopoint} program, usage
   3 @example
   4 autopoint [@var{option}]...
   5 @end example
   6
   7 The @code{autopoint} program copies standard gettext infrastructure files
   8 into a source package.  It extracts from a macro call of the form
   9 @code{AM_GNU_GETTEXT_VERSION(@var{version})}, found in the package's
  10 @file{configure.in} or @file{configure.ac} file, the gettext version
  11 used by the package, and copies the infrastructure files belonging to
  12 this version into the package.
  13
  14 @subsubsection Options
  15
  16 @table @samp
  17 @item -f
  18 @itemx --force
  19 @opindex -f@r{, @code{autopoint} option}
  20 @opindex --force@r{, @code{autopoint} option}
  21 Force overwriting of files that already exist.
  22
  23 @item -n
  24 @itemx --dry-run
  25 @opindex -d@r{, @code{autopoint} option}
  26 @opindex --dry-run@r{, @code{autopoint} option}
  27 Print modifications but don't perform them.  All file copying actions that
  28 @code{autopoint} would normally execute are inhibited and instead only
  29 listed on standard output.
  30
  31 @end table
  32
  33 @subsubsection Informative output
  34
  35 @table @samp
  36 @item --help
  37 @opindex --help@r{, @code{autopoint} option}
  38 Display this help and exit.
  39
  40 @item --version
  41 @opindex --version@r{, @code{autopoint} option}
  42 Output version information and exit.
  43
  44 @end table
  45
  46 @code{autopoint} supports the GNU @code{gettext} versions from 0.10.35 to
  47 the current one, @value{VERSION}.  In order to apply @code{autopoint} to
  48 a package using a @code{gettext} version newer than @value{VERSION}, you
  49 need to install this same version of GNU @code{gettext} at least.
  50
  51 In packages using GNU @code{automake}, an invocation of @code{autopoint}
  52 should be followed by invocations of @code{aclocal} and then @code{autoconf}
  53 and @code{autoheader}.  The reason is that @code{autopoint} installs some
  54 autoconf macro files, which are used by @code{aclocal} to create
  55 @file{aclocal.m4}, and the latter is used by @code{autoconf} to create the
  56 package's @file{configure} script and by @code{autoheader} to create the
  57 package's @file{config.h.in} include file template.
  58
  59 The name @samp{autopoint} is an abbreviation of @samp{auto-po-intl-m4};
  60 the tool copies or updates mostly files in the @file{po}, @file{intl},
  61 @file{m4} directories.