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

annotate doc/cmdline.txt @ 189:e9136716b615

Rename command-line script to avoid conflict with the OpenBabel project. Closes #34.

author	cmlenz
date	Fri, 29 Jun 2007 14:50:20 +0000
parents	9a1acb41e7dd
children	cf09490f22b3

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
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	19 $ pybabel --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	20 usage: pybabel subcommand [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:
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	23 --version show program's version number 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	24 -h, --help show this help message and exit
52 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	25
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	26 subcommands:
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	27 compile compile message catalogs to 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	28 extract extract messages from source files and generate a POT file
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	29 init create new message catalogs from a POT file
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	30 update update existing message catalogs from a POT file
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	31
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	32 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	33 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	34
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	35
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	36 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	37 =======
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	38
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 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	40 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	41
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	42 $ pybabel compile --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	43 usage: pybabel compile [options]
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	44
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	45 compile message catalogs to 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	46
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	47 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	48 -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	49 -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	50 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	51 -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	52 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	53 -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	54 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	55 -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	56 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	57 -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	58 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	59 '<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	60 -f, --use-fuzzy also include fuzzy translations (default False)
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
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 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	63 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	64
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 <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	66
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 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	68 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	69 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	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
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
52 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	73 extract
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	74 =======
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	75
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	76 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	77 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	78
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	79 $ pybabel extract --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	80 usage: pybabel extract [options] dir1 <dir2> ...
77 5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	81
5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	82 extract messages from source files and generate a POT file
5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	83
52 1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	84 options:
1e724c305460 Support sub-commands in command-line interface, and renamed the generated script wrapper to `babel`. See #9. cmlenz parents: 2 diff changeset	85 -h, --help show this help message and exit
2 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	86 --charset=CHARSET charset to use in the output
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	87 -k KEYWORDS, --keyword=KEYWORDS
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	88 keywords to look for in addition to the defaults. You
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	89 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	90 --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	91 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	92 -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	93 path to the extraction mapping file
2 b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	94 --no-location do not include location comments with filename and
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	95 line number
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	96 --omit-header do not include msgid "" entry in header
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	97 -o OUTPUT, --output=OUTPUT
b2492365f186 Forgot to check in the doc directory. cmlenz parents: diff changeset	98 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	99 -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	100 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	101 --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	102 output line width, into several lines
77 5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	103 --sort-output generate sorted output (default False)
5c819411e4af Updated frontend screens for added sorting features. cmlenz parents: 73 diff changeset	104 --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	105 --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	106 set report address for msgid
79 9a05230571f8 Implemented item 4 from #12. Set the copyright holder in the output. palgarvio parents: 78 diff changeset	107 --copyright-holder=COPYRIGHT_HOLDER
9a05230571f8 Implemented item 4 from #12. Set the copyright holder in the output. palgarvio parents: 78 diff changeset	108 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	109 -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	110 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	111 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	112 call
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	113
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	114
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	115 init
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 The `init` sub-command creates a new translations catalog based on a PO
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	119 template file::
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	120
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	121 $ pybabel init --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	122 usage: pybabel init [options]
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	123
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	124 create new message catalogs from a POT file
73 dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	125
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	126 options:
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	127 -h, --help show this help message and exit
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	128 -D DOMAIN, --domain=DOMAIN
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	129 domain of PO file (defaults to lower-cased project
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	130 name)
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	131 -i INPUT_FILE, --input-file=INPUT_FILE
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	132 name of the input file
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	133 -d OUTPUT_DIR, --output-dir=OUTPUT_DIR
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	134 path to output directory
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	135 -o OUTPUT_FILE, --output-file=OUTPUT_FILE
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	136 name of the output file (default
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	137 '<output_dir>/<locale>/<domain>.po')
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	138 -l LOCALE, --locale=LOCALE
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	139 locale for the new localized catalog
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	140 --first-author=FIRST_AUTHOR_NAME
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	141 name of first author
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	142 --first-author-email=FIRST_AUTHOR_EMAIL
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	143 email of first author
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	144 --project-name=NAME the project name
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	145 --project-version=VERSION
dd5c3ba59eae Extended the docs a bit. cmlenz parents: 52 diff changeset	146 the project version
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	147
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	148
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	149 update
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	150 ======
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	151
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	152 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	153 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	154
189 e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	155 $ pybabel update --help
e9136716b615 Rename command-line script to avoid conflict with the OpenBabel project. Closes #34. cmlenz parents: 181 diff changeset	156 usage: pybabel update [options]
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	157
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	158 update existing message catalogs from a POT file
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	159
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	160 options:
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	161 -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	162 -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	163 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	164 -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	165 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	166 -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	167 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	168 -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	169 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	170 '<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	171 -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	172 locale of the translations catalog
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	173
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	174 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	175 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	176
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	177 <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	178
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	179 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	180 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	181 and updates each of them.

Mercurial > babel > old > babel-test

annotate doc/cmdline.txt @ 189:e9136716b615