<chapter id="using-catalogmanager">
<title>Using &catalogmanager;</title>
<anchor id="catalogmanager"/>

<screenshot>
<screeninfo>Screenshot of &catalogmanager;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="snap_catalogmanager.png" format="PNG"/>
</imageobject>
<textobject><phrase>Screenshot of &catalogmanager;</phrase></textobject>
</mediaobject>
</screenshot>
<para>
The Catalog Manager merges two directories into one tree and displays
all the PO- and POT-files in these directories.  The display allows
you to easily see if a new template has been added or an old one
has been removed.  Some information is shown along with each file
name: total number of entries, number of fuzzy entries,
number of untranslated entries, the date of the last revision and the
last translator of the file.
</para>
<para>
To make it easier for you to find files that need work or are
missing the status of each file is also displayed using an icon:
</para>

<itemizedlist>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_ok.png" format="PNG"/>
</imageobject>
</inlinemediaobject> All the messages in this file are translated.</para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_needwork.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
Some of the messages in this file are fuzzy or untranslated
      </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_missing.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
This file does not exist in the directory of the <acronym>PO</acronym> files.
      </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_broken.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
This file contains syntax errors.
      </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_reload.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
Information about this file is being currently updated. When the update is
finished, it will get one of the icons listed above to reflect its state.
      </para>
   </listitem>
</itemizedlist>

<para>
If an icon is marked with this icon
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_nopot.png" format="PNG"/>
</imageobject>
</inlinemediaobject>, like
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_nopot_ok.png" format="PNG"/>
</imageobject>
</inlinemediaobject>,
it indicates that this file or directory does not exist in the
directory of the <acronym>POT</acronym> files.</para>

<para> You can mark or unmark a file by selecting <guimenuitem>Toggle
Marking</guimenuitem> in the context menu of a file.</para>

<para>If you want to toggle or remove all markings in a directory,
press the right mouse button over the directory and select
<guimenuitem>Toggle Markings</guimenuitem> or <guimenuitem>Remove
Markings</guimenuitem>.  The markings are automatically saved when
leaving &kbabel;.</para>

<para>To open a file either double-click on the file, select
<menuchoice><guimenuitem>Open</guimenuitem></menuchoice> from the
context menu or press either <keycap>Return</keycap> or <keycombo
action="simul">&Ctrl;<keycap>O</keycap> </keycombo>.</para>

<para>You can configure the &catalogmanager; by
<menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure &catalogmanager;...</guimenuitem></menuchoice>.
See section <link linkend="preferences-catalogmanager">Preferences</link> for more
details.</para>

<sect1 id="catman-features">
<title>&catalogmanager; Features</title>
<para>
Besides the main feature for opening the files in &kbabel; &catalogmanager;
supports number of other features for maintaining a tree of
<acronym>PO</acronym>-files.
</para>

<sect2 id="catman-find">
<title>Find and replace in multiple files</title>
<para>
One of the most requested features for &kbabel; was a possibility to search and replace in
multiple files at once. &catalogmanager; supports this feature with
a tight integration with &kbabel;
</para>
</sect2>

<sect2 id="catman-statistics">
<title>Statistics</title>
<para>
&catalogmanager; can show you a number of statistics about a single file
or about the whole directories. The statistics contain number of files,
how many of the files have their templates, how many are templates missing.
It also counts number of messages in the files and shows statistics about
how large parts of the messages are translated, fuzzy-translated or
untranslated.
</para>
</sect2>

<sect2 id="catman-syntax">
<title>Checking the syntax</title>
<para>
This allows you to check the syntax of multiple <acronym>PO</acronym>-files
using <command>msgfmt</command>. If a file fails this check, it cannot
be used for generating a <acronym>MO</acronym>-file for binary distribution.
Such an incorrect file will typically result in failing compilation of the package
the <acronym>PO</acronym>-file belongs to.
</para>
</sect2>

<sect2 id="catman-commands">
<title>User-defined commands</title>
<para>
Because &catalogmanager; cannot provide any functionality you would like
to use, you can extend it by defining your own commands.
</para>
<para>
There are two sets of commands. One for directories and one for single files.
You can set them in <link linkend="preferences-catalogmanager">configuration dialog
</link> and access by pressing right mouse button on an entry in the file list.
</para>
</sect2>

</sect1>
</chapter>