<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
	  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
	  <!ENTITY legal SYSTEM "legal.xml">
	  <!ENTITY appversion "2.0">
	  <!ENTITY manualversion "0.6">
	  <!ENTITY app "Gtranslator">
	  ]>
<!-- ================ Document Header ================= -->

<article id="index" lang="en">

  <articleinfo>
    <title>Gtranslator Manual</title>

    <copyright>
      <year>2008</year>
      <holder>Igalia</holder>
    </copyright>
    <copyright>
      <year>2001</year>
      <holder>Emese Kovacs</holder>
    </copyright>

    <!-- Translators: uncomment this
	 <copyright>
	   <year>2003</year>
	   <holder>ME_THE_TRANSLATOR</holder>
	 </copyright>
	 -->

    <publisher role="maintainer">
      <publishername>GNOME Documentation Project</publishername>
    </publisher>

    <releaseinfo>This is version &manualversion; of &app; manual.</releaseinfo>

    <legalnotice id="feedback">
      <title>Feedback Information</title>
      <para>
	To report a bug or make a suggestion regarding this
	application or this documentation, please see the
	<ulink type="help" url="ghelp:gnome-feedback">
	  GNOME Feedback Page
	</ulink>
      </para>
    </legalnotice>
    
    <authorgroup>
      <author>
	<firstname>Pablo</firstname>	
	<surname>Sanxiao</surname>
	<affiliation>
	  <orgname>Igalia</orgname>
	  <address>
	    <email>psanxiao@gmail.com</email>
	  </address>
	</affiliation>
      </author>
      <author>
	<firstname>Emese</firstname>
	<surname>Kovacs</surname>
	<affiliation>
	  <orgname>GNOME Documentation Project</orgname>
	  <address>
	    <email>emese@gnome.hu</email>
	  </address>
	</affiliation>
      </author>
    </authorgroup>

    <revhistory>
      <revision>
	<revnumber>&app; Manual V&manualversion;</revnumber>
	<date>September 2008</date>
	<revdescription>
	  <para role="author">Pablo Sanxiao</para>
	  <para role="publisher">
	    Igalia
	  </para>
	</revdescription>
      </revision>

      <revision>
	<revnumber>&app; Manual V&manualversion;</revnumber>
	<date>August 2003</date>
	<revdescription>
	  <para role="author">Abel Cheung</para>
	  <para role="publisher">
	    GNOME Documentation Project
	  </para>
	</revdescription>
      </revision>
      <revision>
	<revnumber>&app; Manual V0.4</revnumber>
	<date>August 2001</date>
	<revdescription>
	  <para role="author">Emese Kovacs</para>
	  <para role="publisher">
	    GNOME Documentation Project
	  </para>
	</revdescription>
      </revision>
    </revhistory>

    <abstract role="description">
      <para>&app; is an enhanced gettext PO file editor for the GNOME desktop environment.</para>
    </abstract>

  </articleinfo>
  
  <!-- ================ Document Body ================= -->

  <!-- ==== Introduction ====== -->

  <sect1 id="gtranslator-introduction">
    <title>Introduction</title>

    <para>
      <application>&app;</application> offers you a comfortable graphical
      interface to edit gettext PO files. It allows you to easily
      navigate among fuzzy, translated and untranslated messages and has
      a status bar displaying the number of messages for each category.
    </para>

    <para>
      <application>&app;</application> features opening and editing some PO 
      files at the same time including to manage their headers, seeing the
      developer's information for each message (comments, context) and set
      new personal comments.
    </para>

    <para>
      The profiles function allows you to have different <quote>accounts</quote>
      with the necessary information to fill the header. The option <quote>use my
      options to complete the following entries</quote> in the edit header dialog
      takes the information from the active profile in order to fill the header values.
    </para>

    <para>
      The new system of translation memories lets you use any translated PO files in
      order to create a database that will offer you suggestions how to translate the 
      current message.
    </para>

    <para>
     <application>&app;</application> provides a plugin system which makes it easily extending.
     It includes some useful plugins such as a svn plugin in that does the checkouts from
     the repository and commits the new translations. There are also plugins to visualize the
     source code where a message is located, to search in translation databases of web services
     like Open Tran and many others.
    </para>

    <para>
      To run <application>&app;</application>, select 
      <menuchoice>
	<guimenu>Programs</guimenu>
	<guisubmenu>Development</guisubmenu>
	<guimenuitem>&app;</guimenuitem>
      </menuchoice>
      from the <guimenu>Main Menu</guimenu>, or type
      <command>gtranslator</command> on the command line.
    </para>

  </sect1>

  <sect1 id="gtranslator-usage">
    <title>Using &app;</title>

    <para>
      <application>&app;</application> is a full
      featured graphical environment that makes it possible to
      translate PO files painlessly. This section describes basic
      usage of <application>&app;</application>.
    </para>

    <sect2 id="gtranslator-basic-usage">
      <title>Basic usage</title>

      <para>
	Starting <application>&app;</application> opens the 
	<interface>Main window</interface>.
      </para>

      <figure id="gtranslator-mainwindow-screenshot">
	<title>Main Window</title>
	<screenshot>
	  <mediaobject>
	    <imageobject>
	      <imagedata fileref="figures/mainwindow.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>&app; Main Window</phrase>
	    </textobject>
	  </mediaobject>
	</screenshot>
      </figure>

      <!--
	  <FIGURE FLOAT="0" id="MAINWINDOW-FIG">
            <title>Gtranslator Main Window</title>
            <SCREENSHOT>
              <SCREENINFO>Gtranslator Main Window</SCREENINFO>
              <GRAPHIC FILEREF="figures/mainwindow" FORMAT="PNG"
		       SRCCREDIT="emese"></GRAPHIC>
            </SCREENSHOT>
	  </FIGURE>
	  -->

      <para>
	The <interface>Main window</interface> is divided into three main areas:
	<itemizedlist>
	  <listitem>
	    <para>
	      The <interface>menubar</interface>
	      allows you the access the application menu.</para>
	  </listitem>
	  <listitem>
	    <para>
	      The <interface>toolbar</interface>
	      allow you quick access to frequently used file management,
	      navigation and compile functions.
	    </para>
	  </listitem>
	  <listitem>
	    <para>
	      The <interface>workspace</interface>
	      allows you to visualize and edit the messages contained
	      in the PO file. This area is divided further into three 
	      areas. At the top is the message area with all messages of
	      the PO file and its state. Below the message area on the left
	      the original message is shown and next to it is the text input
	      field into which one writes the translation. Finally, on the
	      right there is a panel with auxiliary information to help in the
	      translation process.
	    </para>
	  </listitem>
	</itemizedlist>
      </para>

      <sect3 id="gtranslator-configuration">
        <title>Configuration</title>
        <para>
          <application>&app;</application> settings can be modified by choosing
	  <menuchoice>
	    <guimenu>Edit</guimenu>
	    <guimenuitem>Preferences</guimenuitem>
	  </menuchoice>
	  menuitem.
	</para>
      </sect3>

      <sect3 id="gtranslator-loading-file">
	<title>Loading a PO file</title>

	<para>
	  To load a PO file, use the 
	  <menuchoice>
	    <guisubmenu>File</guisubmenu>
	    <guimenuitem>Open</guimenuitem>
	  </menuchoice>
	  menuitem. It will
	  bring up the <guilabel>Open file for translation</guilabel> dialog
	  box. Browse through your computer file system, choose the PO file
	  you wish to open and click <guibutton>OK</guibutton>.
	</para>

      </sect3>
      
      <sect3 id="gtranslator-edit-file">
        <title>Editing PO file</title>
        <para> 
	  The message area shows all the messages in the PO file and their state.
	  It is possible to go to one specific message by clicking on it directly.
	  You can also move through the messages with the 
	  <emphasis>forward</emphasis> and <emphasis>back</emphasis> buttons in
	  the toolbar. In the menu
	  using
	  <menuchoice>
	    <guisubmenu>Go</guisubmenu>
	    <guimenuitem>next fuzzy</guimenuitem>
	  </menuchoice>
	  and 
	  <menuchoice>
	    <guisubmenu>Go</guisubmenu>
	    <guimenuitem>previous fuzzy</guimenuitem>
	  </menuchoice>
	  it is possible to move directly among fuzzy messages and using
	  <menuchoice>
	    <guisubmenu>Go</guisubmenu>
	    <guimenuitem>next untranslated</guimenuitem>
	  </menuchoice>
	  and 
	  <menuchoice>
	    <guisubmenu>Go</guisubmenu>
	    <guimenuitem>previous untranslated</guimenuitem>
	  </menuchoice>
	  it is possible to move directly among untranslated messages.
	</para>

      </sect3>

      <sect3 id="gtranslator-save-file">
        <title>Saving PO file</title>
        <para>
	  When a PO file has been modified (in a message or in the header)
	  a <quote>*</quote> appears before its name in the window title or in the tab
	  if you are editing some PO files at the same time.
	</para>
	<para>
	  If you close the PO file at this moment, then the close dialog will be shown
	  to you with this aspect:
	</para>
	
	<figure id="gtranslator-closedialog-screenshot">
	  <title>Close Dialog</title>
	  <screenshot>
	    <mediaobject>
	      <imageobject>
		<imagedata fileref="figures/closedialog.png" format="PNG"/>
	      </imageobject>
	      <textobject>
		<phrase>&app; Close Dialog</phrase>
	      </textobject>
	    </mediaobject>
	  </screenshot>
	</figure>
	
      </sect3>
    </sect2>
    
    <sect2 id="gtranslator-advanced-feature">
      <title>Advanced features</title>
      <para>
	<application>&app;</application> offers to translator many features in
	order to do the translation process easier and more comfortable.
      </para>

      <sect3 id="gtranslator-advanced-profiles">
	<title>Profiles</title>
	<para> The profiles feature provides to translator the possibility of
	  having different <quote>accounts</quote> with individual basic information about
	  the translator and language settings.
	</para>
	<para>
	  There is always only one profile active at a time. You can
	  <guiicon>Add</guiicon>, <guiicon>Edit</guiicon> and
	  <guiicon>Remove</guiicon> accounts. When you save a PO file and
	  you have activated the option <quote>use my options to complete the following
	  entries</quote> in the header dialog, <application>&app;</application> will
	  fill the header fields with the information from the active profile.
	</para>
	
	<figure id="gtranslator-profiles-screenshot">
	  <title>Profiles Dialog</title>
	  <screenshot>
	    <mediaobject>
	      <imageobject>
		<imagedata fileref="figures/profiles.png" format="PNG"/>
	      </imageobject>
	      <textobject>
		<phrase>&app; Profiles Dialog</phrase>
	      </textobject>
	    </mediaobject>
	  </screenshot>
	</figure>
	
      </sect3>
      <sect3 id="gtranslator-advanced-translation_memory">
	<title>Translation Memory</title>
	
	<para>
	  The translation memory lets you reuse the translations. It is a database
	  that contains messages and their correspondent translation for a specific
	  language. 
	</para>
	
	<para>
	  <application>&app;</application> offers the possibility of creating translation
	  memories in two different ways. You can create the translation memory from a
	  directory that contains PO files (see <xref linkend="gtranslator-preferences"/>).
	  The program will create also a new entry in the translation memory each time that
	  you translate a new message.
	</para>
	
	<para>
	  The manner of using the translation memory it is very easy. With the translation
	  memory panel active (if it is not active go to 
	  <menuchoice>
	    <guisubmenu>View</guisubmenu>
	    <guimenuitem>Translation Memory</guimenuitem>
	  </menuchoice> 
	) you will can see the options that the translation memory offers you in order
	to translate the current message. If you can choose one of them, just use the keyboard
	accelerator associated to that option.
	</para>

	<figure id="gtranslator-tm-screenshot">
	  <title>Translation Memory</title>
	  <screenshot>
	    <mediaobject>
	      <imageobject>
		<imagedata fileref="figures/tm.png" format="PNG"/>
	      </imageobject>
	      <textobject>
		<phrase>&app; Translation Memory</phrase>
	      </textobject>
	    </mediaobject>
	  </screenshot>
	</figure>

	<para>
	  The level column shows you in percent how well each option matches the selected 
	  message. The options are sorted by how well they match.
	</para>
	
      </sect3>
      
    </sect2>
 
   <!-- ==================== Toolbar ====================== -->
    <sect2 id="gtranslator-toolbar">
      <title>Toolbar</title>
      
      <para>
	The toolbar provides access to several commonly used routines.
	It is easily customizable. You can add or remove buttons as follow:
      </para>
      
      <para>
	Go to
	<menuchoice>
	  <guimenu>Edit</guimenu>
	  <guimenuitem>Toolbar</guimenuitem>
	</menuchoice>.
	 The next dialog it will be showed you:
      </para>
      
      <figure id="gtranslator-toolbar-screenshot">
	<title>Tool Bar</title>
	<screenshot>
	  <mediaobject>
	    <imageobject>
	      <imagedata fileref="figures/toolbar.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>&app; Tool Bar</phrase>
	    </textobject>
	  </mediaobject>
	</screenshot>
      </figure>

      <para>
	You can add or remove buttons just drag and drop them between 
	the toolbar and the toolbar editor.
      </para>

      <sect3 id="gtranslator-toolbar-file">
	<title>File management buttons in the toolbar</title>

	<para>
	  The file management buttons lets you access frequently
	  used file management functions quickly.
	</para>
	<variablelist>
	  <varlistentry>
	    <term><guiicon>Open</guiicon></term>
	    <listitem>
	      <para>Brings up the <guilabel>Open file for translation</guilabel> dialog.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Save</guiicon></term>
	    <listitem>
	      <para>Saves the PO file.</para>
	    </listitem>
	  </varlistentry>
          <varlistentry>
	    <term><guiicon>Save as</guiicon></term>
	    <listitem>
	      <para>Saves the PO file under a different name.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Header</guiicon></term>
	    <listitem>
	      <para>
		Brings up the <guilabel>Edit Header</guilabel> dialog box
		with a form that lets you fill in the fields of the PO files
		header.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Undo</guiicon></term>
	    <listitem>
	      <para>Reverts your last action.</para>
	    </listitem>
	  </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="gtranslator-toolbar-navigation">
        <title>Navigation buttons in the toolbar</title>

        <para>
	  The navigation buttons allow you to navigate among
	  messages. They also let you search for strings, or
	  search and replace strings.
	</para> 

	<variablelist>
	  <varlistentry>
	    <term><guiicon>First</guiicon></term>
	    <listitem>
	      <para>Jumps to the first message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Last</guiicon></term>
	    <listitem>
	      <para>Jumps to the last message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Forward</guiicon></term>
	    <listitem>
	      <para>Jumps to the next message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Back</guiicon></term>
	    <listitem>
	      <para>Jumps to the previous message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Next Fuzzy</guiicon></term>
	    <listitem>
	      <para>Jumps to next fuzzy message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Previous Fuzzy</guiicon></term>
	    <listitem>
	      <para>Jumps to the previous fuzzy message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Next Untranslated</guiicon></term>
	    <listitem>
	      <para>Jumps to the next untranslated message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Previous Untranslated</guiicon></term>
	    <listitem>
	      <para>Jumps to the previous untranslated message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Next Fuzzy or Untranslated</guiicon></term>
	    <listitem>
	      <para>Jumps to the next fuzzy or untranslated message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Previous Fuzzy or Untranslated</guiicon></term>
	    <listitem>
	      <para>Jumps to the previous fuzzy or untranslated message.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Jump to</guiicon></term>
	    <listitem>
	      <para>Jumps to the specified message number.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Find</guiicon></term>
	    <listitem>
	      <para>
		Opens the <guilabel>Find</guilabel>
		dialog box. This dialog lets you search for strings
		in the PO file. You can choose to find strings
		inside original messages only, translated messages,
		comments or all of the above. 
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guiicon>Replace</guiicon></term>
	    <listitem>
	      <para>
		Opens the <guilabel>Replace</guilabel> dialog box.
		This dialog lets you enter a string to search for
		and a string to replace it with.
	      </para>
	    </listitem>
	  </varlistentry>
	</variablelist>
      </sect3>
    </sect2>


    <!-- ================ Menu bar ================= -->
    <sect2 id="gtranslator-menubar">
      <title>Menu Bar</title>

      <para>
	The menu bar, located at the top of the
	<guilabel>Main Window</guilabel>, contains the following menus:
      </para>

      <variablelist>

	<!-- ================ File menu ================= -->
	<varlistentry>

	  <term><guimenu>File</guimenu></term>

	  <listitem>
	    <para>This menu contains: 

	      <itemizedlist>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keycombo>
			  <keycap>Control</keycap><keycap>O</keycap>
			</keycombo>
		      </shortcut>
		      <guimenuitem>Open</guimenuitem>
		    </menuchoice>
		    This opens a PO file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>Recent Files</guimenuitem>
		    </menuchoice>
		    This shows a list of your recently opened PO files.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keycombo>
			  <keycap>Ctrl</keycap><keycap>S</keycap>
			</keycombo>
		      </shortcut>
		      <guimenuitem>Save</guimenuitem>
		    </menuchoice>
		    This saves your file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keycombo>
			  <keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>S</keycap>
			</keycombo>
		      </shortcut>
		      <guimenuitem>Save As</guimenuitem>
		    </menuchoice>
		    This saves your PO file under a different name.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keycombo>
			  <keycap>Ctrl</keycap><keycap>W</keycap>
			</keycombo>
		      </shortcut>
		      <guimenuitem>Close</guimenuitem>
		    </menuchoice>
		    This closes your file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keycombo>
			  <keycap>Ctrl</keycap><keycap>Q</keycap>
			</keycombo>
		      </shortcut>
		      <guimenuitem>Exit</guimenuitem>
		    </menuchoice>
		    This quits the application.
		  </para>
		</listitem>

              </itemizedlist>
            </para>
          </listitem>
	</varlistentry>

	<!-- ================ Edit menu ================= -->
	<varlistentry>
          <term><guimenu>Edit</guimenu></term>

	  <listitem>
            <para>This menu contains:</para> 
            <itemizedlist>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>Z</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Undo</guimenuitem>
		  </menuchoice>
		  This undoes your last change.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>X</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Cut</guimenuitem>
		  </menuchoice>
		  This removes any text or data which is selected and
		  places it in the buffer.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>C</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Copy</guimenuitem>
		  </menuchoice>
		  This copies any text or data which is selected into
		  the buffer.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>V</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Paste</guimenuitem>
		  </menuchoice>
		  This pastes any text or data
		  which is copied into the buffer.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <guimenuitem>Clear</guimenuitem>
		  </menuchoice>
		  This removes the selected text.
		</para>
	      </listitem>

	      <listitem>
		<para>
                  <guimenuitem>Header...</guimenuitem>
		  This opens a dialog box which allows you to edit
		  information stored in the PO file header.
		</para>
	      </listitem>

	      <listitem>
		<para>
                  <guimenuitem>Comment...</guimenuitem>
		  This allows to write a comment associates
		  to one message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>Space</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Copy Message to Translation</guimenuitem>
		  </menuchoice>
		  This pastes the text from the original message in the
		  translated message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <menuchoice>
		    <shortcut>
		      <keycombo>
			<keycap>Ctrl</keycap><keycap>U</keycap>
		      </keycombo>
		    </shortcut>
		    <guimenuitem>Toggle Fuzzy Status</guimenuitem>
		  </menuchoice>
		  This toggles the current message fuzzy status.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Translation memory</guimenuitem>
		  This shows the options in the translation memory 
		  for the current message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Toolbar</guimenuitem>
		  This opens the <guilabel>Toolbar Editor</guilabel>.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Preferences</guimenuitem>
		  This opens the <guilabel>Preferences</guilabel> dialog.
		</para>
	      </listitem>

	    </itemizedlist>
	  </listitem>
	</varlistentry>

	<!-- ================ View menu ================= -->
	<varlistentry>
	  <term><guimenu>View</guimenu></term>
	  <listitem>
	    <para>This menu contains:</para> 

	    <itemizedlist>

	      <listitem>
                <para>
		  <guisubmenu>Context</guisubmenu>
		  This shows or hides the context panel. 
		</para>
	      </listitem>

	      <listitem>
                <para>
		  <guisubmenu>Translation Memory</guisubmenu>
		  This shows or hides the translation memory panel. 
		</para>
	      </listitem>

            </itemizedlist>
          </listitem>
        </varlistentry>

	<!-- ================ Go menu ================= -->
	<varlistentry>
	  <term><guimenu>Go</guimenu></term>
	  <listitem>
	    <para>This menu contains:</para>

	    <itemizedlist>

	      <listitem>
		<para>
		  <guimenuitem>First</guimenuitem>
		  Go to the first message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Back</guimenuitem>
		  Go to the previous message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Next</guimenuitem>
		  Go to the next message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Last</guimenuitem>
		  Go to the last message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Next fuzzy</guimenuitem>
		  Go to the next fuzzy message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Previous fuzzy</guimenuitem>
		  Go to the previous fuzzy message.
		</para>
	      </listitem>
	     
	      <listitem>
		<para>
		  <guimenuitem>Next untranslated</guimenuitem>
		  Go to the next untranslated message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Previous untranslated</guimenuitem>
		  Go to the previous untranslated message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Next fuzzy or untranslated</guimenuitem>
		  Go to the next fuzzy or untranslated message.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>Previous fuzzy or untranslated</guimenuitem>
		  Go to the previous fuzzy or untranslated message.
		</para>
	      </listitem>

		<listitem>
		<para>
		  <guimenuitem>Jump to</guimenuitem>
		  Go to the message with a specific number.
		</para>
	      </listitem>

	    </itemizedlist>
	  </listitem>
	</varlistentry>

	<!-- ================ Search menu ================= -->
	<varlistentry>
	  <term><guimenu>Search</guimenu></term>
	  <listitem>
	    <para>This menu contains:</para> 

	    <itemizedlist>

	      <listitem>
		<para>
		  <guimenuitem>Find</guimenuitem>
		  This command opens the 
                  <guilabel>Find</guilabel> dialog.
		</para>
	      </listitem>
	   
	      <listitem>
		<para>
		  <guimenuitem>Replace</guimenuitem>
		  This opens the <guilabel>Replace</guilabel> dialog.
		</para>
	      </listitem>

            </itemizedlist>
          </listitem>
        </varlistentry>

	<!-- ================ Help menu ================= -->
	<varlistentry>
	  <term><guimenu>Help</guimenu></term>
	  <listitem>
	    <para>This menu contains:</para>
	    <itemizedlist>

	      <listitem>
		<para>
		  <guimenuitem>Contents</guimenuitem>
		  This opens the 
                  <application>GNOME Help Browser</application>
		  (or <application>Nautilus</application>)
		  and displays this manual.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>&app; website</guimenuitem>
		  This opens the <application>&app;</application> webpage.
		</para>
	      </listitem>

	      <listitem>
		<para>
		  <guimenuitem>About</guimenuitem>
		  This opens the <guilabel>About</guilabel> dialog
		  which shows basic information about 
		  <application>&app;</application>, such as author
		  name, the application version number, and the URL
		  for the application web page.
		</para>
	      </listitem>

	    </itemizedlist>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2> 
    <!-- ================ end of Menu bar ================= -->


    <sect2 id="gtranslator-commandline-option">
      <title>Available command line options</title>
      <para>
	<application>&app;</application> understands a number of
	command line options:
      </para>
      
      <variablelist>

	<varlistentry>
          <term><varname>--help</varname></term>
          <listitem>
	    <para>
	      Shows you a short help message on the command line.
	    </para>
	  </listitem>
	</varlistentry>

      </variablelist>
    </sect2>
  </sect1>
  <!-- ========== end of Using gtranslator ========== -->


  <!-- ============= Customization ============ -->
  <sect1 id="gtranslator-preferences">
    <title>Customization</title>
    <para>
      To change the application settings, select 
      <menuchoice>
	<guimenu>Edit</guimenu>
	<guimenuitem>Preferences</guimenuitem>
      </menuchoice>. This opens the 
      <interface>Preferences</interface> dialog.
    </para>

    <figure id="gtranslator-preferences-screenshot">
      <title>Preferences Dialog</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/prefs.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app; Preferences Dialog</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
    </figure>

    <sect2 id="gtranslator-prefs-file">
      <title>File Tab</title>
      
      <para>
	The properties in the 
	<guilabel>File</guilabel> tab are: 
      </para>
      
      <variablelist>
	<varlistentry>
	  <term><guilabel>Autosave files every x minutes</guilabel></term>
	  <listitem>
	    <para>
	      This option determines how often <application>&app;</application> must 
	      save the current file.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Create a backup copy of files before saving</guilabel></term>
	  <listitem>
	    <para>
	      If this option is activated, a backup copy of the current files is created
	      before saving them. If <application>&app;</application> crashes while saving,
	      the files can be restored with the backup copies.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>
      
    </sect2>
    
    <sect2 id="gtranslator-prefs-editor">
      <title>Editor Tab</title>

      <para>
	The properties in the 
	<guilabel>Editor</guilabel> tab are: 
      </para>
      
      <figure id="gtranslator-preferences-editor">
      <title>Editor Tab</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/prefs-editor.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app; Editor Tab</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
      </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Highlight message syntax</guilabel></term>
	  <listitem>
	    <para>
	      This option activates syntax highlighting in the
	      original and translated message boxes.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Make whitespace visible</guilabel></term>
	  <listitem>
	    <para>
	      With this option actived whitespaces in the original and
	      translated message boxes are shown as dots.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Use custom font</guilabel></term>
	  <listitem>
	    <para>
	      This option lets you set a custom font for the original and
	      translated message boxes.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Remove fuzzy status if message is changed</guilabel></term>
	  <listitem>
	    <para>
	      If this option is active the status will change automatically if
	      you edit a message.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Check spelling</guilabel></term>
	  <listitem>
	    <para>
	      This option enables the spell-checking for your language in
	      the original and translated message boxes.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>
      
    </sect2>

    <sect2 id="gtranslator-prefs-profiles">
      <title>Profiles Tab</title>

      <para>
	The 
	 <guilabel>Editor</guilabel> tab contains: 
      </para>
      
      <figure id="gtranslator-preferences-profiles">
      <title>Profiles Tab</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/profiles.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app; Profiles Tab</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
      </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Add button</guilabel></term>
	  <listitem>
	    <para>
	      Shows the <guilabel>Profile</guilabel> dialog in order to
	      create a new profile.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Edit button</guilabel></term>
	  <listitem>
	    <para>
	      Shows the <guilabel>Profile</guilabel> dialog in order to
	      edit an exists profile.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Delete button</guilabel></term>
	  <listitem>
	    <para>
	      Removes the selected profile.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>

     <para>
       The entries in the <guilabel>Profiles</guilabel> dialog are:
     </para>

      <figure id="gtranslator-profiles-dialog">
      <title>Profiles Dialog</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/profiles-dialog.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app;Profiles Dialog</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
      </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Profile Name</guilabel></term>
	  <listitem>
	    <para>
	      It is the name of the profile. It identifies the profile and
	      must be unique.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Translator Name</guilabel></term>
	  <listitem>
	    <para>
	      This is the name of the translator to fill the value in the header.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Translator Email</guilabel></term>
	  <listitem>
	    <para>
	      This is the email address of the translator to fill the value in the
	      header.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Language</guilabel></term>
	  <listitem>
	    <para>
	      The name of the language into which the translations will be done.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Language Code</guilabel></term>
	  <listitem>
	    <para>
	      This is the ISO 639-2 language code used for the language 
	      chosen above. The name of the PO file will be based on this setting.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Character Set</guilabel></term>
	  <listitem>
	    <para>
	      This is the character set for the PO files. Gnome 2.x uses UTF-8
	      encoding for all languages.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Transfer Encoding</guilabel></term>
	  <listitem>
	    <para>
	      This is the encoding used to store the PO file.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Team Email</guilabel></term>
	  <listitem>
	    <para>
	      This is the email address of the language team.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Plural Forms</guilabel></term>
	  <listitem>
	    <para>
	      Information about the plural forms in the PO files.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>
      
    </sect2>

    <sect2 id="gtranslator-prefs-interface">
      <title>Interface Tab</title>
      
      <para>
	The 
	<guilabel>Interface</guilabel> tab contains: 
      </para>
      
      <figure id="gtranslator-preferences-interface">
      <title>Interface Tab</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/prefs-interface.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app;Interface Tab</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
      </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Anchor Style</guilabel></term>
	  <listitem>
	    <para>
	      Lets you choose if you want to see only icons in the toolbar,
	      icons with text or use the Gnome preferences.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Scheme Color</guilabel></term>
	  <listitem>
	    <para>
	      This is the scheme color in the original and translated boxes.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>

    </sect2>

    <sect2 id="gtranslator-prefs-tm">
      <title>Translation Memory Tab</title>

      <para>
	The 
	 <guilabel>Translation Memory</guilabel> tab contains: 
      </para>
      
      <figure id="gtranslator-preferences-tm">
      <title>Translation Memory Tab</title>
      <screenshot>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/prefs-tm.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>&app;Translation Memory Tab</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
      </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Show options in translated messages</guilabel></term>
	  <listitem>
	    <para>
	      With this option activated <application>&app;</application> shows you
	      the translation memory options for all messages including the
	      translated ones. If it is not active options are ony shown for
	      fuzzy and untranslated messages.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Use only files with this name</guilabel></term>
	  <listitem>
	    <para>
	      If this option is used the translation memory will be created
	      only using the files with this name into the directory selected.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Max # of missing words</guilabel></term>
	  <listitem>
	    <para>
	      Maximum number of words that can be missing from a message displayed 
	      as a match by the translation memory.
	    </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Max difference in sentence length</guilabel></term>
	  <listitem>
	    <para>
	      Maximum difference in length between messages displayed as matches
              by the translation memory.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>

    </sect2>

    <sect2 id="gtranslator-prefs-plugins">
      <title>Plugins Tab</title>
      <para></para>
    </sect2>

  </sect1>


  <!-- ================ Bugs ================= -->
  <sect1 id="gtranslator-bugs">
    <title>Known Bugs and Limitations</title>
    <para>
      You can query for bugs related to 
      <application>&app;</application> in the 
      <ulink url="http://bugzilla.gnome.org">
	GNOME bug tracking database.
      </ulink>.
    </para>
  </sect1>


  <!-- ================ Authors ================= -->
  <sect1 id="gtranslator-authors">
    <title>Authors</title>

    <sect2 id="gtranslator-application-authors">
      <title>Application Authors</title>
      
      <para>
	<application>&app;</application> was written originally by Fatih Demir <email>kabalak@kabalak.net</email> and Gediminas Paulauskas <email>menesis@kabalak.net</email>.
	Ross Golder <email>rossg@golder.org</email> was the maintainer of GTK+ 2.x port of &app; until October 2007.
      </para>
      
      <para>
	Most of the new version 2.0 was written by Pablo Sanxiao <email>psanxiao@gmail.com</email> and Ignacio Casal Quinteiro <email>nacho.resa@gmail.com</email>. The current maintainers are Pablo Sanxiao and Juan José Sánchez Penas 
	<email>jjsanchez@igalia.com</email>.
      </para>

      <para>
	To find more information about <application>&app;</application>, please visit the 
	<ulink url="http://gtranslator.sourceforge.net" type="http">Gtranslator Web page</ulink>.
	Please send all comments, suggestions, and bug reports to the
	<ulink url="http://bugzilla.gnome.org" type="http">GNOME bug tracking database</ulink>.
	(Instructions for submitting bug reports can be found
	<ulink url="http://bugzilla.gnome.org/Reporting.html" type="http">on-line</ulink>.)
	You can also use <application>Bug Report Tool</application>
	(<command>bug-buddy</command>), available in the
	<menuchoice>
	  <guimenu>Application</guimenu>
	  <guisubmenu>Development</guisubmenu>
	</menuchoice> menu,
	for submitting bug reports.
      </para>
    </sect2>


    <sect2 id="gtranslator-contributor">
      <title>Contributors</title>
      <para>
	People who have contributed to the &app; project:
      </para>

      <itemizedlist>
	<listitem>
	  <para>
	    Seán de Búrca 
	    <email>leftmostcat@gmail.co</email>
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Thomas Ziehmer <email>thomas@kabalak.net</email>
	    for the find dialog implementation.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <emphasis>All</emphasis> translators of 
	    <application>&app;</application>.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    The GNOME I18N mailing list
	    <email>gnome-i18n@gnome.org</email>
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Alexandre Hautequest 
	    <email>hquest@fesppr.br</email>
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Denis Plei&#x107;
	    <email>dpleic@linux.hr</email>
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Josh Jackson
	    <email>pturing@mailandnews.com</email>
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Robert Brady
	    <email>robert@suse.co.uk</email>
	  </para>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="gtranslator-packagers">
      <title>Packagers</title>

      <para>
	We would want to thank those persons for providing
	packages in the corresponding formats of <application>&app;</application>. 
      </para>

      <itemizedlist>
	<listitem>
	  <para>
	    Josh Jackshon <email>pturing@mailandnews.com</email> for
	    his Mandrake packages of <application>&app;</application> 0.34
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Mike Newman <email>mike@gtnorthern.demon.co.uk</email> for
	    his RH7 (S)RPMs of <application>&app;</application>.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Martijn van de Streek <email>martijn@foodfight.org</email> for
	    his Debian packages of <application>&app;</application>.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Maxim Sobolev <email>sobomax@freebsd.org</email> for his
	    FreeBSD ports of <application>&app;</application>.
	  </para>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="gtranslator-document-author">
      <title>Documentation Authors</title>
      <para>
	This manual was written by Pablo Sanxiao (<email>psanxiao@gmail.com</email>) based on the
	last version of the manual written by Emese Kovacs (<email>emese@gnome.hu</email>). 
	Please send all comments and suggestions regarding this manual to the 
	<ulink url="http://developer.gnome.org/projects/gdp" type="http">
	  GNOME Documentation Project
	</ulink>
	by sending an email to 
	<email>docs@gnome.org</email>.
	You can also add your comments online by using the 
	<ulink url="http://developer.gnome.org/projects/gdp/doctable/" type="http">
	  GNOME Documentation Status Table
	</ulink>.
      </para>
    </sect2>
  </sect1>

  <!-- ================ Application License ================= -->
  <sect1 id="gtranslator-license">
    <title>License</title>
    <para>
      This program is free software; you can redistribute
      it and/or modify it under the terms of the 
      <ulink type="help" url="gnome-help:gpl">
	<citetitle>GNU General Public License</citetitle>
      </ulink>
      as published by the Free Software Foundation; either 
      version 2 of the License, of (at your option) any later
      version.
    </para>
    <para>
      This program is distributed in the hope that it will be
      useful, but WITHOUT ANY WARRANTY; without even the
      implied warranty of MERCHANTABILITY or FITNESS FOR A 
      PARTICULAR PURPOSE. See the
      <citetitle>GNU General Public License</citetitle>
      for more details.
    </para>
    <para>
      A copy of the 
      <citetitle>GNU General Public License</citetitle>
      is included as an appendix to the 
      <citetitle>GNOME Users Guide</citetitle>
      . You may also obtain a copy of the 
      <citetitle>GNU General Public License</citetitle>
      from the Free Software Foundation by visiting
      <ulink type="http" url="http://www.fsf.org">
	their Web site
      </ulink>
      or by writing to 
      <address>Free Software Foundation, Inc.
	<street>59 Temple Place</street> - Suite 330
	<city>Boston</city>,
	<state>MA</state>
	<postcode>02111-1307</postcode>
	<country>USA</country>
      </address>
    </para>
  </sect1>


  <!--   <sect1 id="gtranslator-glossary"> -->
  <!--     <title>Glossary</title> -->
  <!--     <para> -->
  <!--       <variablelist> -->
  <!--         <varlistentry> -->
  <!--           <term> -->
  <!--             <command>gettext</command> -->
  <!--           </term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>po file</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>internationalization</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>localization</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>l10n</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>i18n</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>translation memory</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>ISO 3166 coutry code</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>ISO 639-2 language code</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>default query domain</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>charset</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>encoding</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--         <varlistentry> -->
  <!--           <term>URI</term> -->
  <!--           <listitem> -->
  <!--             <para></para> -->
  <!--           </listitem> -->
  <!--         </varlistentry> -->
  <!--       </variablelist> -->
  <!--     </para> -->
  <!--   </sect1> -->
</article>
