man pages section 1: User Commands

Exit Print View

Updated: July 2014

msgmerge (1)


msgmerge - merge message catalog and template


msgmerge [OPTION] def.po ref.pot


GNU                                                   MSGMERGE(1)

     msgmerge - merge message catalog and template

     msgmerge [OPTION] def.po ref.pot

     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 cre-
     ated 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.

     Mandatory  arguments to long options are mandatory for short
     options too.

  Input file location:
          translations referring to old sources

          references to new sources

     -D, --directory=DIRECTORY
          add DIRECTORY to list for input files search

     -C, --compendium=FILE
          additional library  of  message  translations,  may  be
          specified more than once

  Operation mode:
     -U, --update
          update def.po, do nothing if def.po already up to date

  Output file location:
     -o, --output-file=FILE
          write output to specified file

     The results are written to standard output if no output file
     is specified or if it is -.

     Output file location in update mode: The result  is  written
     back to def.po.

          make a backup of def.po

GNU gettext-tools 0.Last change: November 2006                  1

GNU                                                   MSGMERGE(1)

          override the usual backup suffix

     The  version control method may be selected via the --backup
     option or through the VERSION_CONTROL environment  variable.
     Here are the values:

     none, off
          never make backups (even if --backup is given)

     numbered, t
          make numbered backups

     existing, nil
          numbered if numbered backups exist, simple otherwise

     simple, never
          always make simple backups

     The  backup  suffix  is `~', unless set with --suffix or the
     SIMPLE_BACKUP_SUFFIX environment variable.

  Operation modifiers:
     -m, --multi-domain
          apply ref.pot to each of the domains in def.po

     -N, --no-fuzzy-matching
          do not use fuzzy matching

          keep previous msgids of translated messages

  Input file syntax:
     -P, --properties-input
          input files are in Java .properties syntax

          input files are in NeXTstep/GNUstep .strings syntax

  Output details:
     -e, --no-escape
          do not use C escapes in output (default)

     -E, --escape
          use C escapes in output, no extended chars

          write PO file even if empty

     -i, --indent
          indented output style

GNU gettext-tools 0.Last change: November 2006                  2

GNU                                                   MSGMERGE(1)

          suppress '#: filename:line' lines

          preserve '#: filename:line' lines (default)

          strict Uniforum output style

     -p, --properties-output
          write out a Java .properties file

          write out a NeXTstep/GNUstep .strings file

     -w, --width=NUMBER
          set output page width

          do not break long message lines, longer than the output
          page width, into several lines

     -s, --sort-output
          generate sorted output

     -F, --sort-by-file
          sort output by file location

  Informative output:
     -h, --help
          display this help and exit

     -V, --version
          output version information and exit

     -v, --verbose
          increase verbosity level

     -q, --quiet, --silent
          suppress progress indicators

     Written by Peter Miller.

     Report bugs to <>.

     Copyright (C) 1995-1998, 2000-2006 Free Software Foundation,
     This is free software; see the  source  for  copying  condi-
     tions.   There  is NO warranty; not even for MERCHANTABILITY

GNU gettext-tools 0.Last change: November 2006                  3

GNU                                                   MSGMERGE(1)


     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | text/gnu-gettext |
     |Stability      | Uncommitted      |
     The  full documentation for msgmerge is maintained as a Tex-
     info manual.  If the info and msgmerge programs are properly
     installed at your site, the command

          info msgmerge

     should give you access to the complete manual.

     This   software   was   built   from   source  available  at   The   original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open  source  community  website at

GNU gettext-tools 0.Last change: November 2006                  4