babel/mirror: doc/cmdline.txt annotate

annotate doc/cmdline.txt @ 600:e61e27d9347d trunk

"init" command support "--width" option (#284)

author	fschwarz
date	Mon, 20 Aug 2012 20:07:27 +0000
parents	b1201cfc4190
children

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

Mercurial > babel > mirror

annotate doc/cmdline.txt @ 600:e61e27d9347d trunk