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