jpayne@68: .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
jpayne@68: .TH MSGMERGE "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands"
jpayne@68: .SH NAME
jpayne@68: msgmerge \- merge message catalog and template
jpayne@68: .SH SYNOPSIS
jpayne@68: .B msgmerge
jpayne@68: [\fI\,OPTION\/\fR] \fI\,def.po ref.pot\/\fR
jpayne@68: .SH DESCRIPTION
jpayne@68: .\" Add any additional description here
jpayne@68: .PP
jpayne@68: Merges two Uniforum style .po files together.  The def.po file is an
jpayne@68: existing PO file with translations which will be taken over to the newly
jpayne@68: created file as long as they still match; comments will be preserved,
jpayne@68: but extracted comments and file positions will be discarded.  The ref.pot
jpayne@68: file is the last created PO file with up\-to\-date source references but
jpayne@68: old translations, or a PO Template file (generally created by xgettext);
jpayne@68: any translations or comments in the file will be discarded, however dot
jpayne@68: comments and file positions will be preserved.  Where an exact match
jpayne@68: cannot be found, fuzzy matching is used to produce better results.
jpayne@68: .PP
jpayne@68: Mandatory arguments to long options are mandatory for short options too.
jpayne@68: .SS "Input file location:"
jpayne@68: .TP
jpayne@68: def.po
jpayne@68: translations referring to old sources
jpayne@68: .TP
jpayne@68: ref.pot
jpayne@68: references to new sources
jpayne@68: .TP
jpayne@68: \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
jpayne@68: add DIRECTORY to list for input files search
jpayne@68: .TP
jpayne@68: \fB\-C\fR, \fB\-\-compendium\fR=\fI\,FILE\/\fR
jpayne@68: additional library of message translations,
jpayne@68: may be specified more than once
jpayne@68: .SS "Operation mode:"
jpayne@68: .TP
jpayne@68: \fB\-U\fR, \fB\-\-update\fR
jpayne@68: update def.po,
jpayne@68: do nothing if def.po already up to date
jpayne@68: .SS "Output file location:"
jpayne@68: .TP
jpayne@68: \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
jpayne@68: write output to specified file
jpayne@68: .PP
jpayne@68: The results are written to standard output if no output file is specified
jpayne@68: or if it is \-.
jpayne@68: .PP
jpayne@68: Output file location in update mode:
jpayne@68: The result is written back to def.po.
jpayne@68: .TP
jpayne@68: \fB\-\-backup\fR=\fI\,CONTROL\/\fR
jpayne@68: make a backup of def.po
jpayne@68: .TP
jpayne@68: \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
jpayne@68: override the usual backup suffix
jpayne@68: .PP
jpayne@68: The version control method may be selected via the \fB\-\-backup\fR option or through
jpayne@68: the VERSION_CONTROL environment variable.  Here are the values:
jpayne@68: .TP
jpayne@68: none, off
jpayne@68: never make backups (even if \fB\-\-backup\fR is given)
jpayne@68: .TP
jpayne@68: numbered, t
jpayne@68: make numbered backups
jpayne@68: .TP
jpayne@68: existing, nil
jpayne@68: numbered if numbered backups exist, simple otherwise
jpayne@68: .TP
jpayne@68: simple, never
jpayne@68: always make simple backups
jpayne@68: .PP
jpayne@68: The backup suffix is '~', unless set with \fB\-\-suffix\fR or the SIMPLE_BACKUP_SUFFIX
jpayne@68: environment variable.
jpayne@68: .SS "Operation modifiers:"
jpayne@68: .TP
jpayne@68: \fB\-m\fR, \fB\-\-multi\-domain\fR
jpayne@68: apply ref.pot to each of the domains in def.po
jpayne@68: .TP
jpayne@68: \fB\-\-for\-msgfmt\fR
jpayne@68: produce output for 'msgfmt', not for a translator
jpayne@68: .TP
jpayne@68: \fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
jpayne@68: do not use fuzzy matching
jpayne@68: .TP
jpayne@68: \fB\-\-previous\fR
jpayne@68: keep previous msgids of translated messages
jpayne@68: .SS "Input file syntax:"
jpayne@68: .TP
jpayne@68: \fB\-P\fR, \fB\-\-properties\-input\fR
jpayne@68: input files are in Java .properties syntax
jpayne@68: .TP
jpayne@68: \fB\-\-stringtable\-input\fR
jpayne@68: input files are in NeXTstep/GNUstep .strings
jpayne@68: syntax
jpayne@68: .SS "Output details:"
jpayne@68: .TP
jpayne@68: \fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
jpayne@68: set 'Language' field in the header entry
jpayne@68: .TP
jpayne@68: \fB\-\-color\fR
jpayne@68: use colors and other text attributes always
jpayne@68: .TP
jpayne@68: \fB\-\-color\fR=\fI\,WHEN\/\fR
jpayne@68: use colors and other text attributes if WHEN.
jpayne@68: WHEN may be 'always', 'never', 'auto', or 'html'.
jpayne@68: .TP
jpayne@68: \fB\-\-style\fR=\fI\,STYLEFILE\/\fR
jpayne@68: specify CSS style rule file for \fB\-\-color\fR
jpayne@68: .TP
jpayne@68: \fB\-e\fR, \fB\-\-no\-escape\fR
jpayne@68: do not use C escapes in output (default)
jpayne@68: .TP
jpayne@68: \fB\-E\fR, \fB\-\-escape\fR
jpayne@68: use C escapes in output, no extended chars
jpayne@68: .TP
jpayne@68: \fB\-\-force\-po\fR
jpayne@68: write PO file even if empty
jpayne@68: .TP
jpayne@68: \fB\-i\fR, \fB\-\-indent\fR
jpayne@68: indented output style
jpayne@68: .TP
jpayne@68: \fB\-\-no\-location\fR
jpayne@68: suppress '#: filename:line' lines
jpayne@68: .TP
jpayne@68: \fB\-n\fR, \fB\-\-add\-location\fR
jpayne@68: preserve '#: filename:line' lines (default)
jpayne@68: .TP
jpayne@68: \fB\-\-strict\fR
jpayne@68: strict Uniforum output style
jpayne@68: .TP
jpayne@68: \fB\-p\fR, \fB\-\-properties\-output\fR
jpayne@68: write out a Java .properties file
jpayne@68: .TP
jpayne@68: \fB\-\-stringtable\-output\fR
jpayne@68: write out a NeXTstep/GNUstep .strings file
jpayne@68: .TP
jpayne@68: \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
jpayne@68: set output page width
jpayne@68: .TP
jpayne@68: \fB\-\-no\-wrap\fR
jpayne@68: do not break long message lines, longer than
jpayne@68: the output page width, into several lines
jpayne@68: .TP
jpayne@68: \fB\-s\fR, \fB\-\-sort\-output\fR
jpayne@68: generate sorted output
jpayne@68: .TP
jpayne@68: \fB\-F\fR, \fB\-\-sort\-by\-file\fR
jpayne@68: sort output by file location
jpayne@68: .SS "Informative output:"
jpayne@68: .TP
jpayne@68: \fB\-h\fR, \fB\-\-help\fR
jpayne@68: display this help and exit
jpayne@68: .TP
jpayne@68: \fB\-V\fR, \fB\-\-version\fR
jpayne@68: output version information and exit
jpayne@68: .TP
jpayne@68: \fB\-v\fR, \fB\-\-verbose\fR
jpayne@68: increase verbosity level
jpayne@68: .TP
jpayne@68: \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
jpayne@68: suppress progress indicators
jpayne@68: .SH AUTHOR
jpayne@68: Written by Peter Miller.
jpayne@68: .SH "REPORTING BUGS"
jpayne@68: Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
jpayne@68: or by email to <bug\-gettext@gnu.org>.
jpayne@68: .SH COPYRIGHT
jpayne@68: Copyright \(co 1995\-2023 Free Software Foundation, Inc.
jpayne@68: License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
jpayne@68: .br
jpayne@68: This is free software: you are free to change and redistribute it.
jpayne@68: There is NO WARRANTY, to the extent permitted by law.
jpayne@68: .SH "SEE ALSO"
jpayne@68: The full documentation for
jpayne@68: .B msgmerge
jpayne@68: is maintained as a Texinfo manual.  If the
jpayne@68: .B info
jpayne@68: and
jpayne@68: .B msgmerge
jpayne@68: programs are properly installed at your site, the command
jpayne@68: .IP
jpayne@68: .B info msgmerge
jpayne@68: .PP
jpayne@68: should give you access to the complete manual.