start
Table of Contents

pomerge

Pomerge will merge corrected PO files (or snippets) into your existing PO files. Usually you would extract errors using pofilter, make corrections to these PO snippets then merge them back using pomerge. You could also use pogrep to extract a number of messages matching a certain string, make corrections then merge the correction back using pomerge.

It is probably best to run pomerge against files stored in some kind of version control system so that you can monitor what changes were made.

Usage

pomerge [options] [-t <template>] -i <input> -o <output>

Where:

<template> is a set of reference PO files, either the originals or a set of POT files
<input> contains the corrected files that are to overide content in <output>
<output> contains the files whose content will be overwridden by <input>. This can be the same directory as <template>

Options:

--version show program’s version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: dots, none, bar, names, verbose
--errorlevel=ERRORLEVEL show errorlevel as: none, message, exception, traceback
-iINPUT, --input=INPUT read from INPUT in po, pot, pot formats
-xEXCLUDE, --exclude=EXCLUDE exclude names matching EXCLUDE from input paths
-oOUTPUT, --output=OUTPUT write to OUTPUT in po, pot, pot formats
-tTEMPLATE, --template=TEMPLATE read from TEMPLATE in po, pot, pot formats
--psyco=MODE use psyco to speed up the operation (set mode)
--mergeblanks=MERGEBLANKS whether to overwrite existing translations with blank translations (yes/no)
--mergecomments=MERGECOMMENTS whether to merge comments as well as translations (yes/no)

Examples

These examples show pomerge in action.

pomerge -t af -i af-check -o af

Take corrections from af-check merge them with the templates in af and output into af. Thus merge af-check and overide entries found in af. Do this only if you are using a version control system so that you can check what changes pomerge made or if you have complete and utter confidence in this tool.

pomerge --mergeblanks=yes -t af -i af-check -o af-new

Merge the corrections from af-check with templates in af and output to af-new. If an entry is blank in af-check then make it blank in the output in af-new.