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

annotate doc/cmdline.txt @ 191:cf09490f22b3

Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.

author	cmlenz
date	Sun, 01 Jul 2007 17:59:44 +0000
parents	e9136716b615
children	3aa01d0355f7

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
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	173 --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	174 (default False)
181 9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	175
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	176 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	177 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	178
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	179 <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	180
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22. cmlenz parents: 177 diff changeset	181 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	182 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	183 and updates each of them.

Mercurial > babel > old > babel-test

annotate doc/cmdline.txt @ 191:cf09490f22b3