cmlenz@2: .. -*- mode: rst; encoding: utf-8 -*-
cmlenz@2: 
cmlenz@2: ======================
cmlenz@2: Command-Line Interface
cmlenz@2: ======================
cmlenz@2: 
cmlenz@2: Babel includes a command-line interface for working with message catalogs,
cmlenz@2: similar to the GNU ``xgettext`` program commonly available on Linux/Unix
cmlenz@2: systems.
cmlenz@2: 
cmlenz@2: 
cmlenz@2: .. contents:: Contents
cmlenz@2:    :depth: 2
cmlenz@2: .. sectnum::
cmlenz@2: 
cmlenz@2: 
cmlenz@2: pygettext
cmlenz@2: =========
cmlenz@2: 
cmlenz@2: When properly installed, Babel provides a script called ``pygettext``, which can
cmlenz@2: be used to extract localized messages from a variety of files::
cmlenz@2: 
cmlenz@2:     $ pygettext --help
cmlenz@2:     usage: pygettext [options] dirname1 <dirname2> ...
cmlenz@2: 
cmlenz@2:     options:
cmlenz@2:       --version             show program's version number and exit
cmlenz@2:       -h, --help            show this help message and exit
cmlenz@2:       --charset=CHARSET     charset to use in the output
cmlenz@2:       -k KEYWORDS, --keyword=KEYWORDS
cmlenz@2:                             keywords to look for in addition to the defaults. You
cmlenz@2:                             can specify multiple -k flags on the command line.
cmlenz@2:       --no-location         do not include location comments with filename and
cmlenz@2:                             line number
cmlenz@2:       --omit-header         do not include msgid "" entry in header
cmlenz@2:       -o OUTPUT, --output=OUTPUT
cmlenz@2:                             path to the output POT file