PYGETTEXT(1)							  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 Pythons 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:

		 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  xget
       text  where  ever  possible.  However some options are still missing or
       are not fully  implemented.   Also,  xgettexts  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 .

       Joonas  Paalasmaa    put  this	 manual   page
       together based on "pygettext --help".



pygettext 1.4							  PYGETTEXT(1)