| .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24. |
| .TH MSGMERGE "1" "June 2010" "GNU gettext-tools 0.18.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\-\-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. |
