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 recognized.

       --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:

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

              •   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  xgettext  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".