Mercurial > babel > old > mirror
annotate doc/cmdline.txt @ 285:e9550fb98127
Fix `__repr__` of `Translations` class. Closes #63.
author | cmlenz |
---|---|
date | Wed, 05 Sep 2007 17:13:22 +0000 |
parents | b5e58a22ebd2 |
children | ac79e52d2689 |
rev | line source |
---|---|
4 | 1 .. -*- mode: rst; encoding: utf-8 -*- |
2 | |
3 ====================== | |
4 Command-Line Interface | |
5 ====================== | |
6 | |
7 Babel includes a command-line interface for working with message catalogs, | |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
8 similar to the various GNU ``gettext`` tools commonly available on Linux/Unix |
4 | 9 systems. |
10 | |
11 | |
12 .. contents:: Contents | |
13 :depth: 2 | |
14 .. sectnum:: | |
15 | |
16 | |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
17 When properly installed, Babel provides a script called ``pybabel``:: |
4 | 18 |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
19 $ pybabel --help |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
20 usage: pybabel subcommand [options] [args] |
4 | 21 |
22 options: | |
179
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
23 --version show program's version number and exit |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
24 -h, --help show this help message and exit |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
25 |
75 | 26 subcommands: |
179
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
27 compile compile message catalogs to MO files |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
28 extract extract messages from source files and generate a POT file |
183
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
29 init create new message catalogs from a POT file |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
30 update update existing message catalogs from a POT file |
75 | 31 |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
32 The ``pybabel`` script provides a number of sub-commands that do the actual |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
33 work. Those sub-commands are described below. |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
34 |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
35 |
179
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
36 compile |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
37 ======= |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
38 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
39 The ``compile`` sub-command can be used to compile translation catalogs into |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
40 binary MO files:: |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
41 |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
42 $ pybabel compile --help |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
43 usage: pybabel compile [options] |
179
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
44 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
45 compile message catalogs to MO files |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
46 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
47 options: |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
48 -h, --help show this help message and exit |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
49 -D DOMAIN, --domain=DOMAIN |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
50 domain of MO and PO files (default 'messages') |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
51 -d DIR, --directory=DIR |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
52 base directory of catalog files |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
53 -l LOCALE, --locale=LOCALE |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
54 locale of the catalog |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
55 -i FILE, --input-file=FILE |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
56 name of the input file |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
57 -o FILE, --output-file=FILE |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
58 name of the output file (default |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
59 '<output_dir>/<locale>/LC_MESSAGES/<domain>.mo') |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
60 -f, --use-fuzzy also include fuzzy translations (default False) |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
61 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
62 If ``directory`` is specified, but ``output-file`` is not, the default filename |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
63 of the output file will be:: |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
64 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
65 <directory>/<locale>/LC_MESSAGES/<domain>.mo |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
66 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
67 If neither the ``input_file`` nor the ``locale`` option is set, this command |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
68 looks for all catalog files in the base directory that match the given domain, |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
69 and compiles each of them to MO files in the same directory. |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
70 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
71 |
6138ea7ef7a8
* Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents:
82
diff
changeset
|
72 |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
73 extract |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
74 ======= |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
75 |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
76 The ``extract`` sub-command can be used to extract localizable messages from |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
77 a collection of source files:: |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
78 |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
79 $ pybabel extract --help |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
80 usage: pybabel extract [options] dir1 <dir2> ... |
79 | 81 |
82 extract messages from source files and generate a POT file | |
83 | |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
84 options: |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
85 -h, --help show this help message and exit |
4 | 86 --charset=CHARSET charset to use in the output |
87 -k KEYWORDS, --keyword=KEYWORDS | |
88 keywords to look for in addition to the defaults. You | |
89 can specify multiple -k flags on the command line. | |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
90 --no-default-keywords |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
91 do not include the default keywords |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
92 -F MAPPING_FILE, --mapping=MAPPING_FILE |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
93 path to the extraction mapping file |
4 | 94 --no-location do not include location comments with filename and |
95 line number | |
96 --omit-header do not include msgid "" entry in header | |
97 -o OUTPUT, --output=OUTPUT | |
98 path to the output POT file | |
54
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
99 -w WIDTH, --width=WIDTH |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
100 set output line width (default 76) |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
101 --no-wrap do not break long message lines, longer than the |
cc3c6cfe909d
Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9.
cmlenz
parents:
4
diff
changeset
|
102 output line width, into several lines |
79 | 103 --sort-output generate sorted output (default False) |
104 --sort-by-file sort output by file location (default False) | |
80
8e2e9d549693
Fixed the plurals header on `Catalog` which should only be written if it's not a catalog template.
palgarvio
parents:
79
diff
changeset
|
105 --msgid-bugs-address=EMAIL@ADDRESS |
8e2e9d549693
Fixed the plurals header on `Catalog` which should only be written if it's not a catalog template.
palgarvio
parents:
79
diff
changeset
|
106 set report address for msgid |
81
51f73a110a84
Implemented item 4 from #12. Set the copyright holder in the output.
palgarvio
parents:
80
diff
changeset
|
107 --copyright-holder=COPYRIGHT_HOLDER |
51f73a110a84
Implemented item 4 from #12. Set the copyright holder in the output.
palgarvio
parents:
80
diff
changeset
|
108 set copyright holder in output |
82
f421e5576d26
Added support for translator comments at the API and frontends levels.(See #12, item 1). Updated docs and tests accordingly.
palgarvio
parents:
81
diff
changeset
|
109 -c TAG, --add-comments=TAG |
f421e5576d26
Added support for translator comments at the API and frontends levels.(See #12, item 1). Updated docs and tests accordingly.
palgarvio
parents:
81
diff
changeset
|
110 place comment block with TAG (or those preceding |
f421e5576d26
Added support for translator comments at the API and frontends levels.(See #12, item 1). Updated docs and tests accordingly.
palgarvio
parents:
81
diff
changeset
|
111 keyword lines) in output file. One TAG per argument |
f421e5576d26
Added support for translator comments at the API and frontends levels.(See #12, item 1). Updated docs and tests accordingly.
palgarvio
parents:
81
diff
changeset
|
112 call |
75 | 113 |
114 | |
115 init | |
116 ==== | |
117 | |
118 The `init` sub-command creates a new translations catalog based on a PO | |
119 template file:: | |
120 | |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
121 $ pybabel init --help |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
122 usage: pybabel init [options] |
75 | 123 |
183
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
124 create new message catalogs from a POT file |
75 | 125 |
126 options: | |
127 -h, --help show this help message and exit | |
128 -D DOMAIN, --domain=DOMAIN | |
129 domain of PO file (defaults to lower-cased project | |
130 name) | |
131 -i INPUT_FILE, --input-file=INPUT_FILE | |
132 name of the input file | |
133 -d OUTPUT_DIR, --output-dir=OUTPUT_DIR | |
134 path to output directory | |
135 -o OUTPUT_FILE, --output-file=OUTPUT_FILE | |
136 name of the output file (default | |
137 '<output_dir>/<locale>/<domain>.po') | |
138 -l LOCALE, --locale=LOCALE | |
139 locale for the new localized catalog | |
140 --first-author=FIRST_AUTHOR_NAME | |
141 name of first author | |
142 --first-author-email=FIRST_AUTHOR_EMAIL | |
143 email of first author | |
144 --project-name=NAME the project name | |
145 --project-version=VERSION | |
146 the project version | |
183
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
147 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
148 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
149 update |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
150 ====== |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
151 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
152 The `update` sub-command updates an existing new translations catalog based on |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
153 a PO template file:: |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
154 |
191
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
155 $ pybabel update --help |
a16401b8b989
Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.
cmlenz
parents:
183
diff
changeset
|
156 usage: pybabel update [options] |
183
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
157 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
158 update existing message catalogs from a POT file |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
159 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
160 options: |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
161 -h, --help show this help message and exit |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
162 -D DOMAIN, --domain=DOMAIN |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
163 domain of PO file (default 'messages') |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
164 -i FILE, --input-file=FILE |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
165 name of the input file |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
166 -d DIR, --output-dir=DIR |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
167 path to output directory |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
168 -o FILE, --output-file=FILE |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
169 name of the output file (default |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
170 '<output_dir>/<locale>/LC_MESSAGES/<domain>.po') |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
171 -l LOCALE, --locale=LOCALE |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
172 locale of the translations catalog |
193
b5e58a22ebd2
Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.
cmlenz
parents:
191
diff
changeset
|
173 --ignore-obsolete do not include obsolete messages in the output |
b5e58a22ebd2
Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.
cmlenz
parents:
191
diff
changeset
|
174 (default False) |
183
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
175 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
176 If ``output_dir`` is specified, but ``output-file`` is not, the default |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
177 filename of the output file will be:: |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
178 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
179 <directory>/<locale>/LC_MESSAGES/<domain>.mo |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
180 |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
181 If neither the ``output_file`` nor the ``locale`` option is set, this command |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
182 looks for all catalog files in the base directory that match the given domain, |
e927dffc9ab4
The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents:
179
diff
changeset
|
183 and updates each of them. |