comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/man/man1/msgmerge.1 @ 68:5028fdace37b

planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 68:5028fdace37b
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
2 .TH MSGMERGE "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands"
3 .SH NAME
4 msgmerge \- merge message catalog and template
5 .SH SYNOPSIS
6 .B msgmerge
7 [\fI\,OPTION\/\fR] \fI\,def.po ref.pot\/\fR
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Merges two Uniforum style .po files together. The def.po file is an
12 existing PO file with translations which will be taken over to the newly
13 created file as long as they still match; comments will be preserved,
14 but extracted comments and file positions will be discarded. The ref.pot
15 file is the last created PO file with up\-to\-date source references but
16 old translations, or a PO Template file (generally created by xgettext);
17 any translations or comments in the file will be discarded, however dot
18 comments and file positions will be preserved. Where an exact match
19 cannot be found, fuzzy matching is used to produce better results.
20 .PP
21 Mandatory arguments to long options are mandatory for short options too.
22 .SS "Input file location:"
23 .TP
24 def.po
25 translations referring to old sources
26 .TP
27 ref.pot
28 references to new sources
29 .TP
30 \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
31 add DIRECTORY to list for input files search
32 .TP
33 \fB\-C\fR, \fB\-\-compendium\fR=\fI\,FILE\/\fR
34 additional library of message translations,
35 may be specified more than once
36 .SS "Operation mode:"
37 .TP
38 \fB\-U\fR, \fB\-\-update\fR
39 update def.po,
40 do nothing if def.po already up to date
41 .SS "Output file location:"
42 .TP
43 \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
44 write output to specified file
45 .PP
46 The results are written to standard output if no output file is specified
47 or if it is \-.
48 .PP
49 Output file location in update mode:
50 The result is written back to def.po.
51 .TP
52 \fB\-\-backup\fR=\fI\,CONTROL\/\fR
53 make a backup of def.po
54 .TP
55 \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
56 override the usual backup suffix
57 .PP
58 The version control method may be selected via the \fB\-\-backup\fR option or through
59 the VERSION_CONTROL environment variable. Here are the values:
60 .TP
61 none, off
62 never make backups (even if \fB\-\-backup\fR is given)
63 .TP
64 numbered, t
65 make numbered backups
66 .TP
67 existing, nil
68 numbered if numbered backups exist, simple otherwise
69 .TP
70 simple, never
71 always make simple backups
72 .PP
73 The backup suffix is '~', unless set with \fB\-\-suffix\fR or the SIMPLE_BACKUP_SUFFIX
74 environment variable.
75 .SS "Operation modifiers:"
76 .TP
77 \fB\-m\fR, \fB\-\-multi\-domain\fR
78 apply ref.pot to each of the domains in def.po
79 .TP
80 \fB\-\-for\-msgfmt\fR
81 produce output for 'msgfmt', not for a translator
82 .TP
83 \fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
84 do not use fuzzy matching
85 .TP
86 \fB\-\-previous\fR
87 keep previous msgids of translated messages
88 .SS "Input file syntax:"
89 .TP
90 \fB\-P\fR, \fB\-\-properties\-input\fR
91 input files are in Java .properties syntax
92 .TP
93 \fB\-\-stringtable\-input\fR
94 input files are in NeXTstep/GNUstep .strings
95 syntax
96 .SS "Output details:"
97 .TP
98 \fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
99 set 'Language' field in the header entry
100 .TP
101 \fB\-\-color\fR
102 use colors and other text attributes always
103 .TP
104 \fB\-\-color\fR=\fI\,WHEN\/\fR
105 use colors and other text attributes if WHEN.
106 WHEN may be 'always', 'never', 'auto', or 'html'.
107 .TP
108 \fB\-\-style\fR=\fI\,STYLEFILE\/\fR
109 specify CSS style rule file for \fB\-\-color\fR
110 .TP
111 \fB\-e\fR, \fB\-\-no\-escape\fR
112 do not use C escapes in output (default)
113 .TP
114 \fB\-E\fR, \fB\-\-escape\fR
115 use C escapes in output, no extended chars
116 .TP
117 \fB\-\-force\-po\fR
118 write PO file even if empty
119 .TP
120 \fB\-i\fR, \fB\-\-indent\fR
121 indented output style
122 .TP
123 \fB\-\-no\-location\fR
124 suppress '#: filename:line' lines
125 .TP
126 \fB\-n\fR, \fB\-\-add\-location\fR
127 preserve '#: filename:line' lines (default)
128 .TP
129 \fB\-\-strict\fR
130 strict Uniforum output style
131 .TP
132 \fB\-p\fR, \fB\-\-properties\-output\fR
133 write out a Java .properties file
134 .TP
135 \fB\-\-stringtable\-output\fR
136 write out a NeXTstep/GNUstep .strings file
137 .TP
138 \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
139 set output page width
140 .TP
141 \fB\-\-no\-wrap\fR
142 do not break long message lines, longer than
143 the output page width, into several lines
144 .TP
145 \fB\-s\fR, \fB\-\-sort\-output\fR
146 generate sorted output
147 .TP
148 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
149 sort output by file location
150 .SS "Informative output:"
151 .TP
152 \fB\-h\fR, \fB\-\-help\fR
153 display this help and exit
154 .TP
155 \fB\-V\fR, \fB\-\-version\fR
156 output version information and exit
157 .TP
158 \fB\-v\fR, \fB\-\-verbose\fR
159 increase verbosity level
160 .TP
161 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
162 suppress progress indicators
163 .SH AUTHOR
164 Written by Peter Miller.
165 .SH "REPORTING BUGS"
166 Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
167 or by email to <bug\-gettext@gnu.org>.
168 .SH COPYRIGHT
169 Copyright \(co 1995\-2023 Free Software Foundation, Inc.
170 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
171 .br
172 This is free software: you are free to change and redistribute it.
173 There is NO WARRANTY, to the extent permitted by law.
174 .SH "SEE ALSO"
175 The full documentation for
176 .B msgmerge
177 is maintained as a Texinfo manual. If the
178 .B info
179 and
180 .B msgmerge
181 programs are properly installed at your site, the command
182 .IP
183 .B info msgmerge
184 .PP
185 should give you access to the complete manual.