NAME

       pocompendium - Create a PO compendium from a directory of PO files.

SYNOPSIS

       pocompendium [options] output.po <-d po-directory(ies)|po-file(s)>

DESCRIPTION

       Takes  a  directory  of  translated  PO  files  and  creates a single PO files called a PO
       compendium. This compendium can be used to review word choice conflicts or as input during
       a merge using pomigrate(1).

OPTIONS

       -v, --invert
              creates an inverse compendium with msgid and msgstr swapped

       -e, --errors
              only output message bundles that have conflicts

       -c, --correct
              only output message bundles that are correctly translated

       -i, --ignore-case
              drops all strings to lowercase

       -st, -tilde, --strip-accel-amp
              remove all & style accelerator markers

       -sa, -amp, --strip-accel-tilde
              remove all ~ style accelerator markers

       -su, --strip-accel-under
              remove all _ style accelerator markers

EXAMPLES

   Compendium creation
       create  a  compendium  with  all  your translations to use as input during a message merge
       either when migrating an existing project or starting a new one.

   Conflicting translations
       use --errors to find where you have translated an English string differently.  Many  times
       this is OK but often it will pick up subtle spelling mistakes or help you to migrate older
       translations to a newer choice of words.

   Conflicting word choice
       use --invert and --errors to get  a  compendium  file  that  show  how  you  have  used  a
       translated  word  for  different English words. You might have chosen a word that is valid
       for both of the English expressions but that in  the  context  of  computers  would  cause
       confusion  for  the user.  You can now easily identify these words and make changes in the
       underlying translations.

Narrowing Results

       PO files treat slight changes in capitalisation, accelerator, punctuation  and  whitespace
       as  different  translations. In cases 2) and 3) above it is sometimes useful to remove the
       inconsistencies so that you can focus on the  errors  in  translation  not  on  shifts  in
       capitals.  To  this  end  you  can  use  the  following: --ignore-case, --strip-accel-amp,
       --strip-accel-tilde, --strip-accel-under.

OPERATION

       pocompendium makes use of the Gettext tool msgcat(1) to perform its task. It traverses the
       PO  directories  and  cat's  all found PO files into the single compendium output file. It
       then uses msgattrib(1) to extract only certain messages, msghack to  invert  messages  and
       msgfilter(1) to convert messages to lowercase.

BUGS

       There are some absolute/relative path name issues.

                                     Translate Toolkit 1.3.0                      pocompendium(1)