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