summaryrefslogtreecommitdiff
path: root/gettext-tools/doc/autopoint.texi
blob: 264bd7880d7cdc30a2828210e22591276d87b9f5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
@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};
the tool copies or updates mostly files in the @file{po}, @file{intl},
@file{m4} directories.