gnu/dist/gettext/gettext-tools/doc/msgcmp.texi

   1 @pindex msgcmp
   2 @cindex @code{msgcmp} program, usage
   3 @example
   4 msgcmp [@var{option}] @var{def}.po @var{ref}.pot
   5 @end example
   6
   7 @cindex compare PO files
   8 The @code{msgcmp} program compares two Uniforum style .po files to check that
   9 both contain the same set of msgid strings.  The @var{def}.po file is an
  10 existing PO file with the translations.  The @var{ref}.pot file is the last
  11 created PO file, or a PO Template file (generally created by @code{xgettext}).
  12 This is useful for checking that you have translated each and every message
  13 in your program.  Where an exact match cannot be found, fuzzy matching is
  14 used to produce better diagnostics.
  15
  16 @subsection Input file location
  17
  18 @table @samp
  19 @item @var{def}.po
  20 Translations.
  21
  22 @item @var{ref}.pot
  23 References to the sources.
  24
  25 @item -D @var{directory}
  26 @itemx --directory=@var{directory}
  27 @opindex -D@r{, @code{msgcmp} option}
  28 @opindex --directory@r{, @code{msgcmp} option}
  29 Add @var{directory} to the list of directories.  Source files are
  30 searched relative to this list of directories.
  31
  32 @end table
  33
  34 @subsection Operation modifiers
  35
  36 @table @samp
  37 @item -m
  38 @itemx --multi-domain
  39 @opindex -m@r{, @code{msgcmp} option}
  40 @opindex --multi-domain@r{, @code{msgcmp} option}
  41 Apply @var{ref}.pot to each of the domains in @var{def}.po.
  42
  43 @end table
  44
  45 @subsection Input file syntax
  46
  47 @table @samp
  48 @item -P
  49 @itemx --properties-input
  50 @opindex -P@r{, @code{msgcmp} option}
  51 @opindex --properties-input@r{, @code{msgcmp} option}
  52 Assume the input files are Java ResourceBundles in Java @code{.properties}
  53 syntax, not in PO file syntax.
  54
  55 @item --stringtable-input
  56 @opindex --stringtable-input@r{, @code{msgcmp} option}
  57 Assume the input files are NeXTstep/GNUstep localized resource files in
  58 @code{.strings} syntax, not in PO file syntax.
  59
  60 @end table
  61
  62 @subsection Informative output
  63
  64 @table @samp
  65 @item -h
  66 @itemx --help
  67 @opindex -h@r{, @code{msgcmp} option}
  68 @opindex --help@r{, @code{msgcmp} option}
  69 Display this help and exit.
  70
  71 @item -V
  72 @itemx --version
  73 @opindex -V@r{, @code{msgcmp} option}
  74 @opindex --version@r{, @code{msgcmp} option}
  75 Output version information and exit.
  76
  77 @end table