jpayne@68
|
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
|
jpayne@68
|
2 .TH MSGCAT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands"
|
jpayne@68
|
3 .SH NAME
|
jpayne@68
|
4 msgcat \- combines several message catalogs
|
jpayne@68
|
5 .SH SYNOPSIS
|
jpayne@68
|
6 .B msgcat
|
jpayne@68
|
7 [\fI\,OPTION\/\fR] [\fI\,INPUTFILE\/\fR]...
|
jpayne@68
|
8 .SH DESCRIPTION
|
jpayne@68
|
9 .\" Add any additional description here
|
jpayne@68
|
10 .PP
|
jpayne@68
|
11 Concatenates and merges the specified PO files.
|
jpayne@68
|
12 Find messages which are common to two or more of the specified PO files.
|
jpayne@68
|
13 By using the \fB\-\-more\-than\fR option, greater commonality may be requested
|
jpayne@68
|
14 before messages are printed. Conversely, the \fB\-\-less\-than\fR option may be
|
jpayne@68
|
15 used to specify less commonality before messages are printed (i.e.
|
jpayne@68
|
16 \fB\-\-less\-than\fR=\fI\,2\/\fR will only print the unique messages). Translations,
|
jpayne@68
|
17 comments, extracted comments, and file positions will be cumulated, except
|
jpayne@68
|
18 that if \fB\-\-use\-first\fR is specified, they will be taken from the first PO file
|
jpayne@68
|
19 to define them.
|
jpayne@68
|
20 .PP
|
jpayne@68
|
21 Mandatory arguments to long options are mandatory for short options too.
|
jpayne@68
|
22 .SS "Input file location:"
|
jpayne@68
|
23 .TP
|
jpayne@68
|
24 INPUTFILE ...
|
jpayne@68
|
25 input files
|
jpayne@68
|
26 .TP
|
jpayne@68
|
27 \fB\-f\fR, \fB\-\-files\-from\fR=\fI\,FILE\/\fR
|
jpayne@68
|
28 get list of input files from FILE
|
jpayne@68
|
29 .TP
|
jpayne@68
|
30 \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
|
jpayne@68
|
31 add DIRECTORY to list for input files search
|
jpayne@68
|
32 .PP
|
jpayne@68
|
33 If input file is \-, standard input is read.
|
jpayne@68
|
34 .SS "Output file location:"
|
jpayne@68
|
35 .TP
|
jpayne@68
|
36 \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
|
jpayne@68
|
37 write output to specified file
|
jpayne@68
|
38 .PP
|
jpayne@68
|
39 The results are written to standard output if no output file is specified
|
jpayne@68
|
40 or if it is \-.
|
jpayne@68
|
41 .SS "Message selection:"
|
jpayne@68
|
42 .TP
|
jpayne@68
|
43 \-<, \fB\-\-less\-than\fR=\fI\,NUMBER\/\fR
|
jpayne@68
|
44 print messages with less than this many
|
jpayne@68
|
45 definitions, defaults to infinite if not set
|
jpayne@68
|
46 .TP
|
jpayne@68
|
47 \->, \fB\-\-more\-than\fR=\fI\,NUMBER\/\fR
|
jpayne@68
|
48 print messages with more than this many
|
jpayne@68
|
49 definitions, defaults to 0 if not set
|
jpayne@68
|
50 .TP
|
jpayne@68
|
51 \fB\-u\fR, \fB\-\-unique\fR
|
jpayne@68
|
52 shorthand for \fB\-\-less\-than\fR=\fI\,2\/\fR, requests
|
jpayne@68
|
53 that only unique messages be printed
|
jpayne@68
|
54 .SS "Input file syntax:"
|
jpayne@68
|
55 .TP
|
jpayne@68
|
56 \fB\-P\fR, \fB\-\-properties\-input\fR
|
jpayne@68
|
57 input files are in Java .properties syntax
|
jpayne@68
|
58 .TP
|
jpayne@68
|
59 \fB\-\-stringtable\-input\fR
|
jpayne@68
|
60 input files are in NeXTstep/GNUstep .strings
|
jpayne@68
|
61 syntax
|
jpayne@68
|
62 .SS "Output details:"
|
jpayne@68
|
63 .TP
|
jpayne@68
|
64 \fB\-t\fR, \fB\-\-to\-code\fR=\fI\,NAME\/\fR
|
jpayne@68
|
65 encoding for output
|
jpayne@68
|
66 .TP
|
jpayne@68
|
67 \fB\-\-use\-first\fR
|
jpayne@68
|
68 use first available translation for each
|
jpayne@68
|
69 message, don't merge several translations
|
jpayne@68
|
70 .TP
|
jpayne@68
|
71 \fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
|
jpayne@68
|
72 set 'Language' field in the header entry
|
jpayne@68
|
73 .TP
|
jpayne@68
|
74 \fB\-\-color\fR
|
jpayne@68
|
75 use colors and other text attributes always
|
jpayne@68
|
76 .TP
|
jpayne@68
|
77 \fB\-\-color\fR=\fI\,WHEN\/\fR
|
jpayne@68
|
78 use colors and other text attributes if WHEN.
|
jpayne@68
|
79 WHEN may be 'always', 'never', 'auto', or 'html'.
|
jpayne@68
|
80 .TP
|
jpayne@68
|
81 \fB\-\-style\fR=\fI\,STYLEFILE\/\fR
|
jpayne@68
|
82 specify CSS style rule file for \fB\-\-color\fR
|
jpayne@68
|
83 .TP
|
jpayne@68
|
84 \fB\-e\fR, \fB\-\-no\-escape\fR
|
jpayne@68
|
85 do not use C escapes in output (default)
|
jpayne@68
|
86 .TP
|
jpayne@68
|
87 \fB\-E\fR, \fB\-\-escape\fR
|
jpayne@68
|
88 use C escapes in output, no extended chars
|
jpayne@68
|
89 .TP
|
jpayne@68
|
90 \fB\-\-force\-po\fR
|
jpayne@68
|
91 write PO file even if empty
|
jpayne@68
|
92 .TP
|
jpayne@68
|
93 \fB\-i\fR, \fB\-\-indent\fR
|
jpayne@68
|
94 write the .po file using indented style
|
jpayne@68
|
95 .TP
|
jpayne@68
|
96 \fB\-\-no\-location\fR
|
jpayne@68
|
97 do not write '#: filename:line' lines
|
jpayne@68
|
98 .TP
|
jpayne@68
|
99 \fB\-n\fR, \fB\-\-add\-location\fR
|
jpayne@68
|
100 generate '#: filename:line' lines (default)
|
jpayne@68
|
101 .TP
|
jpayne@68
|
102 \fB\-\-strict\fR
|
jpayne@68
|
103 write out strict Uniforum conforming .po file
|
jpayne@68
|
104 .TP
|
jpayne@68
|
105 \fB\-p\fR, \fB\-\-properties\-output\fR
|
jpayne@68
|
106 write out a Java .properties file
|
jpayne@68
|
107 .TP
|
jpayne@68
|
108 \fB\-\-stringtable\-output\fR
|
jpayne@68
|
109 write out a NeXTstep/GNUstep .strings file
|
jpayne@68
|
110 .TP
|
jpayne@68
|
111 \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
|
jpayne@68
|
112 set output page width
|
jpayne@68
|
113 .TP
|
jpayne@68
|
114 \fB\-\-no\-wrap\fR
|
jpayne@68
|
115 do not break long message lines, longer than
|
jpayne@68
|
116 the output page width, into several lines
|
jpayne@68
|
117 .TP
|
jpayne@68
|
118 \fB\-s\fR, \fB\-\-sort\-output\fR
|
jpayne@68
|
119 generate sorted output
|
jpayne@68
|
120 .TP
|
jpayne@68
|
121 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
|
jpayne@68
|
122 sort output by file location
|
jpayne@68
|
123 .SS "Informative output:"
|
jpayne@68
|
124 .TP
|
jpayne@68
|
125 \fB\-h\fR, \fB\-\-help\fR
|
jpayne@68
|
126 display this help and exit
|
jpayne@68
|
127 .TP
|
jpayne@68
|
128 \fB\-V\fR, \fB\-\-version\fR
|
jpayne@68
|
129 output version information and exit
|
jpayne@68
|
130 .SH AUTHOR
|
jpayne@68
|
131 Written by Bruno Haible.
|
jpayne@68
|
132 .SH "REPORTING BUGS"
|
jpayne@68
|
133 Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
|
jpayne@68
|
134 or by email to <bug\-gettext@gnu.org>.
|
jpayne@68
|
135 .SH COPYRIGHT
|
jpayne@68
|
136 Copyright \(co 2001\-2023 Free Software Foundation, Inc.
|
jpayne@68
|
137 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
|
jpayne@68
|
138 .br
|
jpayne@68
|
139 This is free software: you are free to change and redistribute it.
|
jpayne@68
|
140 There is NO WARRANTY, to the extent permitted by law.
|
jpayne@68
|
141 .SH "SEE ALSO"
|
jpayne@68
|
142 The full documentation for
|
jpayne@68
|
143 .B msgcat
|
jpayne@68
|
144 is maintained as a Texinfo manual. If the
|
jpayne@68
|
145 .B info
|
jpayne@68
|
146 and
|
jpayne@68
|
147 .B msgcat
|
jpayne@68
|
148 programs are properly installed at your site, the command
|
jpayne@68
|
149 .IP
|
jpayne@68
|
150 .B info msgcat
|
jpayne@68
|
151 .PP
|
jpayne@68
|
152 should give you access to the complete manual.
|