mingw/gettext/gettext-tools/doc/autopoint.texi

@c This file is part of the GNU gettext manual.
@c Copyright (C) 1995-2019 Free Software Foundation, Inc.
@c See the file gettext.texi for copying conditions.

@pindex autopoint
@cindex @code{autopoint} program, usage
@example
autopoint [@var{option}]...
@end example

The @code{autopoint} program copies standard gettext infrastructure files
into a source package.  It extracts from a macro call of the form
@code{AM_GNU_GETTEXT_VERSION(@var{version})}, found in the package's
@file{configure.in} or @file{configure.ac} file, the gettext version
used by the package, and copies the infrastructure files belonging to
this version into the package.

To extract the latest available infrastructure which satisfies a version
requirement, then you can use the form
@code{AM_GNU_GETTEXT_REQUIRE_VERSION(@var{version})} instead.  For
example, if gettext @value{ARCHIVE-VERSION} is installed on your system
and @code{0.19.1} is requested, then the infrastructure files of version
@value{ARCHIVE-VERSION} will be copied into a source package.

@subsubsection Options

@table @samp
@item -f
@itemx --force
@opindex -f@r{, @code{autopoint} option}
@opindex --force@r{, @code{autopoint} option}
Force overwriting of files that already exist.

@item -n
@itemx --dry-run
@opindex -d@r{, @code{autopoint} option}
@opindex --dry-run@r{, @code{autopoint} option}
Print modifications but don't perform them.  All file copying actions that
@code{autopoint} would normally execute are inhibited and instead only
listed on standard output.

@end table

@subsubsection Informative output

@table @samp
@item --help
@opindex --help@r{, @code{autopoint} option}
Display this help and exit.

@item --version
@opindex --version@r{, @code{autopoint} option}
Output version information and exit.

@end table

@code{autopoint} supports the GNU @code{gettext} versions from 0.10.35
to the current one, @value{ARCHIVE-VERSION}.  In order to apply
@code{autopoint} to a package using a @code{gettext} version newer than
@value{ARCHIVE-VERSION}, you need to install this same version of GNU
@code{gettext} at least.

In packages using GNU @code{automake}, an invocation of @code{autopoint}
should be followed by invocations of @code{aclocal} and then @code{autoconf}
and @code{autoheader}.  The reason is that @code{autopoint} installs some
autoconf macro files, which are used by @code{aclocal} to create
@file{aclocal.m4}, and the latter is used by @code{autoconf} to create the
package's @file{configure} script and by @code{autoheader} to create the
package's @file{config.h.in} include file template.

The name @samp{autopoint} is an abbreviation of @samp{auto-po-intl-m4};
in earlier versions, the tool copied or updated mostly files in the @file{po},
@file{intl}, @file{m4} directories.