1@pindex autopoint
2@cindex @code{autopoint} program, usage
3@example
4autopoint [@var{option}]...
5@end example
6
7The @code{autopoint} program copies standard gettext infrastructure files
8into 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
11used by the package, and copies the infrastructure files belonging to
12this 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}
21Force 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}
27Print modifications but don't perform them.  All file copying actions that
28@code{autopoint} would normally execute are inhibited and instead only
29listed 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}
38Display this help and exit.
39
40@item --version
41@opindex --version@r{, @code{autopoint} option}
42Output version information and exit.
43
44@end table
45
46@code{autopoint} supports the GNU @code{gettext} versions from 0.10.35 to
47the current one, @value{VERSION}.  In order to apply @code{autopoint} to
48a package using a @code{gettext} version newer than @value{VERSION}, you
49need to install this same version of GNU @code{gettext} at least.
50
51In packages using GNU @code{automake}, an invocation of @code{autopoint}
52should be followed by invocations of @code{aclocal} and then @code{autoconf}
53and @code{autoheader}.  The reason is that @code{autopoint} installs some
54autoconf 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
56package's @file{configure} script and by @code{autoheader} to create the
57package's @file{config.h.in} include file template.
58
59The name @samp{autopoint} is an abbreviation of @samp{auto-po-intl-m4};
60the tool copies or updates mostly files in the @file{po}, @file{intl},
61@file{m4} directories.
62