diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /upstream/opensuse-tumbleweed/man1/xgettext.1 | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/xgettext.1')
-rw-r--r-- | upstream/opensuse-tumbleweed/man1/xgettext.1 | 249 |
1 files changed, 249 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/xgettext.1 b/upstream/opensuse-tumbleweed/man1/xgettext.1 new file mode 100644 index 00000000..88a3c0e2 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/xgettext.1 @@ -0,0 +1,249 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. +.TH XGETTEXT "1" "October 2022" "GNU gettext-tools 0.21.1" "User Commands" +.SH NAME +xgettext \- extract gettext strings from source +.SH SYNOPSIS +.B xgettext +[\fI\,OPTION\/\fR] [\fI\,INPUTFILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Extract translatable strings from given input files. +.PP +Mandatory arguments to long options are mandatory for short options too. +Similarly for optional arguments. +.SS "Input file location:" +.TP +INPUTFILE ... +input files +.TP +\fB\-f\fR, \fB\-\-files\-from\fR=\fI\,FILE\/\fR +get list of input files from FILE +.TP +\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR +add DIRECTORY to list for input files search +.PP +If input file is \-, standard input is read. +.SS "Output file location:" +.TP +\fB\-d\fR, \fB\-\-default\-domain\fR=\fI\,NAME\/\fR +use NAME.po for output (instead of messages.po) +.TP +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR +write output to specified file +.TP +\fB\-p\fR, \fB\-\-output\-dir\fR=\fI\,DIR\/\fR +output files will be placed in directory DIR +.PP +If output file is \-, output is written to standard output. +.SS "Choice of input file language:" +.TP +\fB\-L\fR, \fB\-\-language\fR=\fI\,NAME\/\fR +recognise the specified language +(C, C++, ObjectiveC, PO, Shell, Python, Lisp, +EmacsLisp, librep, Scheme, Smalltalk, Java, +JavaProperties, C#, awk, YCP, Tcl, Perl, PHP, +Ruby, GCC\-source, NXStringTable, RST, RSJ, +Glade, Lua, JavaScript, Vala, Desktop) +.TP +\fB\-C\fR, \fB\-\-c\fR++ +shorthand for \fB\-\-language\fR=\fI\,C\/\fR++ +.PP +By default the language is guessed depending on the input file name extension. +.SS "Input file interpretation:" +.TP +\fB\-\-from\-code\fR=\fI\,NAME\/\fR +encoding of input files +(except for Python, Tcl, Glade) +.PP +By default the input files are assumed to be in ASCII. +.SS "Operation mode:" +.TP +\fB\-j\fR, \fB\-\-join\-existing\fR +join messages with existing file +.TP +\fB\-x\fR, \fB\-\-exclude\-file\fR=\fI\,FILE\/\fR.po +entries from FILE.po are not extracted +.TP +\fB\-cTAG\fR, \fB\-\-add\-comments\fR=\fI\,TAG\/\fR +place comment blocks starting with TAG and +preceding keyword lines in output file +.TP +\fB\-c\fR, \fB\-\-add\-comments\fR +place all comment blocks preceding keyword lines +in output file +.TP +\fB\-\-check\fR=\fI\,NAME\/\fR +perform syntax check on messages +(ellipsis\-unicode, space\-ellipsis, +.IP +quote\-unicode, bullet\-unicode) +.TP +\fB\-\-sentence\-end\fR=\fI\,TYPE\/\fR +type describing the end of sentence +(single\-space, which is the default, +.IP +or double\-space) +.SS "Language specific options:" +.TP +\fB\-a\fR, \fB\-\-extract\-all\fR +extract all strings +(only languages C, C++, ObjectiveC, Shell, +Python, Lisp, EmacsLisp, librep, Scheme, Java, +C#, awk, Tcl, Perl, PHP, GCC\-source, Glade, +Lua, JavaScript, Vala) +.TP +\fB\-kWORD\fR, \fB\-\-keyword\fR=\fI\,WORD\/\fR +look for WORD as an additional keyword +.TP +\fB\-k\fR, \fB\-\-keyword\fR +do 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, +Lua, JavaScript, Vala, Desktop) +.TP +\fB\-\-flag\fR=\fI\,WORD\/\fR:ARG:FLAG +additional flag for strings inside the argument +number ARG of keyword WORD +.TP +(only languages C, C++, ObjectiveC, Shell, +Python, Lisp, EmacsLisp, librep, Scheme, Java, +C#, awk, YCP, Tcl, Perl, PHP, GCC\-source, +Lua, JavaScript, Vala) +.TP +\fB\-T\fR, \fB\-\-trigraphs\fR +understand ANSI C trigraphs for input +(only languages C, C++, ObjectiveC) +.TP +\fB\-\-its\fR=\fI\,FILE\/\fR +apply ITS rules from FILE +(only XML based languages) +.TP +\fB\-\-qt\fR +recognize Qt format strings +(only language C++) +.TP +\fB\-\-kde\fR +recognize KDE 4 format strings +(only language C++) +.TP +\fB\-\-boost\fR +recognize Boost format strings +(only language C++) +.TP +\fB\-\-debug\fR +more detailed formatstring recognition result +.SS "Output details:" +.TP +\fB\-\-color\fR +use colors and other text attributes always +.TP +\fB\-\-color\fR=\fI\,WHEN\/\fR +use colors and other text attributes if WHEN. +WHEN may be 'always', 'never', 'auto', or 'html'. +.TP +\fB\-\-style\fR=\fI\,STYLEFILE\/\fR +specify CSS style rule file for \fB\-\-color\fR +.TP +\fB\-e\fR, \fB\-\-no\-escape\fR +do not use C escapes in output (default) +.TP +\fB\-E\fR, \fB\-\-escape\fR +use C escapes in output, no extended chars +.TP +\fB\-\-force\-po\fR +write PO file even if empty +.TP +\fB\-i\fR, \fB\-\-indent\fR +write the .po file using indented style +.TP +\fB\-\-no\-location\fR +do not write '#: filename:line' lines +.TP +\fB\-n\fR, \fB\-\-add\-location\fR +generate '#: filename:line' lines (default) +.TP +\fB\-\-strict\fR +write out strict Uniforum conforming .po file +.TP +\fB\-\-properties\-output\fR +write out a Java .properties file +.TP +\fB\-\-stringtable\-output\fR +write out a NeXTstep/GNUstep .strings file +.TP +\fB\-\-itstool\fR +write out itstool comments +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR +set output page width +.TP +\fB\-\-no\-wrap\fR +do not break long message lines, longer than +the output page width, into several lines +.TP +\fB\-s\fR, \fB\-\-sort\-output\fR +generate sorted output +.TP +\fB\-F\fR, \fB\-\-sort\-by\-file\fR +sort output by file location +.TP +\fB\-\-omit\-header\fR +don't write header with 'msgid ""' entry +.TP +\fB\-\-copyright\-holder\fR=\fI\,STRING\/\fR +set copyright holder in output +.TP +\fB\-\-foreign\-user\fR +omit FSF copyright in output for foreign user +.TP +\fB\-\-package\-name\fR=\fI\,PACKAGE\/\fR +set package name in output +.TP +\fB\-\-package\-version\fR=\fI\,VERSION\/\fR +set package version in output +.TP +\fB\-\-msgid\-bugs\-address\fR=\fI\,EMAIL\/\fR@ADDRESS +set report address for msgid bugs +.TP +\fB\-m[STRING]\fR, \fB\-\-msgstr\-prefix\fR[=\fI\,STRING\/\fR] +use STRING or "" as prefix for msgstr +values +.TP +\fB\-M[STRING]\fR, \fB\-\-msgstr\-suffix\fR[=\fI\,STRING\/\fR] +use STRING or "" as suffix for msgstr +values +.SS "Informative output:" +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-V\fR, \fB\-\-version\fR +output version information and exit +.TP +\fB\-v\fR, \fB\-\-verbose\fR +increase verbosity level +.SH AUTHOR +Written by Ulrich Drepper. +.SH "REPORTING BUGS" +Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext> +or by email to <bug\-gettext@gnu.org>. +.SH COPYRIGHT +Copyright \(co 1995\-2022 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +The full documentation for +.B xgettext +is maintained as a Texinfo manual. If the +.B info +and +.B xgettext +programs are properly installed at your site, the command +.IP +.B info xgettext +.PP +should give you access to the complete manual. |