1PO4A-UPDATEPO.1P(1) User Contributed Perl Documentation PO4A-UPDATEPO.1P(1)
2
6 po4a-updatepo - update the translation (in PO format) of documentation
7
9 po4a-updatepo -f fmt (-m master.doc)+ (-p XX.po)+
10 (XX.po are the outputs, all others are inputs)
12
14 The po4a (PO for anything) project goal is to ease translations (and
15 more interestingly, the maintenance of translations) using gettext
16 tools on areas where they were not expected like documentation.
17 The po4a-updatepo script is in charge of updating PO files to make them
19 reflect the changes made to the original documentation file. For that,
20 it converts the documentation file to a POT file, and call msgmerge(1)
21 on this new POT and on the provided PO files.
22 It is possible to give more than one PO file (if you want to update
24 several languages at once), and several documentation files (if you
25 want to store the translations of several documents in the same PO
26 file).
27 If the master document has non-ASCII characters, this script will
29 convert the PO files to UTF-8 (if they weren't already), for a
30 transparent handling of non-standard characters.
31
33 -f, --format
34 Format of the documentation you want to handle. Use the
35 --help-format option to see the list of available formats.
36 -m, --master
38 File(s) containing the master document to translate.
39 -M, --master-charset
41 Charset of the files containing the document to translate. Note
42 that all files must have the same charset.
43 -p, --po
45 PO file(s) to update. If these files do not exist, they are created
46 by po4a-updatepo.
47 -o, --option
49 Extra option(s) to pass to the format plugin. See the documentation
50 of each plugin for more information about the valid options and
51 their meanings. For example, you could pass '-o tablecells' to the
52 AsciiDoc parser, while the text parser would accept '-o
53 tabs=split'.
54 --no-previous
56 This option removes --previous from the options passed to msgmerge.
57 This helps supporting old versions of gettext (before v0.16).
58 --previous
60 This option adds --previous to the options passed to msgmerge. It
61 requires gettext 0.16 or later, and is activated by default.
62 --msgmerge-opt options
64 Extra options for msgmerge(1).
65 -h, --help
67 Show a short help message.
68 --help-format
70 List the documentation formats understood by po4a.
71 -V, --version
73 Display the version of the script and exit.
74 -v, --verbose
76 Increase the verbosity of the program.
77 -d, --debug
79 Output some debugging information.
80 --porefs type[,wrap|nowrap]
82 Specify the reference format. Argument type can be one of never to
83 not produce any reference, file to only specify the file without
84 the line number, counter to replace line number by an increasing
85 counter, and full to include complete references (default: full).
86 Argument can be followed by a comma and either wrap or nowrap
88 keyword. References are written by default on a single line. The
89 wrap option wraps references on several lines, to mimic gettext
90 tools (xgettext and msgmerge). This option will become the default
91 in a future release, because it is more sensible. The nowrap
92 option is available so that users who want to keep the old behavior
93 can do so.
94 --wrap-po no|newlines|number (default: 76)
96 Specify how the po file should be wrapped. This gives the choice
97 between either files that are nicely wrapped but could lead to git
98 conflicts, or files that are easier to handle automatically, but
99 harder to read for humans.
100 Historically, the gettext suite has reformatted the po files at the
102 77th column for cosmetics. This option specifies the behavior of
103 po4a. If set to a numerical value, po4a will wrap the po file after
104 this column and after newlines in the content. If set to newlines,
105 po4a will only split the msgid and msgstr after newlines in the
106 content. If set to no, po4a will not wrap the po file at all. The
107 wrapping of the reference comments is controlled by the --porefs
108 option.
109 Note that this option has no impact on how the msgid and msgstr are
111 wrapped, ie on how newlines are added to the content of these
112 strings.
113 --msgid-bugs-address email@address
115 Set the report address for msgid bugs. By default, the created POT
116 files have no Report-Msgid-Bugs-To fields.
117 --copyright-holder string
119 Set the copyright holder in the POT header. The default value is
120 "Free Software Foundation, Inc."
121 --package-name string
123 Set the package name for the POT header. The default is "PACKAGE".
124 --package-version string
126 Set the package version for the POT header. The default is
127 "VERSION".
128
130 po4a-gettextize(1), po4a-normalize(1), po4a-translate(1), po4a(7)
131
133 Denis Barbier <barbier@linuxfr.org>
134 Nicolas François <nicolas.francois@centraliens.net>
135 Martin Quinson (mquinson#debian.org)
136
138 Copyright 2002-2020 by SPI, inc.
139 This program is free software; you may redistribute it and/or modify it
141 under the terms of GPL (see the COPYING file).
142perl v5.38.0 2023-10-12 PO4A-UPDATEPO.1P(1)