1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24.
2 .TH MSGMERGE "1" "January 2014" "GNU gettext-tools 0.18.3" GNU
4 msgmerge \- merge message catalog and template
7 [\fIOPTION\fR] \fIdef.po ref.pot\fR
9 .\" Add any additional description here
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.
21 Mandatory arguments to long options are mandatory for short options too.
22 .SS "Input file location:"
25 translations referring to old sources
28 references to new sources
30 \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
31 add DIRECTORY to list for input files search
33 \fB\-C\fR, \fB\-\-compendium\fR=\fIFILE\fR
34 additional library of message translations,
35 may be specified more than once
38 \fB\-U\fR, \fB\-\-update\fR
40 do nothing if def.po already up to date
41 .SS "Output file location:"
43 \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
44 write output to specified file
46 The results are written to standard output if no output file is specified
49 Output file location in update mode:
50 The result is written back to def.po.
52 \fB\-\-backup\fR=\fICONTROL\fR
53 make a backup of def.po
55 \fB\-\-suffix\fR=\fISUFFIX\fR
56 override the usual backup suffix
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:
62 never make backups (even if \fB\-\-backup\fR is given)
68 numbered if numbered backups exist, simple otherwise
71 always make simple backups
73 The backup suffix is '~', unless set with \fB\-\-suffix\fR or the SIMPLE_BACKUP_SUFFIX
75 .SS "Operation modifiers:"
77 \fB\-m\fR, \fB\-\-multi\-domain\fR
78 apply ref.pot to each of the domains in def.po
80 \fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
81 do not use fuzzy matching
84 keep previous msgids of translated messages
85 .SS "Input file syntax:"
87 \fB\-P\fR, \fB\-\-properties\-input\fR
88 input files are in Java .properties syntax
90 \fB\-\-stringtable\-input\fR
91 input files are in NeXTstep/GNUstep .strings
95 \fB\-\-lang\fR=\fICATALOGNAME\fR
96 set 'Language' field in the header entry
99 use colors and other text attributes always
101 \fB\-\-color\fR=\fIWHEN\fR
102 use colors and other text attributes if WHEN.
103 WHEN may be 'always', 'never', 'auto', or 'html'.
105 \fB\-\-style\fR=\fISTYLEFILE\fR
106 specify CSS style rule file for \fB\-\-color\fR
108 \fB\-e\fR, \fB\-\-no\-escape\fR
109 do not use C escapes in output (default)
111 \fB\-E\fR, \fB\-\-escape\fR
112 use C escapes in output, no extended chars
115 write PO file even if empty
117 \fB\-i\fR, \fB\-\-indent\fR
118 indented output style
120 \fB\-\-no\-location\fR
121 suppress '#: filename:line' lines
123 \fB\-\-add\-location\fR
124 preserve '#: filename:line' lines (default)
127 strict Uniforum output style
129 \fB\-p\fR, \fB\-\-properties\-output\fR
130 write out a Java .properties file
132 \fB\-\-stringtable\-output\fR
133 write out a NeXTstep/GNUstep .strings file
135 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
136 set output page width
139 do not break long message lines, longer than
140 the output page width, into several lines
142 \fB\-s\fR, \fB\-\-sort\-output\fR
143 generate sorted output
145 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
146 sort output by file location
147 .SS "Informative output:"
149 \fB\-h\fR, \fB\-\-help\fR
150 display this help and exit
152 \fB\-V\fR, \fB\-\-version\fR
153 output version information and exit
155 \fB\-v\fR, \fB\-\-verbose\fR
156 increase verbosity level
158 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
159 suppress progress indicators
161 Written by Peter Miller.
163 Report bugs to <bug-gnu-gettext@gnu.org>.
165 Copyright \(co 1995-1998, 2000-2010 Free Software Foundation, Inc.
166 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
168 This is free software: you are free to change and redistribute it.
169 There is NO WARRANTY, to the extent permitted by law.
171 The full documentation for
173 is maintained as a Texinfo manual. If the
177 programs are properly installed at your site, the command
181 should give you access to the complete manual.