Home | History | Annotate | Line # | Download | only in doc 
      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.
     62