NAME
xgettext - conditionally extract strings from C programs
SYNOPSIS
xgettext -d [ cmnopvhP ] [ -odirectory-prefix ] [ -xexclude-list ] [
filename ... ]
xgettext [ -amopvhP ] [ -xexclude-list ] [ filename ... ]
DESCRIPTION
xgettext is used to automate the creation of portable message files. A
portable message file contains copies of "C" strings that are found in
"C" source code in filename. When the -d option is specified, xgettext
places the extracted strings in the file name.po. name is either the
domain specified in a dgettext call, or messages.po for strings
extracted from gettext and textdomain calls. If the -d flag is not
specified, xgettext places all the strings in messages.po. The
portable message file can be used as input to the msgfmt(1) utility,
which will produce a binary form of the message file than can be used
at application run-time.
OPTIONS
-a Extract ALL strings, not just those found in gettext,
dgettext, and textdomain calls.
-cflag Comments beginning with flag filename on the first line of
the comment are added to file filename as # delimited
comments.
-d Produce duplicates. Does not sort output when writing the
portable message file and will not overwrite existing output
files. Places output from each domain specified in a
dgettext call into a separate file named for the domain, ie.
name.po
-cflag Comments beginning with flag filename on the first line of
the comment are added to file filename as # delimited
comments.
-mstring Causes xgettext to fill in the msgstr line of the portable
message files it produces. xgettext uses the corresponding
msgid string extracted from the "C" file, appending string.
Useful for debugging purposes.
-n Add # delimited line number comments to output file
indicating the line number in the source file where each
extracted string is encountered.
-ofilename
rename the default output file from messages.po to filename.
-ppathname
Specify the directory where the output files will be placed.
This option overrides the current working directory.
-xfilename
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
filename.
-P include strings in pre-processor statements.
-v Verbose mode.
-h Print a help message on standard output.
FILES
messages.po is always created, but may be empty.
SEE ALSO
msgfmt(1), xstr(1), gettext, dgettext, textdomain(3).
14 Sep 1990 xgettext(1)