PYGETTEXT(1)                General Commands Manual               PYGETTEXT(1)



NAME
       pygettext - Python equivalent of xgettext(1)

SYNOPSIS
       pygettext [OPTIONS] INPUTFILE ...

DESCRIPTION
       pygettext  is deprecated. The current version of xgettext supports many
       languages, including Python.

       pygettext uses Python's standard tokenize module to scan Python  source
       code,  generating  .pot  files identical to what GNU xgettext generates
       for C and C++ code.  From there, the standard GNU tools can be used.

       pygettext searches only for _() by default, even  though  GNU  xgettext
       recognizes  the  following  keywords: gettext, dgettext, dcgettext, and
       gettext_noop. See the -k/--keyword flag below for how to augment this.

OPTIONS
       -a, --extract-all
              Extract all strings.

       -d, --default-domain=NAME
              Rename the default output file from messages.pot to name.pot.

       -E, --escape
              Replace non-ASCII characters with octal escape sequences.

       -D, --docstrings
              Extract module, class, method, and function  docstrings.   These
              do  not need to be wrapped in _() markers, and in fact cannot be
              for Python  to  consider  them  docstrings.  (See  also  the  -X
              option).

       -h, --help
              Print this help message and exit.

       -k, --keyword=WORD
              Keywords  to look for in addition to the default set, which are:
              _

              You can have multiple -k flags on the command line.

       -K, --no-default-keywords
              Disable the default set of keywords (see above).   Any  keywords
              explicitly  added  with the -k/--keyword option are still recog-
              nized.

       --no-location
              Do not write filename/lineno location comments.

       -n, --add-location
              Write filename/lineno location comments  indicating  where  each
              extracted  string  is  found  in the source.  These lines appear
              before each msgid.  The style of comments is controlled  by  the
              -S/--style option.  This is the default.

       -o, --output=FILENAME
              Rename  the  default  output file from messages.pot to FILENAME.
              If FILENAME is `-' then the output is sent to standard out.

       -p, --output-dir=DIR
              Output files will be placed in directory DIR.

       -S, --style=STYLENAME
              Specify which style to use for location  comments.   Two  styles
              are supported:

              o   Solaris   # File: filename, line: line-number

              o   GNU       #: filename:line

              The style name is case insensitive.  GNU style is the default.

       -v, --verbose
              Print the names of the files being processed.

       -V, --version
              Print the version of pygettext and exit.

       -w, --width=COLUMNS
              Set width of output to columns.

       -x, --exclude-file=FILENAME
              Specify  a  file that contains a list of strings that are not be
              extracted from the input files.  Each string to be excluded must
              appear on a line by itself in the file.

       -X, --no-docstrings=FILENAME
              Specify a file that contains a list of files (one per line) that
              should not have their docstrings extracted.  This is only useful
              in conjunction with the -D option above.

       If `INPUTFILE' is -, standard input is read.

BUGS
       pygettext  attempts  to be option and feature compatible with GNU xget-
       text where ever possible.  However some options are  still  missing  or
       are  not  fully  implemented.   Also,  xgettext's  use  of command line
       switches with option arguments is broken, and in these cases, pygettext
       just defines additional switches.

AUTHOR
       pygettext is written by Barry Warsaw <barry@zope.com>.

       Joonas   Paalasmaa   <joonas.paalasmaa@iki.fi>  put  this  manual  page
       together based on "pygettext --help".



pygettext 1.4                                                     PYGETTEXT(1)
