| xgettext - extract gettext strings from source | 
| xgettext [OPTION] [INPUTFILE]... | 
| Extract translatable strings from given input files. | 
| Mandatory arguments to long options are mandatory for short options too. Similarly for optional arguments. | 
| Input file location: | 
| INPUTFILE ... | 
| input files | 
| -f, --files-from=FILE | 
| get list of input files from FILE | 
| -D, --directory=DIRECTORY | 
| add DIRECTORY to list for input files search | 
| If input file is -, standard input is read. | 
| Output file location: | 
| -d, --default-domain=NAME | 
| use NAME.po for output (instead of messages.po) | 
| -o, --output=FILE | 
| write output to specified file | 
| -p, --output-dir=DIR | 
| output files will be placed in directory DIR | 
| If output file is -, output is written to standard output. | 
| Choice of input file language: | 
| -L, --language=NAME | 
| recognise the specified language (C, C++, ObjectiveC, PO, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Smalltalk, Java, JavaProperties, C#, awk, YCP, Tcl, Perl, PHP, GCC-source, NXStringTable, RST, Glade) | 
| -C, --c++ | 
| shorthand for --language=C++ | 
| By default the language is guessed depending on the input file name extension. | 
| Input file interpretation: | 
| --from-code=NAME | 
| encoding of input files (except for Python, Tcl, Glade) | 
| By default the input files are assumed to be in ASCII. | 
| Operation mode: | 
| -j, --join-existing | 
| join messages with existing file | 
| -x, --exclude-file=FILE.po | 
| entries from FILE.po are not extracted | 
| -c, --add-comments[=TAG] | 
| place comment block with TAG (or those preceding keyword lines) in output file | 
| Language specific options: | 
| -a, --extract-all | 
| extract all strings (only languages C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade) | 
| -k, --keyword[=WORD] | 
| additional keyword to be looked for (without WORD means not to use default keywords) | 
| (only languages C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade) | 
| --flag=WORD:ARG:FLAG | 
| additional flag for strings inside the argument number ARG of keyword WORD | 
| (only languages C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#, awk, YCP, Tcl, Perl, PHP, GCC-source) | 
| -T, --trigraphs | 
| understand ANSI C trigraphs for input (only languages C, C++, ObjectiveC) | 
| --qt | 
| recognize Qt format strings (only language C++) | 
| --debug | 
| more detailed formatstring recognition result | 
| Output details: | 
| -e, --no-escape | 
| do not use C escapes in output (default) | 
| -E, --escape | 
| use C escapes in output, no extended chars | 
| --force-po | 
| write PO file even if empty | 
| -i, --indent | 
| write the .po file using indented style | 
| --no-location | 
| do not write '#: filename:line' lines | 
| -n, --add-location | 
| generate '#: filename:line' lines (default) | 
| --strict | 
| write out strict Uniforum conforming .po file | 
| --properties-output | 
| write out a Java .properties file | 
| --stringtable-output | 
| write out a NeXTstep/GNUstep .strings file | 
| -w, --width=NUMBER | 
| set output page width | 
| --no-wrap | 
| do not break long message lines, longer than the output page width, into several lines | 
| -s, --sort-output | 
| generate sorted output | 
| -F, --sort-by-file | 
| sort output by file location | 
| --omit-header | 
| don't write header with `msgid ""' entry | 
| --copyright-holder=STRING | 
| set copyright holder in output | 
| --foreign-user | 
| omit FSF copyright in output for foreign user | 
| --msgid-bugs-address=EMAIL@ADDRESS | 
| set report address for msgid bugs | 
| -m, --msgstr-prefix[=STRING] | 
| use STRING or "" as prefix for msgstr entries | 
| -M, --msgstr-suffix[=STRING] | 
| use STRING or "" as suffix for msgstr entries | 
| Informative output: | 
| -h, --help | 
| display this help and exit | 
| -V, --version | 
| output version information and exit | 
| Written by Ulrich Drepper. | 
| Report bugs to <bug-gnu-gettext@gnu.org>. | 
| Copyright 1995-1998, 2000-2005 Free Software Foundation,
Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | 
| The full documentation for xgettext is maintained as a Texinfo manual. If the info and xgettext programs are properly installed at your site, the command | 
| info xgettext | 
| should give you access to the complete manual. |