~ubuntu-branches/ubuntu/breezy/gettext/breezy

« back to all changes in this revision

Viewing changes to gettext-tools/doc/autopoint.texi

  • Committer: Bazaar Package Importer
  • Author(s): Santiago Vila
  • Date: 2004-03-14 17:40:02 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20040314174002-p1ad5ldve1hqzhye
Tags: 0.14.1-2
* Added libexpat1-dev to Build-Depends, for glade support.
* Added libc0.1-dev to Build-Depends, for GNU/kFreeBSD.
* Removed special-casing of knetbsd-gnu in debian/rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.