babel/old/babel-test: doc/cmdline.txt annotate

annotate doc/cmdline.txt @ 556:454fe7a76877 tip

update tags

author	convert-repo
date	Mon, 30 May 2011 21:01:55 +0000
parents	3aa01d0355f7
children

rev	line source
2 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	1 .. -- mode: rst; encoding: utf-8 --
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	2
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	3 ======================
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	4 Command-Line Interface
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	5 ======================
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	6
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	7 Babel includes a command-line interface for working with message catalogs,
52 1e724c305460 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 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	9 systems.
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	10
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	11
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	12 .. contents:: Contents
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	13 :depth: 2
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	14 .. sectnum::
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	15
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	16
189 e9136716b615 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 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	18
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	19 $ pybabel --help
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	20 usage: pybabel command [options] [args]
2 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	21
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	22 options:
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	23 --version show program's version number and exit
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	24 -h, --help show this help message and exit
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	25 --list-locales print all known locales and exit
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	26 -v, --verbose print as much as possible
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	27 -q, --quiet print as little as possible
52 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	28
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	29 commands:
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	30 compile compile message catalogs to MO files
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	31 extract extract messages from source files and generate a POT file
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	32 init create new message catalogs from a POT file
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	33 update update existing message catalogs from a POT file
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	34
189 e9136716b615 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
e9136716b615 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 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	37
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	38
177 a7766f92f944 * 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
a7766f92f944 * 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 =======
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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::
a7766f92f944 * 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 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	45 $ pybabel compile --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	46 usage: pybabel compile [options]
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	47
177 a7766f92f944 * 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	49
177 a7766f92f944 * 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:
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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')
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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')
a7766f92f944 * 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	64 --statistics print statistics about translations
177 a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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::
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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
a7766f92f944 * 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,
a7766f92f944 * 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.
a7766f92f944 * 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
a7766f92f944 * 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 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	76 extract
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	77 =======
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	78
1e724c305460 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
1e724c305460 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::
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	81
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	82 $ pybabel extract --help
e9136716b615 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	84
77 5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	85 extract messages from source files and generate a POT file
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	86
52 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	87 options:
1e724c305460 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	89 --charset=CHARSET charset to use in the output (default "utf-8")
2 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	90 -k KEYWORDS, --keyword=KEYWORDS
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	91 keywords to look for in addition to the defaults. You
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	92 can specify multiple -k flags on the command line.
52 1e724c305460 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
1e724c305460 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
1e724c305460 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
1e724c305460 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 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	97 --no-location do not include location comments with filename and
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	98 line number
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	99 --omit-header do not include msgid "" entry in header
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	100 -o OUTPUT, --output=OUTPUT
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	101 path to the output POT file
52 1e724c305460 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
1e724c305460 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)
1e724c305460 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
1e724c305460 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 5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	106 --sort-output generate sorted output (default False)
5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	107 --sort-by-file sort output by file location (default False)
78 ee043bb666f0 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
ee043bb666f0 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 9a05230571f8 Implemented item 4 from #12. Set the copyright holder in the output. palgarvio parents: 78 diff changeset	110 --copyright-holder=COPYRIGHT_HOLDER
9a05230571f8 Implemented item 4 from #12. Set the copyright holder in the output. palgarvio parents: 78 diff changeset	111 set copyright holder in output
80 9c84b9fa5d30 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
9c84b9fa5d30 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
9c84b9fa5d30 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
9c84b9fa5d30 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 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	116
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	117
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	118 init
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	119 ====
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	120
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	121 The `init` sub-command creates a new translations catalog based on a PO
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	122 template file::
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	123
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	124 $ pybabel init --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	125 usage: pybabel init [options]
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	126
181 9a1acb41e7dd 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	128
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	129 options:
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	130 -h, --help show this help message and exit
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	131 -D DOMAIN, --domain=DOMAIN
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	132 domain of PO file (default 'messages')
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	133 -i FILE, --input-file=FILE
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	134 name of the input file
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	135 -d DIR, --output-dir=DIR
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	136 path to output directory
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	137 -o FILE, --output-file=FILE
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	138 name of the output file (default
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	139 '<output_dir>/<locale>/LC_MESSAGES/<domain>.po')
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	140 -l LOCALE, --locale=LOCALE
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	141 locale for the new localized catalog
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	142
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	143
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	144 update
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	145 ======
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	146
9a1acb41e7dd 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
9a1acb41e7dd 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::
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	149
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	150 $ pybabel update --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	151 usage: pybabel update [options]
319 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	152
181 9a1acb41e7dd 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	154
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	155 options:
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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')
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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
9a1acb41e7dd 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')
9a1acb41e7dd 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
9a1acb41e7dd 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 cf09490f22b3 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
cf09490f22b3 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 3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	170 -N, --no-fuzzy-matching
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	171 do not use fuzzy matching (default False)
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	172 --previous keep previous msgids of translated messages (default
3aa01d0355f7 Documentation fixes/updates, closes #70. cmlenz parents: 191 diff changeset	173 False)
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	174
9a1acb41e7dd 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
9a1acb41e7dd 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::
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	177
9a1acb41e7dd 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
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	179
9a1acb41e7dd 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
9a1acb41e7dd 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,
9a1acb41e7dd 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 > old > babel-test

annotate doc/cmdline.txt @ 556:454fe7a76877 tip