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