182 lines
4.9 KiB
Groff
Executable File
182 lines
4.9 KiB
Groff
Executable File
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24.
|
|
.TH MSGMERGE "1" "July 2015" "GNU gettext-tools 0.19.5.1" GNU
|
|
.SH NAME
|
|
msgmerge \- merge message catalog and template
|
|
.SH SYNOPSIS
|
|
.B msgmerge
|
|
[\fIOPTION\fR] \fIdef.po ref.pot\fR
|
|
.SH DESCRIPTION
|
|
.\" Add any additional description here
|
|
.PP
|
|
Merges two Uniforum style .po files together. The def.po file is an
|
|
existing PO file with translations which will be taken over to the newly
|
|
created file as long as they still match; comments will be preserved,
|
|
but extracted comments and file positions will be discarded. The ref.pot
|
|
file is the last created PO file with up-to-date source references but
|
|
old translations, or a PO Template file (generally created by xgettext);
|
|
any translations or comments in the file will be discarded, however dot
|
|
comments and file positions will be preserved. Where an exact match
|
|
cannot be found, fuzzy matching is used to produce better results.
|
|
.PP
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
.SS "Input file location:"
|
|
.TP
|
|
def.po
|
|
translations referring to old sources
|
|
.TP
|
|
ref.pot
|
|
references to new sources
|
|
.TP
|
|
\fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
|
|
add DIRECTORY to list for input files search
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-compendium\fR=\fIFILE\fR
|
|
additional library of message translations,
|
|
may be specified more than once
|
|
.SS "Operation mode:"
|
|
.TP
|
|
\fB\-U\fR, \fB\-\-update\fR
|
|
update def.po,
|
|
do nothing if def.po already up to date
|
|
.SS "Output file location:"
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
|
|
write output to specified file
|
|
.PP
|
|
The results are written to standard output if no output file is specified
|
|
or if it is -.
|
|
.PP
|
|
Output file location in update mode:
|
|
The result is written back to def.po.
|
|
.TP
|
|
\fB\-\-backup\fR=\fICONTROL\fR
|
|
make a backup of def.po
|
|
.TP
|
|
\fB\-\-suffix\fR=\fISUFFIX\fR
|
|
override the usual backup suffix
|
|
.PP
|
|
The version control method may be selected via the \fB\-\-backup\fR option or through
|
|
the VERSION_CONTROL environment variable. Here are the values:
|
|
.TP
|
|
none, off
|
|
never make backups (even if \fB\-\-backup\fR is given)
|
|
.TP
|
|
numbered, t
|
|
make numbered backups
|
|
.TP
|
|
existing, nil
|
|
numbered if numbered backups exist, simple otherwise
|
|
.TP
|
|
simple, never
|
|
always make simple backups
|
|
.PP
|
|
The backup suffix is '~', unless set with \fB\-\-suffix\fR or the SIMPLE_BACKUP_SUFFIX
|
|
environment variable.
|
|
.SS "Operation modifiers:"
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-multi\-domain\fR
|
|
apply ref.pot to each of the domains in def.po
|
|
.TP
|
|
\fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
|
|
do not use fuzzy matching
|
|
.TP
|
|
\fB\-\-previous\fR
|
|
keep previous msgids of translated messages
|
|
.SS "Input file syntax:"
|
|
.TP
|
|
\fB\-P\fR, \fB\-\-properties\-input\fR
|
|
input files are in Java .properties syntax
|
|
.TP
|
|
\fB\-\-stringtable\-input\fR
|
|
input files are in NeXTstep/GNUstep .strings
|
|
syntax
|
|
.SS "Output details:"
|
|
.TP
|
|
\fB\-\-lang\fR=\fICATALOGNAME\fR
|
|
set 'Language' field in the header entry
|
|
.TP
|
|
\fB\-\-color\fR
|
|
use colors and other text attributes always
|
|
.TP
|
|
\fB\-\-color\fR=\fIWHEN\fR
|
|
use colors and other text attributes if WHEN.
|
|
WHEN may be 'always', 'never', 'auto', or 'html'.
|
|
.TP
|
|
\fB\-\-style\fR=\fISTYLEFILE\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
|
|
indented output style
|
|
.TP
|
|
\fB\-\-no\-location\fR
|
|
suppress '#: filename:line' lines
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-add\-location\fR
|
|
preserve '#: filename:line' lines (default)
|
|
.TP
|
|
\fB\-\-strict\fR
|
|
strict Uniforum output style
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-properties\-output\fR
|
|
write out a Java .properties file
|
|
.TP
|
|
\fB\-\-stringtable\-output\fR
|
|
write out a NeXTstep/GNUstep .strings file
|
|
.TP
|
|
\fB\-w\fR, \fB\-\-width\fR=\fINUMBER\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
|
|
.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
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
|
|
suppress progress indicators
|
|
.SH AUTHOR
|
|
Written by Peter Miller.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <bug-gnu-gettext@gnu.org>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 1995-1998, 2000-2010 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <http://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 msgmerge
|
|
is maintained as a Texinfo manual. If the
|
|
.B info
|
|
and
|
|
.B msgmerge
|
|
programs are properly installed at your site, the command
|
|
.IP
|
|
.B info msgmerge
|
|
.PP
|
|
should give you access to the complete manual.
|