gnu/dist/gettext/gettext-tools/man/msgmerge.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
   2 .TH MSGMERGE "1" "April 2005" "GNU gettext-tools 0.14.4" GNU
   3 .SH NAME
   4 msgmerge \- merge message catalog and template
   5 .SH SYNOPSIS
   6 .B msgmerge
   7 [\fIOPTION\fR] \fIdef.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=\fIDIRECTORY\fR
  31 add DIRECTORY to list for input files search
  32 .TP
  33 \fB\-C\fR, \fB\-\-compendium\fR=\fIFILE\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=\fIFILE\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=\fICONTROL\fR
  53 make a backup of def.po
  54 .TP
  55 \fB\-\-suffix\fR=\fISUFFIX\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\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
  81 do not use fuzzy matching
  82 .SS "Input file syntax:"
  83 .TP
  84 \fB\-P\fR, \fB\-\-properties\-input\fR
  85 input files are in Java .properties syntax
  86 .TP
  87 \fB\-\-stringtable\-input\fR
  88 input files are in NeXTstep/GNUstep .strings
  89 syntax
  90 .SS "Output details:"
  91 .TP
  92 \fB\-e\fR, \fB\-\-no\-escape\fR
  93 do not use C escapes in output (default)
  94 .TP
  95 \fB\-E\fR, \fB\-\-escape\fR
  96 use C escapes in output, no extended chars
  97 .TP
  98 \fB\-\-force\-po\fR
  99 write PO file even if empty
 100 .TP
 101 \fB\-i\fR, \fB\-\-indent\fR
 102 indented output style
 103 .TP
 104 \fB\-\-no\-location\fR
 105 suppress '#: filename:line' lines
 106 .TP
 107 \fB\-\-add\-location\fR
 108 preserve '#: filename:line' lines (default)
 109 .TP
 110 \fB\-\-strict\fR
 111 strict Uniforum output style
 112 .TP
 113 \fB\-p\fR, \fB\-\-properties\-output\fR
 114 write out a Java .properties file
 115 .TP
 116 \fB\-\-stringtable\-output\fR
 117 write out a NeXTstep/GNUstep .strings file
 118 .TP
 119 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
 120 set output page width
 121 .TP
 122 \fB\-\-no\-wrap\fR
 123 do not break long message lines, longer than
 124 the output page width, into several lines
 125 .TP
 126 \fB\-s\fR, \fB\-\-sort\-output\fR
 127 generate sorted output
 128 .TP
 129 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
 130 sort output by file location
 131 .SS "Informative output:"
 132 .TP
 133 \fB\-h\fR, \fB\-\-help\fR
 134 display this help and exit
 135 .TP
 136 \fB\-V\fR, \fB\-\-version\fR
 137 output version information and exit
 138 .TP
 139 \fB\-v\fR, \fB\-\-verbose\fR
 140 increase verbosity level
 141 .TP
 142 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
 143 suppress progress indicators
 144 .SH AUTHOR
 145 Written by Peter Miller.
 146 .SH "REPORTING BUGS"
 147 Report bugs to <bug-gnu-gettext@gnu.org>.
 148 .SH COPYRIGHT
 149 Copyright \(co 1995-1998, 2000-2005 Free Software Foundation, Inc.
 150 .br
 151 This is free software; see the source for copying conditions.  There is NO
 152 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 153 .SH "SEE ALSO"
 154 The full documentation for
 155 .B msgmerge
 156 is maintained as a Texinfo manual.  If the
 157 .B info
 158 and
 159 .B msgmerge
 160 programs are properly installed at your site, the command
 161 .IP
 162 .B info msgmerge
 163 .PP
 164 should give you access to the complete manual.