<?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 author "Uwe Scholz">
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "1.17.0">
  <!ENTITY manrevision "1.17.0">
  <!ENTITY date "??? 2023">
  <!ENTITY app "GNOME Commander">
]>
<!-- Information about the entities
       The legal.xml file contains legal information, there is no need to edit the file.
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the app entity to specify the name of the application. -->
<!--
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <articleinfo>
    <title>&app; Manual</title>
    <subtitle>&app; Desktop Application Manual V&manrevision;</subtitle>
    <copyright>
      <year>2012</year>
      <year>2011</year>
      <year>2010</year>
      <year>2009</year>
      <year>2008</year>
      <year>2007</year>
      <year>2006</year>
      <holder>Piotr Eljasiak</holder>
    </copyright>
    <copyright>
      <year>2023</year>
      <year>2022</year>
      <year>2021</year>
      <year>2020</year>
      <year>2019</year>
      <year>2018</year>
      <year>2017</year>
      <year>2016</year>
      <year>2015</year>
      <year>2014</year>
      <year>2013</year>
      <holder>Uwe Scholz</holder>
    </copyright>
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
   -->

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

    <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

    <authorgroup>
      <author>
        <firstname>GNOME Documentation Project</firstname>
        <surname/>
        <affiliation>
          <orgname>GNOME</orgname>
        </affiliation>
      </author>
      <author>
        <firstname>Piotr</firstname>
        <surname>Eljasiak</surname>
      </author>
      <author>
        <firstname>Laurent</firstname>
        <surname>Coudeur</surname>
      </author>
      <author>
        <firstname>Uwe</firstname>
        <surname>Scholz</surname>
      </author>


<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname>
	<surname>Translator 1</surname>
	<affiliation>
	  <orgname>Latin Translation Team</orgname>
	  <address> <email>translator@gnome.org</email> </address>
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
</authorgroup>

   <!-- This file  contains link to license for the documentation (GNU FDL), and
        other legal stuff such as "NO WARRANTY" statement. Please do not change
    any of this. -->

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->
    <revhistory>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.3;</revnumber>
        <date>2006-12-11</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.4;</revnumber>
        <date>2007-06-09</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.5;</revnumber>
        <date>2008-02-29</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.6;</revnumber>
        <date>2008-06-01</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.7;</revnumber>
        <date>2008-07-28</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8;</revnumber>
        <date>2009-06-29</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.1;</revnumber>
        <date>2009-08-10</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.2;</revnumber>
        <date>2009-09-22</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.3;</revnumber>
        <date>2009-10-28</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.4;</revnumber>
        <date>2009-12-03</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.5;</revnumber>
        <date>2010-02-13</date>
        <revdescription>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.6;</revnumber>
        <date>2010-06-01</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.7;</revnumber>
        <date>2010-07-27</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.8;</revnumber>
        <date>2010-09-09</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.9;</revnumber>
        <date>2010-12-03</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.10;</revnumber>
        <date>2011-01-15</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.11;</revnumber>
        <date>2011-05-01</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.12;</revnumber>
        <date>2011-06-15</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.13;</revnumber>
        <date>2011-08-06</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.14;</revnumber>
        <date>2011-10-04</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.2.8.15;</revnumber>
        <date>2011-12-06</date>
        <revdescription>
            <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email>
            </para>
            <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4;</revnumber>
        <date>2014-03-17</date>
        <revdescription>
          <para role="author">Laurent Coudeur
                <email>laurentc@iol.ie</email></para>
          <para role="publisher">GNOME Documentation Project</para>
          <para role="author">Piotr Eljasiak
                <email>epiotr@cvs.gnome.org</email></para>
          <para role="publisher">GNOME Documentation Project</para>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.1;</revnumber>
        <date>2014-04-05</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.2;</revnumber>
        <date>2014-05-23</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.3;</revnumber>
        <date>2014-06-22</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.4;</revnumber>
        <date>2014-11-11</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.5;</revnumber>
        <date>2015-01-24</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.6;</revnumber>
        <date>2015-05-19</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.7;</revnumber>
        <date>2014-05-30</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.4.8;</revnumber>
        <date>2016-03-14</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.6.0;</revnumber>
        <date>2016-10-04</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.6.1;</revnumber>
        <date>2016-10-18</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.6.2;</revnumber>
        <date>2016-11-06</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.6.3;</revnumber>
        <date>2017-02-26</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.6.4;</revnumber>
        <date>2017-05-28</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.8.0;</revnumber>
        <date>2017-08-10</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.8.1;</revnumber>
        <date>2018-03-04</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.10.0;</revnumber>
        <date>2019-03-31</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.10.1;</revnumber>
        <date>2019-05-12</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.10.2;</revnumber>
        <date>2019-05-16</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
       <revision>
        <revnumber>GNOME Commander Manual V1.10.3;</revnumber>
        <date>2020-06-19</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.12.0;</revnumber>
        <date>2021-03-25</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.12.1;</revnumber>
        <date>2021-04-17</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.12.2;</revnumber>
        <date>2021-05-29</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.12.3;</revnumber>
        <date>2021-11-20</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.12.3.1;</revnumber>
        <date>2021-11-21</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.14.0;</revnumber>
        <date>2022-02-05</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.14.1;</revnumber>
        <date>2022-03-01</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.14.2;</revnumber>
        <date>2022-03-27</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.14.3;</revnumber>
        <date>2022-06-18</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.16.0;</revnumber>
        <date>2023-01-22</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>GNOME Commander Manual V1.17.0;</revnumber>
        <date>2023-12-31</date>
        <revdescription>
          <para role="author">Uwe Scholz
                <email>u.scholz83@gmx.de</email></para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
    </revhistory>
    <releaseinfo>This manual describes version &appversion; of &app;. </releaseinfo>
    <legalnotice>
      <title>Feedback</title>
      <para>You can report or view &app; bugs at <ulink type="http" url="https://gitlab.gnome.org/GNOME/gnome-commander/issues">gitlab.gnome.org</ulink>.</para>

<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
    <abstract role="description">
      <para>&app; is a lightweight and fast file manager for the GNOME desktop.</para>
    </abstract>
  </articleinfo>
  <indexterm zone="index">
    <primary>gnome-commander</primary>
  </indexterm>
  <indexterm zone="index">
    <primary>file manager</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what the application is and what it does. -->
  <sect1 id="gnome-commander-introduction">
    <title>Introduction</title>
    <para>The &app; application is a fast and powerful graphical file manager for the GNOME desktop environment,
    it has a &quot;two-pane&quot; interface based on the orthodox file manager (OFM) principle,
    in the tradition of Norton and Midnight Commander.

    &app; provides the following features:</para>
    <itemizedlist>
      <listitem>
        <para>GTK-2 GUI with standard mouse interactions</para>
      </listitem>
      <listitem>
        <para>Support for tabs</para>
      </listitem>
      <listitem>
        <para>One instance mode</para>
      </listitem>
      <listitem>
        <para>Remote connections using GVFS: FTP, SFTP (SSH+FTP), WebDAV and SMB/CIFS (Samba)</para>
      </listitem>
      <listitem>
        <para>Right click mouse menu</para>
      </listitem>
      <listitem>
        <para>User defined context menu</para>
      </listitem>
      <listitem>
        <para>Quick device access buttons with automatic mounting and unmounting</para>
      </listitem>
      <listitem>
        <para>History of accessed locations</para>
      </listitem>
      <listitem>
        <para>Folder bookmarks</para>
      </listitem>
      <listitem>
        <para>User defined keyboard shortcuts</para>
      </listitem>
      <listitem>
        <para>Plugin support</para>
      </listitem>
      <listitem>
        <para>Fast internal file viewer for text and images</para>
      </listitem>
      <listitem>
        <para>Meta data support for Exif, IPTC, ID3, Vorbis, FLAC, APE, OLE2, ODF and PDF tags</para>
      </listitem>
      <listitem>
        <para>Tools for advanced batch renaming of files, searching, quick file name searching in current directory,
                symlinking, comparing directories</para>
      </listitem>
      <listitem>
        <para>Integrated command line</para>
      </listitem>
      <listitem>
        <para>Color profiles</para>
      </listitem>
      <listitem>
        <para>Support for over 40 languages</para>
      </listitem>
    </itemizedlist>
    <note>
      <para>If you are using code from git repository, it is possible that the latest new features are not yet in
        this manual. Please read the
        <ulink type="http" url="https://gitlab.gnome.org/GNOME/gnome-commander/-/commits/master">detailed ChangeLog
        online</ulink> or in the &app; sources to find out more about the new features.
      </para>
    </note>
  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here.
     If the information about how to get started is very short, you can
     include it in the Introduction and omit this section. -->
  <sect1 id="gnome-commander-getting-started">
    <title>Getting Started</title>
    <sect2 id="gnome-commander-start">
      <title>To Start &app;</title>
      <para>You can start &app; in the following ways:
    </para>
    <variablelist>
    <varlistentry>
        <term><guimenu>Applications</guimenu> menu</term>
        <listitem>
        <para>Choose
        <menuchoice>
        <guisubmenu>Accessories</guisubmenu>
        <guimenuitem>&app;</guimenuitem>
        </menuchoice>.</para>
        </listitem>
    </varlistentry>
    <varlistentry>
        <term>Command line</term>
        <listitem>
        <para>To start &app; from a command line, type the following command,
        then press <keycap>Return</keycap>:</para>
        <para>
            <command>gnome-commander</command>
        </para>
        </listitem>
    </varlistentry>
    </variablelist>
    </sect2>

    <sect2 id="gnome-commander-when-start">
      <title>When You Start &app;</title>
      <para>When you start &app;, the following window is displayed.</para>
      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig">
        <title>&app; Window</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_window.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and scrollbars.
              	Menubar contains File, View, Settings, and Help menus.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
<!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
<!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
      <para>The &app; window contains the following elements:</para>
      <variablelist>
        <varlistentry>
          <term>Menubar.</term>
          <listitem>
            <para>The menus on the menubar contain all of the commands you need to work with files in &app;.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Toolbar. </term>
          <listitem>
            <para> The toolbar contains a subset of the commands that you can access from the menubar.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Statusbar.</term>
          <listitem>
            <para>The statusbar displays information about current &app; activity and contextual information about
            	the menu items.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
    <sect2 id="gnome-commander-command-line">
      <title>Command Line Options</title>
      <variablelist>
        <varlistentry>
          <term><guilabel>Options</guilabel></term>
          <listitem>
            <itemizedlist>
              <listitem>
                <para>
                  <guilabel>--help</guilabel>
                </para>
                <para>Show summary of options.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>--version</guilabel>
                </para>
                <para>Show version of &app;.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>-l, --start-left-dir=STRING</guilabel>
                </para>
                <para>Specify the start directory for the left pane.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>-r, --start-right-dir=STRING</guilabel>
                </para>
                <para>Specify the start directory for the right pane.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>--config-dir=STRING</guilabel>
                </para>
                <para>Specify the directory for configuration files.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>-d, --debug=STRING</guilabel>
                </para>
                <para>Specify debug flags to use. Debug output will be written to stdout.</para>
                <para>Possible flags:</para>
                <itemizedlist>
                  <listitem>
                    <para><guilabel>a</guilabel> set all debug flags</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>c</guilabel> file and directory counting</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>d</guilabel> directory ref-counting</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>f</guilabel> file ref-counting</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>g</guilabel> run_command debugging</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>i</guilabel> image loader</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>k</guilabel> directory pool</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>l</guilabel> directory listings</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>m</guilabel> connection debugging</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>n</guilabel> directory monitoring</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>p</guilabel> python plugins</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>s</guilabel> SMB network browser</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>t</guilabel> metadata tags</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>u</guilabel> user actions debugging</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>v</guilabel> internal viewer</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>w</guilabel> widget_lookup</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>x</guilabel> xfer</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>y</guilabel> brief MIME based imageload</para>
                  </listitem>
                  <listitem>
                    <para><guilabel>z</guilabel> detailed MIME based imageload</para>
                  </listitem>
                </itemizedlist>
              </listitem>
              <listitem>
                <para>
                  <guilabel>[gtk,gnome,bonobo options]</guilabel>
                </para>
                <para>Standard gtk, gnome, bonobo options are supported. Use <guilabel>--help</guilabel> to see possible options.
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <guilabel>Examples</guilabel>
          </term>
          <listitem>
            <para>
              <command>gnome-commander <option>-d nvl</option></command>
            </para>
            <para>
                Starts &app; with debugging of directory listings, internal viewer and directory monitoring
                facilities.
              </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

<!-- ================ Basic Usage ========================== -->
<!-- Use this section to describe how to use the application to perform the tasks for
  which the application is designed. -->
  <sect1 id="gnome-commander-usage">
    <title>Basic Usage</title>
    <!-- ================ Selecting Files Subsection ======================= -->
    <sect2 id="gnome-commander-select">
        <title>Selecting Files and Folders</title>
        <para>You can select files and folders in several ways in &app;. Typically this is achieved by clicking on the files using the mouse, as explained in <xref linkend="gcmd-TBL-10"/>.</para>
      <table frame="topbot" id="gcmd-TBL-10">
        <title>Selecting Items in the File Manager</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="36.36*"/>
          <colspec colname="colspec2" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Task</para>
              </entry>
              <entry colname="colspec2">
                <para>Action</para>
              </entry>
              <entry colname="colspec3">
                <para>Default key bindings</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select an item</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Click on the item.</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>SPACE</keycap></keycombo></para>
                <para><keycombo><keycap>INSERT</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select a group of contiguous items</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>In icon view, drag around the files that you want to select.</para>
                <para>In list view, click on the first item in the group. Press-and-hold <keycap>SHIFT</keycap>, then click on the last item in the group.</para>
              </entry>
              <entry colname="colspec3" valign="top"/>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select multiple items</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Press-and-hold <keycap>CTRL</keycap>. Click on the items that you want to select.</para>
                <para>Alternatively, press-and-hold <keycap>CTRL</keycap>, then drag around the files that you want to select.</para>
              </entry>
              <entry colname="colspec3" valign="top"/>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select all items in a folder</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Mark</guimenu><guimenuitem>Select All</guimenuitem></menuchoice>.</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>CTRL</keycap><keycap>A</keycap></keycombo></para>
                <para><keycombo><keycap>CTRL</keycap><keycap>+</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Unselect all items in a folder</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Mark</guimenu><guimenuitem>Unselect All</guimenuitem></menuchoice>.</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>A</keycap></keycombo></para>
                <para><keycombo><keycap>CTRL</keycap><keycap>-</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select all files with the same extension</para>
              </entry>
              <entry colname="colspec2" valign="top"/>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>ALT</keycap><keycap>NUM +</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Unselect all files with the same extension</para>
              </entry>
              <entry colname="colspec2" valign="top"/>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>ALT</keycap><keycap>NUM -</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Select files using a pattern</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Mark</guimenu><guimenuitem>Select with Pattern</guimenuitem></menuchoice>. &app; selects files matching a pattern based upon their file name using either wildcards or regular expressions.
                </para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>NUM +</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Unselect files using a pattern</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Mark</guimenu><guimenuitem>Unselect with Pattern</guimenuitem></menuchoice>. &app; unselects files matching a pattern based upon their file name using either
                  wildcards or regular expressions.
                </para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>NUM -</keycap></keycombo></para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>Invert selection</para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Mark</guimenu><guimenuitem>Invert Selection</guimenuitem></menuchoice>.</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para><keycombo><keycap>NUM *</keycap></keycombo></para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>To perform the default action on an item, double-click on the item.</para>
    </sect2>


    <!-- ================ Drag-and-Drop Subsection ======================= -->
    <sect2 id="gnome-commander-dnd">
      <title>Drag-and-Drop</title>
      <para>You can drag and drop selected items from one pane to the other to copy, move, or create a symbolic link
      	to an item. You can also drag and drop the selected items into another application.
      </para>
      <para>To drag and drop a selection or a selected item with your mouse, with the pointer over the selection or
	      the item, press the left button and keep it depressed, move the mouse pointer to the target location and
   	   release the left button.
   	</para>
      <itemizedlist>
        <listitem>
          <para>By pressing the <keycap>SHIFT</keycap> key while you release the mouse button you can move the
          	selection instead of copying it.
       	</para>
        </listitem>
        <listitem>
          <para>By pressing the <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap></keycombo> keys while you
          	release the mouse button you can create symbolic link to the selection instead of copying it.
          </para>
        </listitem>
      </itemizedlist>
      <para>When not pressing a key while dropping the selection, the default is to query for the action to be
        executed, i.e. copy, move or create a symbolic link. In the &app; options you can change that behavior
        to copy or to move the selection. See also under <xref linkend="gnome-commander-prefs-confirmation"/>.
      </para>
    </sect2>
    <!-- ================ Copying Files Subsection ======================= -->
    <sect2 id="gnome-commander-copy">
      <title>Copying a File or Folder</title>
      <para>You can use the mouse, the keyboard and the menus to copy a selection of items in another location.
      </para>
      <para>First select the item(s) you wish to copy, You can then use any of the the following options.</para>
      <itemizedlist>
        <listitem>
          <para>To copy using the menus <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>, then select the location where you want to copy the selection and select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice>.
          </para>
        </listitem>
        <listitem>
          <para>Using the mouse You can also right click on the selected items in the drop down menu select
   	       <guimenuitem>Copy</guimenuitem> then in the chosen location Right click in an empty area and select
	          <guimenuitem>Paste</guimenuitem> in the drop down menu.
          </para>
        </listitem>
        <listitem>
          <para>Press the following keys <keycombo><keycap>CTRL</keycap><keycap>C</keycap></keycombo>, then select the location for the files and press <keycombo><keycap>CTRL</keycap><keycap>V</keycap></keycombo></para>
        </listitem>
        <listitem>
          <para>To copy the selection from one pane to the other using the mouse simply drag and drop the selected
          	items to the other pane.
       	</para>
        </listitem>
        <listitem>
          <para>To copy the selection from one pane to the other you can simply press <keycap>F5</keycap>.</para>
        </listitem>
      </itemizedlist>
      <note>
        <para>The first three options will allow you to copy into another application than &app;.</para>
      </note>
    </sect2>
    <!-- ================ Moving Files Subsection ======================= -->
    <sect2 id="gnome-commander-move">
      <title>Moving a File or Folder</title>
      <para>You can use the mouse, the keyboard , and the menus to move a selection of items in another location
      </para>
      <para>First select the item(s) you wish to move, You can then use any of the the following options.</para>
      <itemizedlist>
        <listitem>
          <para>To move using the menus <menuchoice><guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice>, then select the location where you want to copy the selection and select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice>.
          </para>
        </listitem>
        <listitem>
          <para>Using the mouse you can also right click on the selected items in the drop down menu select
          <guimenuitem>Cut</guimenuitem> then in the chosen location right click in an empty area and select
          <guimenuitem>Paste</guimenuitem> in the drop down menu.
          </para>
        </listitem>
        <listitem>
          <para>Press the following keys <keycombo><keycap>CTRL</keycap><keycap>X</keycap></keycombo>, then select the location for the files and press <keycombo><keycap>CTRL</keycap><keycap>V</keycap></keycombo></para>
        </listitem>
        <listitem>
          <para>To move the selection from one pane to the other using the mouse drag and drop the selected items
          to the other pane and press the <keycap>SHIFT</keycap> while releasing the left mouse button.</para>
        </listitem>
        <listitem>
          <para>To move the selection from one pane to the other can simply press <keycap>F6</keycap>.</para>
        </listitem>
      </itemizedlist>
      <note>
        <para>With the first three options it is possible to move marked items into another application.</para>
      </note>
    </sect2>
    <!-- ================ Renaming Files Subsection ======================= -->
    <sect2 id="gnome-commander-rename">
      <title>Renaming a File or Folder</title>
      <para>This section describes a simple way to rename files or folders. There is also the
      <xref linkend="gnome-commander-advanced-rename"/> for more complex operations and batch processing. You can
       use various the following methods to rename files and folder.</para>
      <para>Firstly select the item you wish to rename.</para>
      <itemizedlist>
        <listitem>
          <para>Right click on the item and select <guimenu>Rename</guimenu>, type in the new name, and press
           <keycap>ENTER</keycap> when finished.</para>
        </listitem>
        <listitem>
          <para>Press <keycap>F2</keycap> and then type in the new name and press <keycap>ENTER</keycap> when
           finished.</para>
        </listitem>
        <listitem>
          <para>You can also use the menus: select <menuchoice><guimenu>File</guimenu><guimenu>Properties</guimenu></menuchoice> and rename the file using the properties dialog.</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <!-- ================ Deleting Files Subsection ======================= -->
    <sect2 id="gnome-commander-delete">
      <title>Deleting a File or Folder</title>
      <para>There are different ways to delete an item using &app;.</para>
      <para>Select the item(s) You wish to delete.</para>
      <itemizedlist>
        <listitem>
          <para>Press the <keycap>Delete</keycap> or the <keycap>F8</keycap> keys.</para>
        </listitem>
        <listitem>
          <para>With the mouse right click on the item(s) then in the drop down menu select <guimenu>Delete</guimenu>.</para>
        </listitem>
        <listitem>
          <para>In the menu select <guimenu>Delete</guimenu>.</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <!-- ================ Creating Folders Subsection ======================= -->
    <sect2 id="gnome-commander-create-folder">
      <title>Creating a Folder</title>
      <para>You can create a new folder in &app; using the following methods.</para>
      <para>Navigate to the location where you want to create the new folder.</para>
      <itemizedlist>
        <listitem>
          <para>Press the <keycap>F7</keycap>, in the dialog box that is then opened name the new folder.</para>
        </listitem>
        <listitem>
          <para>Using the mouse right click in an empty area of the pane, in the drop down menu select <menuchoice><guimenu>New</guimenu><guimenu>Folder</guimenu></menuchoice>, then type the folder name in the dialog box that is opened.</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <!-- ================ Symbolic Links Subsection ======================= -->
    <sect2 id="gnome-commander-symbolic-links">
      <title>Creating a Symbolic Link to a File or Folder</title>
      <para>A symbolic link is a special type of file that points to another file or folder.
        When you perform an action on a symbolic link, the action is performed
        on the file or folder to which the symbolic link points.
        However, when you delete a symbolic link, you delete the link file,
        not the file to which the symbolic link points.</para>
      <para>There are three different ways to create a symbolic link to
      a file or folder:
      <itemizedlist>
        <listitem>
          <para>Select the file or folder to which you want to create a
          link. Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Create
          Symbolic Link</guimenuitem></menuchoice>.</para>
        </listitem>
        <listitem>
          <para>Grab the item to which you want to create a link, then
          press-and-hold <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap></keycombo>.
          Drag the item to the location where you want to place the link.</para>
        </listitem>
        <listitem>
	  <para>Select the file or folder to which you want to create
        a link. Press
        <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>F5</keycap></keycombo>.</para>
	</listitem>
      </itemizedlist></para>
      <note>
        <para>The permissions of a symbolic link are determined by the file
            or folder to which a symbolic link points.</para>
      </note>
      <tip>
        <para>For more on dragging items, see <xref linkend="gnome-commander-dnd"/>.</para>
      </tip>
    </sect2>
	 <!-- ================ Tab subsection ================================= -->
	 <sect2 id="gnome-commander-tabs">
		<title>Using multiple tabs</title>
		<para>You can open multiple tabs in both panels to speed up navigation. &app; can store the open tabs location upon closing. When you restart the application the tabs are reopened as they were before. This option can be set in <xref linkend="gnome-commander-prefs-general"/>. </para>
		<para>Using the mouse the middle click can be configured to open a new tab. This option can be set in <xref linkend="gnome-commander-prefs-general"/>. When it is set a middle click on a folder will open it in a new tab in the same pane.
		</para>
		<note>
		<para>When using a 2 button mouse the middle click is emulated by clicking both buttons simultaneously
		</para>
		</note>
		<itemizedlist>
        <listitem>
        <para>To open a new tab press <keycombo><keycap>CTRL</keycap><keycap>T</keycap></keycombo> this opens a new tab in the current panel with the same folder opened.</para>
        </listitem>
        <listitem>
       	 <para>To open a new tab displaying the selected folder in the current pane press the <keycombo><keycap>CTRL</keycap><keycap>UP</keycap></keycombo>. If you have configured the mouse middle click option to open a new tab (<xref linkend="gnome-commander-prefs-general"/>), then using the middle mouse button on a folder will also open a new tab displaying it in the current pane.</para>
        </listitem>
        <listitem>
       	 <para>To open a new tab displaying the selected folder in the inactive pane press the <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>UP</keycap></keycombo>.</para>
        </listitem>
        <listitem>
     	   <para>To navigate between tab you can you the mouse or use <keycombo><keycap>CTRL</keycap><keycap>TAB</keycap></keycombo> as many time as needed to select the tab element. If the tabs are selected you can also use the <keycap>RIGHT</keycap> or <keycap>LEFT</keycap> to select the desired tab.</para>
        </listitem>
        <listitem>
     	   <para>To close a tab you can use the mouse and double click the tab or right click on it and from the menu select <guimenu>Close tab</guimenu>. You can also close the current tab using the keyboard shortcut <keycombo><keycap>CTRL</keycap><keycap>W</keycap></keycombo></para>
        </listitem>
      </itemizedlist>
    	  <para>Right clicking on any tab will open a tab specific menu</para>
      <itemizedlist>
        <listitem>
        	<para><guimenu>Open in new tab</guimenu> this action opens a new tab with the displaying the currently opened folder. </para>
        </listitem>
        <listitem>
        	<para><guimenu>Refresh tab</guimenu> this actions refreshes the files displayed currently in the folder.
        	</para>
        </listitem>
        <listitem>
        	<para><guimenu>Copy tab to other pane</guimenu> opens a new tab in the opposite pane, this tab will display the selected tab. </para>
        </listitem>
        <listitem>
	        <para><guimenu>Close tab</guimenu> this action closes the currently selected tab.
        </para>
        </listitem>
		  <listitem>
        <para><guimenu>Close all tabs</guimenu> &app; will close all open tabs in the current pane. This leaves the current tab as the only open folder.</para>
        </listitem>
        <listitem>
        <para><guimenu>Close duplicate tabs</guimenu> &app; will search for duplicated open tabs in the current pane and close them.</para>
        </listitem>
      </itemizedlist>
	 </sect2>

  </sect1>

<!-- ================ Advanced features ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for
  which the application is designed. -->
<!--This was split from usage section to help readability-->
  <sect1 id="gnome-commander-advanced-features">
    <title>Advanced Features</title>
    <para>This section describes more features and tools included in &app;</para>
    <!-- ================ File Properties Subsection ======================= -->
    <sect2 id="gnome-commander-file-properties">
      <title>Viewing the Properties of a File or Folder</title>
      <para>To view the properties of a file or folder, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>Select the file or folder whose properties you want to
	  view. Now you can</para>
        </listitem>
      </orderedlist>
      <itemizedlist>
        <listitem>
          <para>Press <keycombo><keycap>ALT</keycap><keycap>ENTER</keycap></keycombo>.</para>
        </listitem>
        <listitem>
          <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties...</guimenuitem></menuchoice>.</para>
        </listitem>
        <listitem>
          <para>Right-click on the file or folder and choose <guimenuitem>Properties...</guimenuitem>.</para>
        </listitem>
      </itemizedlist>
      <!-- ==== Figure ==== -->
      <figure id="properties-dlg-fig">
        <title>File Properties dialog</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_dialog_file_properties.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows file properties dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <tip>
        <para>On the Permissions tab (see <xref linkend="permission-tab-fig"></xref>), you can change the permissions
         and ownership of a file (that is, if you have the right permissions
         yourself).You can change the read, write, and execute settings
   	   for a file. For more information on permissions, see
   	   <xref linkend="gnome-commander-permissions"></xref>.</para>
      </tip>
      <para>The following table lists the properties that you can view or set for
      	files and folders, the exact information shown depends on the object type:
      </para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="27.27*"/>
          <colspec colwidth="72.73*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Property</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry valign="top">
                <para>Name</para>
              </entry>
              <entry valign="top">
                <para>The name of the file or folder.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Location</para>
              </entry>
              <entry valign="top">
                <para>The location of the file or folder.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Volume</para>
              </entry>
              <entry valign="top">
                <para>The name of the volume in which the file or folder
		is located.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Free space</para>
              </entry>
              <entry valign="top">
                <para>The amount of free space on the volume.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Type</para>
              </entry>
              <entry valign="top">
                <para>The type of object, file or folder.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>MIME Type</para>
              </entry>
              <entry valign="top">
                <para>The official naming of the type of file.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Opens with</para>
              </entry>
              <entry valign="top">
                <para>Default application to open the file with.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Modified</para>
              </entry>
              <entry valign="top">
                <para>The date and time at which the object was last changed.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Accessed</para>
              </entry>
              <entry valign="top">
                <para>The date and time at which the object was last viewed.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Size</para>
              </entry>
              <entry valign="top">
                <para>The amount of data occupied by object, file or folder.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>Metadata</para>
              </entry>
              <entry valign="top">
                <para>If available, additional metadata information is
                shown for file types like images, documents or audio
                files. The shown tags are: File.Description,
                File.Publisher, Doc.Title, Doc.Pagecount,
                Audio.Albumartist, Audio.Title, Audio.Bitrate and
                Audio.Durationmmss. For more information, see 
		<link linkend="gnome-commander-advanced-rename-metadata-tags">metadata tags</link>.
		</para>
	      </entry>
	    </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
    <!-- ================ Permissions Subsection ======================= -->
    <sect2 id="gnome-commander-permissions">
      <title>Changing Permissions</title>
      <para>To change the permissions of a file or a folder, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Select the file that needs its permission modified.</para>
        </listitem>
        <listitem>
            <para>Open the <link linkend="gnome-commander-file-properties">properties window</link>
	    with your favorite method (e.g. <keycombo><keycap>ALT</keycap><keycap>ENTER</keycap></keycombo>).</para>
        </listitem>
        <listitem>
          <para>Click on the <guilabel>Permissions</guilabel> tab.</para>
        </listitem>
        <listitem>
          <para>To change the file&apos;s group, choose from the groups the user
           belongs to in the drop-down selector.</para>
        </listitem>
        <listitem>
          <para>For each of the owner, the group, and all other users, choose from
           these permissions for the file:</para>
          <informaltable frame="topbot">
            <tgroup cols="2" colsep="0" rowsep="0">
              <colspec colwidth="27.27*"/>
              <colspec colwidth="72.73*"/>
              <thead>
                <row rowsep="1">
                  <entry>
                    <para>Property</para>
                  </entry>
                  <entry>
                    <para>Description</para>
                  </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry valign="top">
                    <para>Read</para>
                  </entry>
                  <entry valign="top">
                    <para>The users can read a file.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>Write</para>
                  </entry>
                  <entry valign="top">
                    <para>The users can save a file.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>Execute</para>
                  </entry>
                  <entry valign="top">
                    <para>The users can run a file as a program.</para>
                  </entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
        </listitem>
      </orderedlist>
      <!-- ==== Figure ==== -->
      <figure id="permission-tab-fig">
        <title>File Permissions dialog</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_dialog_file_permissions.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows file permissions dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <!-- ==== End of Figure ==== -->


    </sect2>
    <!-- ================ Bookmarks Subsection ======================= -->
    <sect2 id="gnome-commander-bookmarks">
      <title>Using Bookmarks</title>
      <para>You can use bookmarks to speed up navigation within your local files or to
       access remote servers.</para>
      <para>Managing your bookmarks is done with the bookmark manager, started by selecting 
      <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Manage bookmarks...</guimenuitem></menuchoice> 
      or pressing <keycombo><keycap>CTRL</keycap><keycap>D</keycap></keycombo>. See an example screenshot
      below.</para>
      <para>To add a folder to the bookmarks, navigate to the folder&apos;s location.
      In the menu select <menuchoice><guimenu>Bookmarks</guimenu><guimenu>Bookmark this 
      directory</guimenu></menuchoice>. Once you have added a bookmark, it will be added 
      in its respective group in the <menuchoice><guimenu>Bookmarks</guimenu></menuchoice> menu.
      A bookmark is automatically assigned to a group, depending on where the bookmark is pointing to.</para>
      <para>You can then Jump to a bookmark, Edit, Remove, or modify the position of a
      bookmark in the selected group.</para>
      <para>In the bookmark list there are four different columns displayed:
      <orderedlist>
	<listitem><para>The name of the bookmark group,</para></listitem>
	<listitem><para>The name of the bookmark,</para></listitem>
	<listitem><para>The shortcut of the bookmark,</para></listitem>
	<listitem><para>The path to which the bookmark points to.</para></listitem>
      </orderedlist></para>
      <para>The name and the path of a bookmark are editable by pressing the <guimenu>Edit</guimenu> 
      button. In contrast, the shortcut of a bookmark in the third column is taken from 
      the associated user action <guimenu>Go to bookmarked location</guimenu>, adjustable by clicking on 
      the  menu entry <menuchoice><guimenu>Settings</guimenu><guimenuitem>Keyboard Shortcuts...</guimenuitem>
      </menuchoice>. In the bookmarks window it is only shown as a reference but it is not editable.</para>
      <!-- ==== Figure ==== -->
      <figure id="bookmark-dlg-mgmt-fig">
        <title>Bookmark Management Dialog</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_dialog_bookmark.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows bookmark management dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
    </sect2>
    <!-- ================ Hidden Files Subsection ======================= -->
    <sect2 id="gnome-commander-hidden-files">
      <title>Hidden Files and Folders</title>
      <para>By default, &app; does not display certain system and backup files in folders.
        This prevents accidental modification or deletion of them, which can impair the operation of your computer,
        and also reduces clutter in locations such as your Home Folder. &app; does not display:</para>
        <itemizedlist>
            <listitem><para>Hidden files, whose file name begins with a period (.),</para></listitem>
            <listitem><para>Backup files, whose file name ends with a tilde (~) or with extension <filename>'.bak'</filename></para></listitem>
            <listitem><para>Files that are listed in a particular folder's <filename>.hidden</filename> file.</para></listitem>
        </itemizedlist>
      <para>You may hide or show hidden files in all folders by:</para> 
      <itemizedlist>
            <listitem><para>Selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem></menuchoice>,</para></listitem>
            <listitem><para>Pressing <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>H</keycap></keycombo>.</para></listitem>
        </itemizedlist>
    </sect2>
    <!-- ================ Advanced Rename Subsection ======================= -->
    <sect2 id="gnome-commander-advanced-rename">
        <title>Advanced file renaming</title>
        <para>A powerful tool for batch renaming of the files selected in &app;.
        It allows to easily rename lots of files in one go.
        The file names can be created by parts of the original file name, its path,
        numbering the files or accessing hundreds of informations about the file,
        like creation date or <link linkend="gnome-commander-advanced-rename-metadata-tags">Exif/IPTC</link>
        informations of an image.</para>

        <para>When started, the following dialog is displayed:</para>

        <!-- ==== Figure ==== -->
        <figure id="advrename-dlg-fig">
             <title>Advanced Rename Tool Dialog</title>
             <screenshot>
                <mediaobject>
                   <imageobject>
                     <imagedata fileref="figures/gnome-commander_dialog_adv_rename.png" format="PNG"/>
                        </imageobject>
                   <textobject><phrase>Shows advanced file renaming dialog.</phrase>
                   </textobject>
               </mediaobject>
             </screenshot>
           </figure>
        <!-- ==== End of Figure ==== -->

        <variablelist>
          <varlistentry>
              <term>
                  <guilabel>Template</guilabel>
              </term>
              <listitem>
                  <para>Specifies template for file renaming. All ordinary characters placed in the format string
                        go into the new name without conversion. Conversion specifiers are introduced by a few
                        <link linkend="gnome-commander-advanced-rename-placeholders">placeholders</link>
                        (see below for the detailed list). Additionally
                        <link linkend="gnome-commander-advanced-rename-g-date-time-format">g_date_time_format() format controls</link>
                        are also accepted - except for "%D", "%n" and "%t" for obvious reasons.
                        If found, they are left intact.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guilabel>Counter</guilabel>
              </term>
              <listitem>
                  <para>Specifies settings for counters: start value, step and width ('auto' = automatic width, '1',..., '16': fixed width).</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guilabel>Regex replacing</guilabel>
              </term>
              <listitem>
                  <para>List of the regular expression patterns. The patterns are matched against
                        <guilabel>Template</guilabel>. If matched, patterns are replaced
                        with their corresponding replacements. The order of execution is top-bottom.
                        Invalid or broken regex patterns will be marked red.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guilabel>Case</guilabel>
              </term>
              <listitem>
                <para>Changes the case of the selected file names.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guilabel>Trim blanks</guilabel>
              </term>
              <listitem>
                  <para>Removes leading and trailing whitespace from the selected file names.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guilabel>Results</guilabel>
              </term>
              <listitem>
                  <para>List of the new file names. The list can be reordered using drag-and-drop.
                        The context menu provides options for: removing file from the list,
                        viewing file or its properties, and refreshing the list.
                        Conflicting renames will be marked red.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guibutton>Apply</guibutton>
              </term>
              <listitem>
                  <para>Starts to rename files. Conflicting renames will be marked red.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guibutton>Close</guibutton>
              </term>
              <listitem>
                  <para>Closes the dialog without file renaming.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guibutton>Reset</guibutton>
              </term>
              <listitem>
                  <para>Resets current settings to defaults.</para>
              </listitem>
          </varlistentry>
          <varlistentry>
              <term>
                  <guibutton>Profiles...</guibutton>
              </term>
              <listitem>
                  <para>Shows options for profile management. A profile is a collection
                        of advanced file renaming parameters
                        (template, counter, regex patterns, case conversions and blank trimming)
                        identified by its name. You can define as many different profiles as you require.</para>
              </listitem>
          </varlistentry>
        </variablelist>

        <sect3 id="gnome-commander-advanced-rename-placeholders">
        <title>Template Placeholders</title>
        <informaltable frame="topbot">
            <tgroup cols="2">
                <colspec colname="col1"/>
                <colspec colname="col2"/>
                <thead>
                    <row valign="top">
                        <entry colname="col1" colsep="0" valign="top"><para>Placeholder</para></entry>
                        <entry colname="col2" valign="top"><para>Replacement</para></entry>
                    </row>
                </thead>
                <tbody>
                    <row valign="top">
                        <entry><para>$N</para></entry>
                        <entry><para>The whole file name (with extension)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$N(range)</para></entry>
                        <entry><para>Part of the whole file name (with extension)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$n</para></entry>
                        <entry><para>File name without extension</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$n(range)</para></entry>
                        <entry><para>Part of the file name without extension</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$e</para></entry>
                        <entry><para>File extension</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$e(range)</para></entry>
                        <entry><para>Part of the file extension</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$p</para></entry>
                        <entry><para>Parent dir name</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$p(range)</para></entry>
                        <entry><para>Part of the parent dir name</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$g</para></entry>
                        <entry><para>Grandparent dir name</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$g(range)</para></entry>
                        <entry><para>Part of the grandparent dir name</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$c</para></entry>
                        <entry><para>File counter</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$c(width)</para></entry>
                        <entry><para>File counter with specified digit number (width)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$c(a)</para></entry>
                        <entry><para>File counter with digit number (width) calculated automatically</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$x</para></entry>
                        <entry><para>Hexadecimal random number (8 lowercase digits)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$x(width)</para></entry>
                        <entry><para>Hexadecimal random number with specified lowercase digit number (width)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$X</para></entry>
                        <entry><para>Hexadecimal random number (8 uppercase digits)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$X(width)</para></entry>
                        <entry><para>Hexadecimal random number with specified uppercase digit number (width)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$T(metatag)</para></entry>
                        <entry><para>Metadata tag</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>$$</para></entry>
                        <entry><para>A literal "$" character</para></entry>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>

        <tip>
            <para>Broken - like $n(), $e(0,-3) or $N(abc) - or unknown placeholders are copied verbatim without any substitution.</para>
        </tip>
        </sect3>

        <sect3 id="gnome-commander-advanced-rename-metadata-tags">
        <title>Metadata Tags (Metatags)</title>

        <para>Metadata is usually defined as data about data. Metadata describes data about files that is often user visible in file managers,
        office applications, document viewers and audio players. Metadata can typically be viewed or written by selecting "properties"
        from the file menu of one of these applications.</para>

        <para>For all metadata, each metadata tag (metatag) needs to be namespaced with its class type using a "." qualifier
        (e.g. <literal>Audio.Artist</literal> represents the metadata Artist for an audio class file).</para>

        <para>The placeholder for metadata is <literal>$T(metatag)</literal>. Use, for example,
        <literal>$T(Exif.DateTime)</literal> to get image capture date/time and to insert it to new
        filename (metatags names are case insensitive, so we could use also
        <literal>$T(exif.datetime)</literal> here). The generic <literal>'Audio.'</literal>,
        <literal>'Doc.'</literal>, <literal>'File.'</literal> and <literal>'Image.'</literal>  metatags are independent
        of the used framework and they provide unified access to respectively audio, doc, file or image metadata.
        Please refer to
        <ulink url="http://freedesktop.org/wiki/Specifications/shared-filemetadata-spec" type="http">freedesktop.org</ulink>
        for more details on the generic metatags.</para>

        <informaltable frame="topbot">
            <tgroup cols="3">
                <colspec colname="col1"/>
                <colspec colname="col2"/>
                <colspec colname="col3"/>
                <thead>
                    <row valign="top">
                        <entry colname="col1" colsep="0" valign="top"><para>Tag</para></entry>
                        <entry colname="col2" colsep="0" valign="top"><para>Name</para></entry>
                        <entry colname="col3" valign="top"><para>Description</para></entry>
                    </row>
                </thead>
                <tbody>
                    <row valign="top">
                        <entry><para>Audio.Album</para></entry>
                        <entry><para>Album</para></entry>
                        <entry><para>Name of the album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.AlbumArtist</para></entry>
                        <entry><para>Album Artist</para></entry>
                        <entry><para>Artist of the album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.AlbumGain</para></entry>
                        <entry><para>Album Gain</para></entry>
                        <entry><para>Gain adjustment of the album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.AlbumPeakGain</para></entry>
                        <entry><para>Album Peak Gain</para></entry>
                        <entry><para>Peak gain adjustment of album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.AlbumTrackCount</para></entry>
                        <entry><para>Album Track Count</para></entry>
                        <entry><para>Total number of tracks on the album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Artist</para></entry>
                        <entry><para>Artist</para></entry>
                        <entry><para>Artist of the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Bitrate</para></entry>
                        <entry><para>Bitrate</para></entry>
                        <entry><para>Bitrate in kbps.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Channels</para></entry>
                        <entry><para>Channels</para></entry>
                        <entry><para>Number of channels in the audio (2 = stereo).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Codec</para></entry>
                        <entry><para>Codec</para></entry>
                        <entry><para>Codec encoding description.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.CodecVersion</para></entry>
                        <entry><para>Codec Version</para></entry>
                        <entry><para>Codec version.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Comment</para></entry>
                        <entry><para>Comment</para></entry>
                        <entry><para>Comments on the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Copyright</para></entry>
                        <entry><para>Copyright</para></entry>
                        <entry><para>Copyright message.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.CoverAlbumThumbnailPath</para></entry>
                        <entry><para>Cover Album Thumbnail Path</para></entry>
                        <entry><para>File path to thumbnail image of the cover album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.DiscNo</para></entry>
                        <entry><para>Disc Number</para></entry>
                        <entry><para>Specifies which disc the track is on.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Duration</para></entry>
                        <entry><para>Duration</para></entry>
                        <entry><para>Duration of track in seconds.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Duration.MMSS</para></entry>
                        <entry><para>Duration [MM:SS]</para></entry>
                        <entry><para>Duration of track as MM:SS.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Genre</para></entry>
                        <entry><para>Genre</para></entry>
                        <entry><para>Type of music classification for the track as defined in ID3 spec.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.IsNew</para></entry>
                        <entry><para>Is New</para></entry>
                        <entry><para>Set to "1" if track is new to the user (default "0").</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.ISRC</para></entry>
                        <entry><para>ISRC</para></entry>
                        <entry><para>ISRC (international standard recording code).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.LastPlay</para></entry>
                        <entry><para>Last Play</para></entry>
                        <entry><para>When track was last played.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Lyrics</para></entry>
                        <entry><para>Lyrics</para></entry>
                        <entry><para>Lyrics of the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MBAlbumArtistID</para></entry>
                        <entry><para>MB album artist ID</para></entry>
                        <entry><para>MusicBrainz album artist ID in UUID format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MBAlbumID</para></entry>
                        <entry><para>MB Album ID</para></entry>
                        <entry><para>MusicBrainz album ID in UUID format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MBArtistID</para></entry>
                        <entry><para>MB Artist ID</para></entry>
                        <entry><para>MusicBrainz artist ID in UUID format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MBTrackID</para></entry>
                        <entry><para>MB Track ID</para></entry>
                        <entry><para>MusicBrainz track ID in UUID format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MPEG.ChannelMode</para></entry>
                        <entry><para>Channel Mode</para></entry>
                        <entry><para>MPEG channel mode.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MPEG.Copyrighted</para></entry>
                        <entry><para>Copyrighted</para></entry>
                        <entry><para>"1" if the copyrighted bit is set.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MPEG.Layer</para></entry>
                        <entry><para>Layer</para></entry>
                        <entry><para>MPEG layer.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MPEG.Original</para></entry>
                        <entry><para>Original Audio</para></entry>
                        <entry><para>"1" if the "original" bit is set.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.MPEG.Version</para></entry>
                        <entry><para>MPEG Version</para></entry>
                        <entry><para>MPEG version.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Performer</para></entry>
                        <entry><para>Performer</para></entry>
                        <entry><para>Name of the performer/conductor of the music.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.PlayCount</para></entry>
                        <entry><para>Play Count</para></entry>
                        <entry><para>Number of times the track has been played.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.ReleaseDate</para></entry>
                        <entry><para>Release Date</para></entry>
                        <entry><para>Date track was released.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.SampleRate</para></entry>
                        <entry><para>Sample Rate</para></entry>
                        <entry><para>Sample rate in Hz.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Title</para></entry>
                        <entry><para>Title</para></entry>
                        <entry><para>Title of the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.TrackGain</para></entry>
                        <entry><para>Track Gain</para></entry>
                        <entry><para>Gain adjustment of the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.TrackNo</para></entry>
                        <entry><para>Track Number</para></entry>
                        <entry><para>Position of track on the album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.TrackPeakGain</para></entry>
                        <entry><para>Track Peak Gain</para></entry>
                        <entry><para>Peak gain adjustment of track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Audio.Year</para></entry>
                        <entry><para>Year</para></entry>
                        <entry><para>Year.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Author</para></entry>
                        <entry><para>Author</para></entry>
                        <entry><para>Name of the author.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.ByteCount</para></entry>
                        <entry><para>Byte Count</para></entry>
                        <entry><para>Number of bytes in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.CaseSensitive</para></entry>
                        <entry><para>Case Sensitive</para></entry>
                        <entry><para>Case sensitive.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Category</para></entry>
                        <entry><para>Category</para></entry>
                        <entry><para>Category.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.CellCount</para></entry>
                        <entry><para>Cell Count</para></entry>
                        <entry><para>Number of cells in the spreadsheet document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.CharacterCount</para></entry>
                        <entry><para>Character Count</para></entry>
                        <entry><para>Number of characters in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Codepage</para></entry>
                        <entry><para>Codepage</para></entry>
                        <entry><para>The MS codepage to encode strings for metadata.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Comments</para></entry>
                        <entry><para>Comments</para></entry>
                        <entry><para>User definable free text.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Company</para></entry>
                        <entry><para>Company</para></entry>
                        <entry><para>Organization that the <literal>Doc.Creator</literal> entity is associated with.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Author</para></entry>
                        <entry><para>Author</para></entry>
                        <entry><para>Name of the author.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Creator</para></entry>
                        <entry><para>Creator</para></entry>
                        <entry><para>An entity primarily responsible for making the content of the resource, typically a person, organization, or service.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Created</para></entry>
                        <entry><para>Created</para></entry>
                        <entry><para>Datetime document was originally created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.DateCreated</para></entry>
                        <entry><para>Date Created</para></entry>
                        <entry><para>Date associated with an event in the life cycle of the resource (creation/publication date).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.DateModified</para></entry>
                        <entry><para>Date Modified</para></entry>
                        <entry><para>The last time the document was saved.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Description</para></entry>
                        <entry><para>Description</para></entry>
                        <entry><para>An account of the content of the resource.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Dictionary</para></entry>
                        <entry><para>Dictionary</para></entry>
                        <entry><para>Dictionary.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.EditingDuration</para></entry>
                        <entry><para>Editing Duration</para></entry>
                        <entry><para>The total time taken until the last modification.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Generator</para></entry>
                        <entry><para>Generator</para></entry>
                        <entry><para>The application that generated this document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.HiddenSlideCount</para></entry>
                        <entry><para>Hidden Slide Count</para></entry>
                        <entry><para>Number of hidden slides in the presentation document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.ImageCount</para></entry>
                        <entry><para>Image Count</para></entry>
                        <entry><para>Number of images in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.InitialCreator</para></entry>
                        <entry><para>Initial Creator</para></entry>
                        <entry><para>Specifies the name of the person who created the document initially.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Keywords</para></entry>
                        <entry><para>Keywords</para></entry>
                        <entry><para>Searchable, indexable keywords.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Language</para></entry>
                        <entry><para>Language</para></entry>
                        <entry><para>The locale language of the intellectual content of the resource.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.LastPrinted</para></entry>
                        <entry><para>Last Printed</para></entry>
                        <entry><para>The last time this document was printed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.LastSavedBy</para></entry>
                        <entry><para>Last Saved By</para></entry>
                        <entry><para>The entity that made the last change to the document, typically a person, organization, or service.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.LineCount</para></entry>
                        <entry><para>Line Count</para></entry>
                        <entry><para>Number of lines in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.LinksDirty</para></entry>
                        <entry><para>Links Dirty</para></entry>
                        <entry><para>Links dirty.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.LocaleSystemDefault</para></entry>
                        <entry><para>Locale System Default</para></entry>
                        <entry><para>Identifier representing the default system locale.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Manager</para></entry>
                        <entry><para>Manager</para></entry>
                        <entry><para>Name of the manager of <literal>Doc.Creator</literal> entity.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.MMClipCount</para></entry>
                        <entry><para>Multimedia Clip Count</para></entry>
                        <entry><para>Number of multimedia clips in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.NoteCount</para></entry>
                        <entry><para>Note Count</para></entry>
                        <entry><para>Number of "notes" in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.ObjectCount</para></entry>
                        <entry><para>Object Count</para></entry>
                        <entry><para>Number of objects (OLE and other graphics) in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.PageCount</para></entry>
                        <entry><para>Page Count</para></entry>
                        <entry><para>Number of pages in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.ParagraphCount</para></entry>
                        <entry><para>Paragraph Count</para></entry>
                        <entry><para>Number of paragraphs in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.PresentationFormat</para></entry>
                        <entry><para>Presentation Format</para></entry>
                        <entry><para>Type of presentation, like "On-screen Show", "SlideView", etc.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.PrintDate</para></entry>
                        <entry><para>Print Date</para></entry>
                        <entry><para>Specifies the date and time when the document was last printed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.PrintedBy</para></entry>
                        <entry><para>Printed By</para></entry>
                        <entry><para>Specifies the name of the last person who printed the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.RevisionCount</para></entry>
                        <entry><para>Revision Count</para></entry>
                        <entry><para>Number of revision on the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Scale</para></entry>
                        <entry><para>Scale</para></entry>
                        <entry><para>Scale.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Security</para></entry>
                        <entry><para>Security</para></entry>
                        <entry><para>One of: "Password protected", "Read-only recommended", "Read-only enforced" or "Locked for annotations".</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.SlideCount</para></entry>
                        <entry><para>Slide Count</para></entry>
                        <entry><para>Number of slides in the presentation document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.SpreadsheetCount</para></entry>
                        <entry><para>Spreadsheet Count</para></entry>
                        <entry><para>Number of pages in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Subject</para></entry>
                        <entry><para>Subject</para></entry>
                        <entry><para>Document subject.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.TableCount</para></entry>
                        <entry><para>Table Count</para></entry>
                        <entry><para>Number of tables in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Template</para></entry>
                        <entry><para>Template</para></entry>
                        <entry><para>The template file that is been used to generate this document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.Title</para></entry>
                        <entry><para>Title</para></entry>
                        <entry><para>Title of the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Doc.WordCount</para></entry>
                        <entry><para>Word Count</para></entry>
                        <entry><para>Number of words in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ApertureValue</para></entry>
                        <entry><para>Aperture</para></entry>
                        <entry><para>The lens aperture. The unit is the APEX value.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Artist</para></entry>
                        <entry><para>Artist</para></entry>
                        <entry><para>Name of the camera owner, photographer or image creator. The detailed format is not specified, but it is recommended that the information be written for ease of Interoperability. When the field is left blank, it is treated as unknown.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.BatteryLevel</para></entry>
                        <entry><para>Battery Level</para></entry>
                        <entry><para>Battery level.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.BitsPerSample</para></entry>
                        <entry><para>Bits per Sample</para></entry>
                        <entry><para>The number of bits per image component. Each component of the image is 8 bits, so the value for this tag is 8. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.BrightnessValue</para></entry>
                        <entry><para>Brightness</para></entry>
                        <entry><para>The value of brightness. The unit is the APEX value. Ordinarily it is given in the range of -99.99 to 99.99.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.CFAPattern</para></entry>
                        <entry><para>CFA Pattern</para></entry>
                        <entry><para>The color filter array (CFA) geometric pattern of the image sensor when a one-chip color area sensor is used. It does not apply to all sensing methods.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.CFARepeatPatternDim</para></entry>
                        <entry><para>CFA Repeat Pattern Dim</para></entry>
                        <entry><para>CFA Repeat Pattern Dim.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ColorSpace</para></entry>
                        <entry><para>Color Space</para></entry>
                        <entry><para>The color space information tag is always recorded as the color space specifier. Normally sRGB is used to define the color space based on the PC monitor conditions and environment. If a color space other than sRGB is used, Uncalibrated is set. Image data recorded as Uncalibrated can be treated as sRGB when it is converted to FlashPix.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ComponentsConfiguration</para></entry>
                        <entry><para>Components Configuration</para></entry>
                        <entry><para>Information specific to compressed data. The channels of each component are arranged in order from the 1st component to the 4th. For uncompressed data the data arrangement is given in the <literal>Exif.PhotometricInterpretation</literal> tag. However, since <literal>Exif.PhotometricInterpretation</literal> can only express the order of Y, Cb and Cr, this tag is provided for cases when compressed data uses components other than Y, Cb, and Cr and to enable support of other sequences.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.CompressedBitsPerPixel</para></entry>
                        <entry><para>Compressed Bits per Pixel</para></entry>
                        <entry><para>Information specific to compressed data. The compression mode used for a compressed image is indicated in unit bits per pixel.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Compression</para></entry>
                        <entry><para>Compression</para></entry>
                        <entry><para>The compression scheme used for the image data. When a primary image is JPEG compressed, this designation is not necessary and is omitted. When thumbnails use JPEG compression, this tag value is set to 6.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Contrast</para></entry>
                        <entry><para>Contrast</para></entry>
                        <entry><para>The direction of contrast processing applied by the camera when the image was shot.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Copyright</para></entry>
                        <entry><para>Copyright</para></entry>
                        <entry><para>Copyright information. The tag is used to indicate both the photographer and editor copyrights. It is the copyright notice of the person or organization claiming rights to the image. The Interoperability copyright statement including date and rights should be written in this field; e.g., "Copyright, John Smith, 19xx. All rights reserved.". The field records both the photographer and editor copyrights, with each recorded in a separate part of the statement. When there is a clear distinction between the photographer and editor copyrights, these are to be written in the order of photographer followed by editor copyright, separated by NULL (in this case, since the statement also ends with a NULL, there are two NULL codes) (see example 1). When only the photographer is given, it is terminated by one NULL code. When only the editor copyright is given, the photographer copyright part consists of one space followed by a terminating NULL code, then the editor copyright is given. When the field is left blank, it is treated as unknown.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.CustomRendered</para></entry>
                        <entry><para>Custom Rendered</para></entry>
                        <entry><para>The use of special processing on image data, such as rendering geared to output. When special processing is performed, the reader is expected to disable or minimize any further processing.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DateTime</para></entry>
                        <entry><para>Date and Time</para></entry>
                        <entry><para>The date and time of image creation.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DateTimeDigitized</para></entry>
                        <entry><para>Date and Time (digitized)</para></entry>
                        <entry><para>The date and time when the image was stored as digital data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DateTimeOriginal</para></entry>
                        <entry><para>Date and Time (original)</para></entry>
                        <entry><para>The date and time when the original image data was generated. For a digital still camera the date and time the picture was taken are recorded.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DeviceSettingDescription</para></entry>
                        <entry><para>Device Setting Description</para></entry>
                        <entry><para>Information on the picture-taking conditions of a particular camera model. The tag is used only to indicate the picture-taking conditions in the reader.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DigitalZoomRatio</para></entry>
                        <entry><para>Digital Zoom Ratio</para></entry>
                        <entry><para>The digital zoom ratio when the image was shot. If the numerator of the recorded value is 0, this indicates that digital zoom was not used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.DocumentName</para></entry>
                        <entry><para>Document Name</para></entry>
                        <entry><para>Document name.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExifIfdPointer</para></entry>
                        <entry><para>Exif IFD Pointer</para></entry>
                        <entry><para>A pointer to the Exif IFD. Interoperability, Exif IFD has the same structure as that of the IFD specified in TIFF.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExifVersion</para></entry>
                        <entry><para>Exif Version</para></entry>
                        <entry><para>The version of Exif standard supported. Nonexistence of this field is taken to mean nonconformance to the standard.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExposureBiasValue</para></entry>
                        <entry><para>Exposure Bias</para></entry>
                        <entry><para>The exposure bias. The units is the APEX value. Ordinarily it is given in the range of -99.99 to 99.99.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExposureIndex</para></entry>
                        <entry><para>Exposure Index</para></entry>
                        <entry><para>The exposure index selected on the camera or input device at the time the image is captured.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExposureMode</para></entry>
                        <entry><para>Exposure Mode</para></entry>
                        <entry><para>The exposure mode set when the image was shot. In auto-bracketing mode, the camera shoots a series of frames of the same scene at different exposure settings.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExposureProgram</para></entry>
                        <entry><para>Exposure Program</para></entry>
                        <entry><para>The class of the program used by the camera to set exposure when the picture is taken.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ExposureTime</para></entry>
                        <entry><para>Exposure Time</para></entry>
                        <entry><para>Exposure time, given in seconds.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FileSource</para></entry>
                        <entry><para>File Source</para></entry>
                        <entry><para>Indicates the image source. If a DSC recorded the image, this tag value of this tag always be set to 3, indicating that the image was recorded on a DSC.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FillOrder</para></entry>
                        <entry><para>Fill Order</para></entry>
                        <entry><para>Fill order.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Flash</para></entry>
                        <entry><para>Flash</para></entry>
                        <entry><para>This tag is recorded when an image is taken using a strobe light (flash).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FlashEnergy</para></entry>
                        <entry><para>Flash Energy</para></entry>
                        <entry><para>The strobe energy at the time the image is captured, as measured in Beam Candle Power Seconds (BCPS).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FlashPixVersion</para></entry>
                        <entry><para>FlashPix Version</para></entry>
                        <entry><para>The FlashPix format version supported by a FPXR file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FNumber</para></entry>
                        <entry><para>F Number</para></entry>
                        <entry><para>Diameter of the aperture relative to the effective focal length of the lens.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FocalLength</para></entry>
                        <entry><para>Focal Length</para></entry>
                        <entry><para>The actual focal length of the lens, in mm. Conversion is not made to the focal length of a 35 mm film camera.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FocalLengthIn35mmFilm</para></entry>
                        <entry><para>Focal Length In 35mm Film</para></entry>
                        <entry><para>The equivalent focal length assuming a 35mm film camera, in mm. A value of 0 means the focal length is unknown. Note that this tag differs from the <literal>Exif.FocalLength</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FocalPlaneResolutionUnit</para></entry>
                        <entry><para>Focal Plane Resolution Unit</para></entry>
                        <entry><para>The unit for measuring <literal>Exif.FocalPlaneXResolution</literal> and <literal>Exif.FocalPlaneYResolution</literal>. This value is the same as the <literal>Exif.ResolutionUnit</literal>.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FocalPlaneXResolution</para></entry>
                        <entry><para>Focal Plane x-Resolution</para></entry>
                        <entry><para>The number of pixels in the image width (X) direction per <literal>Exif.FocalPlaneResolutionUnit</literal> on the camera focal plane.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.FocalPlaneYResolution</para></entry>
                        <entry><para>Focal Plane y-Resolution</para></entry>
                        <entry><para>The number of pixels in the image height (Y) direction per <literal>Exif.FocalPlaneResolutionUnit</literal> on the camera focal plane.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GainControl</para></entry>
                        <entry><para>Gain Control</para></entry>
                        <entry><para>This tag indicates the degree of overall image gain adjustment.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Gamma</para></entry>
                        <entry><para>Gamma</para></entry>
                        <entry><para>Indicates the value of coefficient gamma.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.Altitude</para></entry>
                        <entry><para>Altitude</para></entry>
                        <entry><para>Indicates the altitude based on the reference in <literal>Exif.GPS.AltitudeRef</literal>. The reference unit is meters.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.AltitudeRef</para></entry>
                        <entry><para>Altitude Reference</para></entry>
                        <entry><para>Indicates the altitude used as the reference altitude. If the reference is sea level and the altitude is above sea level, 0 is given. If the altitude is below sea level, a value of 1 is given and the altitude is indicated as an absolute value in the <literal>Exif.GPS.Altitude</literal> tag. The reference unit is meters.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.InfoIFDPointer</para></entry>
                        <entry><para>GPS Info IFDPointer</para></entry>
                        <entry><para>A pointer to the GPS Info IFD. The Interoperability structure of the GPS Info IFD, like that of Exif IFD, has no image data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.Latitude</para></entry>
                        <entry><para>Latitude</para></entry>
                        <entry><para>Indicates the latitude. The latitude is expressed as three RATIONAL values giving the degrees, minutes, and seconds, respectively. When degrees, minutes and seconds are expressed, the format is dd/1,mm/1,ss/1. When degrees and minutes are used and, for example, fractions of minutes are given up to two decimal places, the format is dd/1,mmmm/100,0/1.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.LatitudeRef</para></entry>
                        <entry><para>North or South Latitude</para></entry>
                        <entry><para>Indicates whether the latitude is north or south latitude. The ASCII value 'N' indicates north latitude, and 'S' is south latitude.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.Longitude</para></entry>
                        <entry><para>Longitude</para></entry>
                        <entry><para>Indicates the longitude. The longitude is expressed as three RATIONAL values giving the degrees, minutes, and seconds, respectively. When degrees, minutes and seconds are expressed, the format is ddd/1,mm/1,ss/1. When degrees and minutes are used and, for example, fractions of minutes are given up to two decimal places, the format is ddd/1,mmmm/100,0/1.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.LongitudeRef</para></entry>
                        <entry><para>East or West Longitude</para></entry>
                        <entry><para>Indicates whether the longitude is east or west longitude. ASCII 'E' indicates east longitude, and 'W' is west longitude.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.GPS.VersionID</para></entry>
                        <entry><para>GPS Tag Version</para></entry>
                        <entry><para>Indicates the version of <literal>Exif.GPS.InfoIFD</literal>. This tag is mandatory when <literal>Exif.GPS.Info</literal> tag is present.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ImageDescription</para></entry>
                        <entry><para>Image Description</para></entry>
                        <entry><para>A character string giving the title of the image. Two-bytes character codes cannot be used. When a 2-bytes code is necessary, the Exif private tag <literal>Exif.UserComment</literal> is to be used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ImageLength</para></entry>
                        <entry><para>Image Length</para></entry>
                        <entry><para>The number of rows of image data. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ImageResources</para></entry>
                        <entry><para>Image Resources Block</para></entry>
                        <entry><para>Image Resources Block.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ImageUniqueID</para></entry>
                        <entry><para>Image Unique ID</para></entry>
                        <entry><para>This tag indicates an identifier assigned uniquely to each image. It is recorded as an ASCII string equivalent to hexadecimal notation and 128-bit fixed length.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ImageWidth</para></entry>
                        <entry><para>Image Width</para></entry>
                        <entry><para>The number of columns of image data, equal to the number of pixels per row. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.InterColorProfile</para></entry>
                        <entry><para>Inter Color Profile</para></entry>
                        <entry><para>Inter Color Profile.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.InteroperabilityIFDPointer</para></entry>
                        <entry><para>Interoperability IFD Pointer</para></entry>
                        <entry><para>Interoperability IFD is composed of tags which stores the information to ensure the Interoperability and pointed by the following tag located in Exif IFD. The Interoperability structure of Interoperability IFD is the same as TIFF defined IFD structure but does not contain the image data characteristically compared with normal TIFF IFD.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.InteroperabilityIndex</para></entry>
                        <entry><para>Interoperability Index</para></entry>
                        <entry><para>Indicates the identification of the Interoperability rule. Use "R98" for stating ExifR98 Rules.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.InteroperabilityVersion</para></entry>
                        <entry><para>Interoperability Version</para></entry>
                        <entry><para>Interoperability version.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ISOSpeedRatings</para></entry>
                        <entry><para>ISO Speed Ratings</para></entry>
                        <entry><para>The ISO Speed and ISO Latitude of the camera or input device as specified in ISO 12232.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.JPEGInterchangeFormat</para></entry>
                        <entry><para>JPEG Interchange Format</para></entry>
                        <entry><para>The offset to the start byte (SOI) of JPEG compressed thumbnail data. This is not used for primary image JPEG data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.JPEGInterchangeFormatLength</para></entry>
                        <entry><para>JPEG Interchange Format Length</para></entry>
                        <entry><para>The number of bytes of JPEG compressed thumbnail data. This is not used for primary image JPEG data. JPEG thumbnails are not divided but are recorded as a continuous JPEG bitstream from SOI to EOI. Appn and COM markers should not be recorded. Compressed thumbnails must be recorded in no more than 64 Kbytes, including all other data to be recorded in APP1.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.JPEGProc</para></entry>
                        <entry><para>JPEG Procedure</para></entry>
                        <entry><para>JPEG procedure.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.LightSource</para></entry>
                        <entry><para>Light Source</para></entry>
                        <entry><para>The kind of light source.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Make</para></entry>
                        <entry><para>Manufacturer</para></entry>
                        <entry><para>The manufacturer of the recording equipment. This is the manufacturer of the DSC, scanner, video digitizer or other equipment that generated the image. When the field is left blank, it is treated as unknown.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.MakerNote</para></entry>
                        <entry><para>Maker Note</para></entry>
                        <entry><para>A tag for manufacturers of Exif writers to record any desired information. The contents are up to the manufacturer.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.MaxApertureValue</para></entry>
                        <entry><para>Max Aperture Value</para></entry>
                        <entry><para>The smallest F number of the lens. The unit is the APEX value. Ordinarily it is given in the range of 00.00 to 99.99, but it is not limited to this range.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.MeteringMode</para></entry>
                        <entry><para>Metering Mode</para></entry>
                        <entry><para>The metering mode.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Model</para></entry>
                        <entry><para>Model</para></entry>
                        <entry><para>The model name or model number of the equipment. This is the model name or number of the DSC, scanner, video digitizer or other equipment that generated the image. When the field is left blank, it is treated as unknown.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.CFAPattern</para></entry>
                        <entry><para>CFA Pattern</para></entry>
                        <entry><para>The color filter array (CFA) geometric pattern of the image sensor when a one-chip color area sensor is used. It does not apply to all sensing methods.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.NewSubfileType</para></entry>
                        <entry><para>New Subfile Type</para></entry>
                        <entry><para>A general indication of the kind of data contained in this subfile.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.OECF</para></entry>
                        <entry><para>OECF</para></entry>
                        <entry><para>The Opto-Electronic Conversion Function (OECF) specified in ISO 14524. <literal>Exif.OECF</literal> is the relationship between the camera optical input and the image values.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Orientation</para></entry>
                        <entry><para>Orientation</para></entry>
                        <entry><para>The image orientation viewed in terms of rows and columns.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.PhotometricInterpretation</para></entry>
                        <entry><para>Photometric Interpretation</para></entry>
                        <entry><para>The pixel composition. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.PixelXDimension</para></entry>
                        <entry><para>Pixel X Dimension</para></entry>
                        <entry><para>Information specific to compressed data. When a compressed file is recorded, the valid width of the meaningful image must be recorded in this tag, whether or not there is padding data or a restart marker. This tag should not exist in an uncompressed file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.PixelYDimension</para></entry>
                        <entry><para>Pixel Y Dimension</para></entry>
                        <entry><para>Information specific to compressed data. When a compressed file is recorded, the valid height of the meaningful image must be recorded in this tag, whether or not there is padding data or a restart marker. This tag should not exist in an uncompressed file. Since data padding is unnecessary in the vertical direction, the number of lines recorded in this valid image height tag will in fact be the same as that recorded in the SOF.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.PlanarConfiguration</para></entry>
                        <entry><para>Planar Configuration</para></entry>
                        <entry><para>Indicates whether pixel components are recorded in a chunky or planar format. In JPEG compressed files a JPEG marker is used instead of this tag. If this field does not exist, the TIFF default of 1 (chunky) is assumed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.PrimaryChromaticities</para></entry>
                        <entry><para>Primary Chromaticities</para></entry>
                        <entry><para>The chromaticity of the three primary colors of the image. Normally this tag is not necessary, since colorspace is specified in <literal>Exif.ColorSpace</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ReferenceBlackWhite</para></entry>
                        <entry><para>Reference Black/White</para></entry>
                        <entry><para>The reference black point value and reference white point value. No defaults are given in TIFF, but the values below are given as defaults here. The color space is declared in a color space information tag, with the default being the value that gives the optimal image characteristics Interoperability these conditions.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.RelatedImageFileFormat</para></entry>
                        <entry><para>Related Image File Format</para></entry>
                        <entry><para>Related image file format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.RelatedImageLength</para></entry>
                        <entry><para>Related Image Length</para></entry>
                        <entry><para>Related image length.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.RelatedImageWidth</para></entry>
                        <entry><para>Related Image Width</para></entry>
                        <entry><para>Related image width.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.RelatedSoundFile</para></entry>
                        <entry><para>Related Sound File</para></entry>
                        <entry><para>This tag is used to record the name of an audio file related to the image data. The only relational information recorded here is the Exif audio file name and extension (an ASCII string consisting of 8 characters + '.' + 3 characters). The path is not recorded. When using this tag, audio files must be recorded in conformance to the Exif audio format. Writers are also allowed to store the data such as Audio within APP2 as FlashPix extension stream data. Audio files must be recorded in conformance to the Exif audio format. If multiple files are mapped to one file, the above format is used to record just one audio file name. If there are multiple audio files, the first recorded file is given. When there are three Exif audio files "SND00001.WAV", "SND00002.WAV" and "SND00003.WAV", the Exif image file name for each of them, "DSC00001.JPG", is indicated. By combining multiple relational information, a variety of playback possibilities can be supported. The method of using relational information is left to the implementation on the playback side. Since this information is an ASCII character string, it is terminated by NULL. When this tag is used to map audio files, the relation of the audio file to image data must also be indicated on the audio file end.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ResolutionUnit</para></entry>
                        <entry><para>Resolution Unit</para></entry>
                        <entry><para>The unit for measuring <literal>Exif.XResolution</literal> and <literal>Exif.YResolution</literal>. The same unit is used for both <literal>Exif.XResolution</literal> and <literal>Exif.YResolution</literal>. If the image resolution is unknown, 2 (inches) is designated.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.RowsPerStrip</para></entry>
                        <entry><para>Rows per Strip</para></entry>
                        <entry><para>The number of rows per strip. This is the number of rows in the image of one strip when an image is divided into strips. With JPEG compressed data this designation is not needed and is omitted.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SamplesPerPixel</para></entry>
                        <entry><para>Samples per Pixel</para></entry>
                        <entry><para>The number of components per pixel. Since this standard applies to RGB and YCbCr images, the value set for this tag is 3. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Saturation</para></entry>
                        <entry><para>Saturation</para></entry>
                        <entry><para>The direction of saturation processing applied by the camera when the image was shot.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SceneCaptureType</para></entry>
                        <entry><para>Scene Capture Type</para></entry>
                        <entry><para>The type of scene that was shot. It can also be used to record the mode in which the image was shot. Note that this differs from <literal>Exif.SceneType</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SceneType</para></entry>
                        <entry><para>Scene Type</para></entry>
                        <entry><para>The type of scene. If a DSC recorded the image, this tag value must always be set to 1, indicating that the image was directly photographed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SensingMethod</para></entry>
                        <entry><para>Sensing Method</para></entry>
                        <entry><para>The image sensor type on the camera or input device.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Sharpness</para></entry>
                        <entry><para>Sharpness</para></entry>
                        <entry><para>The direction of sharpness processing applied by the camera when the image was shot.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.ShutterSpeedValue</para></entry>
                        <entry><para>Shutter Speed</para></entry>
                        <entry><para>Shutter speed. The unit is the APEX (Additive System of Photographic Exposure) setting.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.Software</para></entry>
                        <entry><para>Software</para></entry>
                        <entry><para>This tag records the name and version of the software or firmware of the camera or image input device used to generate the image. When the field is left blank, it is treated as unknown.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SpatialFrequencyResponse</para></entry>
                        <entry><para>Spatial Frequency Response</para></entry>
                        <entry><para>This tag records the camera or input device spatial frequency table and SFR values in the direction of image width, image height, and diagonal direction, as specified in ISO 12233.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SpectralSensitivity</para></entry>
                        <entry><para>Spectral Sensitivity</para></entry>
                        <entry><para>The spectral sensitivity of each channel of the camera used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.StripByteCounts</para></entry>
                        <entry><para>Strip Byte Count</para></entry>
                        <entry><para>The total number of bytes in each strip. With JPEG compressed data this designation is not needed and is omitted.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.StripOffsets</para></entry>
                        <entry><para>Strip Offsets</para></entry>
                        <entry><para>For each strip, the byte offset of that strip. It is recommended that this be selected so the number of strip bytes does not exceed 64 Kbytes. With JPEG compressed data this designation is not needed and is omitted.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubIFDs</para></entry>
                        <entry><para>Sub IFD Offsets</para></entry>
                        <entry><para>Defined by Adobe Corporation to enable TIFF Trees within a TIFF file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubjectArea</para></entry>
                        <entry><para>Subject Area</para></entry>
                        <entry><para>The location and area of the main subject in the overall scene.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubjectDistance</para></entry>
                        <entry><para>Subject Distance</para></entry>
                        <entry><para>The distance to the subject, given in meters.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubjectDistanceRange</para></entry>
                        <entry><para>Subject Distance Range</para></entry>
                        <entry><para>The distance to the subject.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubjectLocation</para></entry>
                        <entry><para>Subject Location</para></entry>
                        <entry><para>The location of the main subject in the scene. The value of this tag represents the pixel at the center of the main subject relative to the left edge, prior to rotation processing as per the <literal>Exif.Rotation</literal> tag. The first value indicates the X column number and second indicates the Y row number.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubsecTime</para></entry>
                        <entry><para>Subsec Time</para></entry>
                        <entry><para>Fractions of seconds for the <literal>Exif.DateTime</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubSecTimeDigitized</para></entry>
                        <entry><para>Subsec Time Digitized</para></entry>
                        <entry><para>Fractions of seconds for the <literal>Exif.DateTimeDigitized</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.SubSecTimeOriginal</para></entry>
                        <entry><para>Subsec Time Original</para></entry>
                        <entry><para>Fractions of seconds for the <literal>Exif.DateTimeOriginal</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.TIFF_EPStandardID</para></entry>
                        <entry><para>TIFF/EP Standard ID</para></entry>
                        <entry><para>TIFF/EP Standard ID.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.TransferFunction</para></entry>
                        <entry><para>Transfer Function</para></entry>
                        <entry><para>A transfer function for the image, described in tabular style. Normally this tag is not necessary, since color space is specified in <literal>Exif.ColorSpace</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.TransferRange</para></entry>
                        <entry><para>Transfer Range</para></entry>
                        <entry><para>Transfer range.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.UserComment</para></entry>
                        <entry><para>User Comment</para></entry>
                        <entry><para>A tag for Exif users to write keywords or comments on the image besides those in <literal>Exif.ImageDescription</literal>, and without the character code limitations of the <literal>Exif.ImageDescription</literal> tag. The character code used in the <literal>Exif.UserComment</literal> tag is identified based on an ID code in a fixed 8-byte area at the start of the tag data area. The unused portion of the area is padded with NULL ("00.h"). ID codes are assigned by means of registration. The value of CountN is determinated based on the 8 bytes in the character code area and the number of bytes in the user comment part. Since the TYPE is not ASCII, NULL termination is not necessary. The ID code for the <literal>Exif.UserComment</literal> area may be a Defined code such as JIS or ASCII, or may be Undefined. The Undefined name is UndefinedText, and the ID code is filled with 8 bytes of all "NULL" ("00.H"). An Exif reader that reads the <literal>Exif.UserComment</literal> tag must have a function for determining the ID code. This function is not required in Exif readers that do not use the <literal>Exif.UserComment</literal> tag. When a <literal>Exif.UserComment</literal> area is set aside, it is recommended that the ID code be ASCII and that the following user comment part be filled with blank characters [20.H].</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.WhiteBalance</para></entry>
                        <entry><para>White Balance</para></entry>
                        <entry><para>The white balance mode set when the image was shot.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.WhitePoint</para></entry>
                        <entry><para>White Point</para></entry>
                        <entry><para>The chromaticity of the white point of the image. Normally this tag is not necessary, since color space is specified in <literal>Exif.ColorSpace</literal> tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.XMLPacket</para></entry>
                        <entry><para>XML Packet</para></entry>
                        <entry><para>XMP metadata.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.XResolution</para></entry>
                        <entry><para>x Resolution</para></entry>
                        <entry><para>The number of pixels per <literal>Exif.ResolutionUnit</literal> in the <literal>Exif.ImageWidth</literal> direction. When the image resolution is unknown, 72 [dpi] is designated.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.YCbCrCoefficients</para></entry>
                        <entry><para>YCbCr Coefficients</para></entry>
                        <entry><para>The matrix coefficients for transformation from RGB to YCbCr image data. No default is given in TIFF; but here "Color Space Guidelines" is used as the default. The color space is declared in a color space information tag, with the default being the value that gives the optimal image characteristics Interoperability this condition.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.YCbCrPositioning</para></entry>
                        <entry><para>YCbCr Positioning</para></entry>
                        <entry><para>The position of chrominance components in relation to the luminance component. This field is designated only for JPEG compressed data or uncompressed YCbCr data. The TIFF default is 1 (centered); but when Y:Cb:Cr = 4:2:2 it is recommended that 2 (co-sited) be used to record data, in order to improve the image quality when viewed on TV systems. When this field does not exist, the reader shall assume the TIFF default. In the case of Y:Cb:Cr = 4:2:0, the TIFF default (centered) is recommended. If the reader does not have the capability of supporting both kinds of <literal>Exif.YCbCrPositioning</literal>, it shall follow the TIFF default regardless of the value in this field. It is preferable that readers be able to support both centered and co-sited positioning.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.YCbCrSubSampling</para></entry>
                        <entry><para>YCbCr Sub-Sampling</para></entry>
                        <entry><para>The sampling ratio of chrominance components in relation to the luminance component. In JPEG compressed data a JPEG marker is used instead of this tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Exif.YResolution</para></entry>
                        <entry><para>y Resolution</para></entry>
                        <entry><para>The number of pixels per <literal>Exif.ResolutionUnit</literal> in the <literal>Exif.ImageLength</literal> direction. The same value as <literal>Exif.XResolution</literal> is designated.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Accessed</para></entry>
                        <entry><para>Accessed</para></entry>
                        <entry><para>Last access datetime.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Content</para></entry>
                        <entry><para>Content</para></entry>
                        <entry><para>File's contents filtered as plain text.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Description</para></entry>
                        <entry><para>Description</para></entry>
                        <entry><para>Editable free text/notes.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Format</para></entry>
                        <entry><para>Format</para></entry>
                        <entry><para>MIME type of the file or if a directory it should contain value "Folder".</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Keywords</para></entry>
                        <entry><para>Keywords</para></entry>
                        <entry><para>Editable array of keywords.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Link</para></entry>
                        <entry><para>Link</para></entry>
                        <entry><para>URI of link target.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Modified</para></entry>
                        <entry><para>Modified</para></entry>
                        <entry><para>Last modified datetime.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Name</para></entry>
                        <entry><para>Name</para></entry>
                        <entry><para>File name excluding path but including the file extension.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Path</para></entry>
                        <entry><para>Path</para></entry>
                        <entry><para>Full file path of file excluding the file name.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Permissions</para></entry>
                        <entry><para>Permissions</para></entry>
                        <entry><para>Permission string in unix format eg "-rw-r--r--".</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Publisher</para></entry>
                        <entry><para>Publisher</para></entry>
                        <entry><para>Editable DC type for the name of the publisher of the file (EG dc:publisher field in RSS feed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Rank</para></entry>
                        <entry><para>Rank</para></entry>
                        <entry><para>Editable file rank for grading favourites. Value should be in the range 1..10.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>File.Size</para></entry>
                        <entry><para>Size</para></entry>
                        <entry><para>Size of the file in bytes or if a directory number of items it contains.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.AlbumSortOrder</para></entry>
                        <entry><para>Album Sort Order</para></entry>
                        <entry><para>String which should be used instead of the album name for sorting purposes.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.AudioCrypto</para></entry>
                        <entry><para>Audio Encryption</para></entry>
                        <entry><para>Frame indicates if the audio stream is encrypted, and by whom.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.AudioSeekPoint</para></entry>
                        <entry><para>Audio Seek Point</para></entry>
                        <entry><para>Fractional offset within the audio data, providing a starting point from which to find an appropriate point to start decoding.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Band</para></entry>
                        <entry><para>Band</para></entry>
                        <entry><para>Additional information about the performers in the recording.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.BPM</para></entry>
                        <entry><para>BPM</para></entry>
                        <entry><para>BPM (beats per minute).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.BufferSize</para></entry>
                        <entry><para>Buffer Size</para></entry>
                        <entry><para>Recommended buffer size.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.CDID</para></entry>
                        <entry><para>CD ID</para></entry>
                        <entry><para>Music CD identifier.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Commercial</para></entry>
                        <entry><para>Commercial</para></entry>
                        <entry><para>Commercial frame.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Composer</para></entry>
                        <entry><para>Composer</para></entry>
                        <entry><para>Composer.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Conductor</para></entry>
                        <entry><para>Conductor</para></entry>
                        <entry><para>Conductor.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.ContentGroup</para></entry>
                        <entry><para>Content Group</para></entry>
                        <entry><para>Content group description.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.ContentType</para></entry>
                        <entry><para>Content Type</para></entry>
                        <entry><para>Type of music classification for the track as defined in ID3 spec.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Copyright</para></entry>
                        <entry><para>Copyright</para></entry>
                        <entry><para>Copyright message.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.CryptoReg</para></entry>
                        <entry><para>Encryption Registration</para></entry>
                        <entry><para>Encryption method registration.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Date</para></entry>
                        <entry><para>Date</para></entry>
                        <entry><para>Date.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Emphasis</para></entry>
                        <entry><para>Emphasis</para></entry>
                        <entry><para>Emphasis.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.EncodedBy</para></entry>
                        <entry><para>Encoded By</para></entry>
                        <entry><para>Person or organisation that encoded the audio file. This field may contain a copyright message, if the audio file also is copyrighted by the encoder.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.EncoderSettings</para></entry>
                        <entry><para>Encoder Settings</para></entry>
                        <entry><para>Software.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.EncodingTime</para></entry>
                        <entry><para>Encoding Time</para></entry>
                        <entry><para>Encoding time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Equalization</para></entry>
                        <entry><para>Equalization</para></entry>
                        <entry><para>Equalization.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Equalization2</para></entry>
                        <entry><para>Equalization 2</para></entry>
                        <entry><para>Equalisation curve predefine within the audio file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.EventTiming</para></entry>
                        <entry><para>Event Timing</para></entry>
                        <entry><para>Event timing codes.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.FileOwner</para></entry>
                        <entry><para>File Owner</para></entry>
                        <entry><para>File owner.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.FileType</para></entry>
                        <entry><para>File Type</para></entry>
                        <entry><para>File type.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Frames</para></entry>
                        <entry><para>Frames</para></entry>
                        <entry><para>Number of frames.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.GeneralObject</para></entry>
                        <entry><para>General Object</para></entry>
                        <entry><para>General encapsulated object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.GroupingReg</para></entry>
                        <entry><para>Grouping Registration</para></entry>
                        <entry><para>Group identification registration.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.InitialKey</para></entry>
                        <entry><para>Initial Key</para></entry>
                        <entry><para>Initial key.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.InvolvedPeople</para></entry>
                        <entry><para>Involved People</para></entry>
                        <entry><para>Involved people list.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.InvolvedPeople2</para></entry>
                        <entry><para>InvolvedPeople2</para></entry>
                        <entry><para>Involved people list.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Language</para></entry>
                        <entry><para>Language</para></entry>
                        <entry><para>Language.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.LinkedInfo</para></entry>
                        <entry><para>Linked Info</para></entry>
                        <entry><para>Linked information.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Lyricist</para></entry>
                        <entry><para>Lyricist</para></entry>
                        <entry><para>Lyricist.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.MediaType</para></entry>
                        <entry><para>Media Type</para></entry>
                        <entry><para>Media type.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.MixArtist</para></entry>
                        <entry><para>Mix Artist</para></entry>
                        <entry><para>Interpreted, remixed, or otherwise modified by.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Mood</para></entry>
                        <entry><para>Mood</para></entry>
                        <entry><para>Mood.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.MPEG.Lookup</para></entry>
                        <entry><para>MPEG Lookup</para></entry>
                        <entry><para>MPEG location lookup table.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.MusicianCreditList</para></entry>
                        <entry><para>Musician Credit List</para></entry>
                        <entry><para>Musician credits list.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.NetRadioOwner</para></entry>
                        <entry><para>Net Radio Owner</para></entry>
                        <entry><para>Internet radio station owner.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.NetRadiostation</para></entry>
                        <entry><para>Net Radiostation</para></entry>
                        <entry><para>Internet radio station name.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalAlbum</para></entry>
                        <entry><para>Original Album</para></entry>
                        <entry><para>Original album.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalArtist</para></entry>
                        <entry><para>Original Artist</para></entry>
                        <entry><para>Original artist.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalFileName</para></entry>
                        <entry><para>Original File Name</para></entry>
                        <entry><para>Original file name.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalLyricist</para></entry>
                        <entry><para>Original Lyricist</para></entry>
                        <entry><para>Original lyricist.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalReleaseTime</para></entry>
                        <entry><para>Original Release Time</para></entry>
                        <entry><para>Original release time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.OriginalYear</para></entry>
                        <entry><para>Original Year</para></entry>
                        <entry><para>Original release year.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Ownership</para></entry>
                        <entry><para>Ownership</para></entry>
                        <entry><para>Ownership frame.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.PartInSet</para></entry>
                        <entry><para>Part of a Set</para></entry>
                        <entry><para>Part of a set the audio came from.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.PerformerSortOrder</para></entry>
                        <entry><para>Performer Sort Order</para></entry>
                        <entry><para>Performer sort order.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Picture</para></entry>
                        <entry><para>Picture</para></entry>
                        <entry><para>Attached picture.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.PlayCounter</para></entry>
                        <entry><para>Play Counter</para></entry>
                        <entry><para>Number of times a file has been played.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.PlaylistDelay</para></entry>
                        <entry><para>Playlist Delay</para></entry>
                        <entry><para>Playlist delay.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Popularimeter</para></entry>
                        <entry><para>Popularimeter</para></entry>
                        <entry><para>Rating of the audio file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.PositionSync</para></entry>
                        <entry><para>Position Sync</para></entry>
                        <entry><para>Position synchronisation frame.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Private</para></entry>
                        <entry><para>Private</para></entry>
                        <entry><para>Private frame.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.ProducedNotice</para></entry>
                        <entry><para>Produced Notice</para></entry>
                        <entry><para>Produced notice.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Publisher</para></entry>
                        <entry><para>Publisher</para></entry>
                        <entry><para>Publisher.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.RecordingDates</para></entry>
                        <entry><para>Recording Dates</para></entry>
                        <entry><para>Recording dates.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.RecordingTime</para></entry>
                        <entry><para>Recording Time</para></entry>
                        <entry><para>Recording time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.ReleaseTime</para></entry>
                        <entry><para>Release Time</para></entry>
                        <entry><para>Release time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Reverb</para></entry>
                        <entry><para>Reverb</para></entry>
                        <entry><para>Reverb.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.SetSubtitle</para></entry>
                        <entry><para>Set Subtitle</para></entry>
                        <entry><para>Subtitle of the part of a set this track belongs to.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Signature</para></entry>
                        <entry><para>Signature</para></entry>
                        <entry><para>Signature frame.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Size</para></entry>
                        <entry><para>Size</para></entry>
                        <entry><para>Size of the audio file in bytes, excluding the ID3 tag.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.SongLength</para></entry>
                        <entry><para>Song length</para></entry>
                        <entry><para>Length of the song in milliseconds.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Subtitle</para></entry>
                        <entry><para>Subtitle</para></entry>
                        <entry><para>Subtitle.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Syncedlyrics</para></entry>
                        <entry><para>Synchronized Lyrics</para></entry>
                        <entry><para>Synchronized lyric.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.SyncedTempo</para></entry>
                        <entry><para>Synchronized Tempo</para></entry>
                        <entry><para>Synchronized tempo codes.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.TaggingTime</para></entry>
                        <entry><para>Tagging Time</para></entry>
                        <entry><para>Tagging time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.TermsOfUse</para></entry>
                        <entry><para>Terms of Use</para></entry>
                        <entry><para>Terms of use.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.Time</para></entry>
                        <entry><para>Time</para></entry>
                        <entry><para>Time.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.TitleSortOrder</para></entry>
                        <entry><para>Title Sort Order</para></entry>
                        <entry><para>Title sort order.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.UniqueFileID</para></entry>
                        <entry><para>Unique File ID</para></entry>
                        <entry><para>Unique file identifier.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.UnsyncedLyrics</para></entry>
                        <entry><para>Unsynchronized Lyrics</para></entry>
                        <entry><para>Unsynchronized lyric.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.UserText</para></entry>
                        <entry><para>User Text</para></entry>
                        <entry><para>User defined text information.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.VolumeAdj</para></entry>
                        <entry><para>Volume Adjustment</para></entry>
                        <entry><para>Relative volume adjustment.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.VolumeAdj2</para></entry>
                        <entry><para>Volume Adjustment 2</para></entry>
                        <entry><para>Relative volume adjustment.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWArtist</para></entry>
                        <entry><para>WWW Artist</para></entry>
                        <entry><para>Official artist.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWAudioFile</para></entry>
                        <entry><para>WWW Audio File</para></entry>
                        <entry><para>Official audio file webpage.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWAudioSource</para></entry>
                        <entry><para>WWW Audio Source</para></entry>
                        <entry><para>Official audio source webpage.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWCommercialInfo</para></entry>
                        <entry><para>WWW Commercial Info</para></entry>
                        <entry><para>URL pointing at a webpage containing commercial information.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWCopyright</para></entry>
                        <entry><para>WWW Copyright</para></entry>
                        <entry><para>URL pointing at a webpage that holds copyright.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWPayment</para></entry>
                        <entry><para>WWW Payment</para></entry>
                        <entry><para>URL pointing at a webpage that will handle the process of paying for this file.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWPublisher</para></entry>
                        <entry><para>WWW Publisher</para></entry>
                        <entry><para>URL pointing at the official webpage for the publisher.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWRadioPage</para></entry>
                        <entry><para>WWW Radio Page</para></entry>
                        <entry><para>Official internet radio station homepage.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>ID3.WWWUser</para></entry>
                        <entry><para>WWW User</para></entry>
                        <entry><para>User defined URL link.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Album</para></entry>
                        <entry><para>Album</para></entry>
                        <entry><para>Name of an album the image belongs to.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Comments</para></entry>
                        <entry><para>Comments</para></entry>
                        <entry><para>User definable free text.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Copyright</para></entry>
                        <entry><para>Copyright</para></entry>
                        <entry><para>Embedded copyright message.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Creator</para></entry>
                        <entry><para>Creator</para></entry>
                        <entry><para>Name of the author.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Date</para></entry>
                        <entry><para>Date</para></entry>
                        <entry><para>Datetime image was originally created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Description</para></entry>
                        <entry><para>Description</para></entry>
                        <entry><para>Description of the image.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.ExposureProgram</para></entry>
                        <entry><para>Exposure Program</para></entry>
                        <entry><para>The program used by the camera to set exposure when the picture is taken. EG Manual, Normal, Aperture priority etc.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.ExposureTime</para></entry>
                        <entry><para>Exposure Time</para></entry>
                        <entry><para>Exposure time used to capture the photo in seconds.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Flash</para></entry>
                        <entry><para>Flash</para></entry>
                        <entry><para>Set to "1" if flash was fired.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Fnumber</para></entry>
                        <entry><para>F Number</para></entry>
                        <entry><para>Diameter of the aperture relative to the effective focal length of the lens.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.FocalLength</para></entry>
                        <entry><para>Focal Length</para></entry>
                        <entry><para>Focal length of lens in mm.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Height</para></entry>
                        <entry><para>Height</para></entry>
                        <entry><para>Height in pixels.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.ISOSpeed</para></entry>
                        <entry><para>ISO Speed</para></entry>
                        <entry><para>ISO speed used to acquire the document contents. For example, 100, 200, 400, etc.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Keywords</para></entry>
                        <entry><para>Keywords</para></entry>
                        <entry><para>String of keywords.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Make</para></entry>
                        <entry><para>Make</para></entry>
                        <entry><para>Make of camera used to take the image.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.MeteringMode</para></entry>
                        <entry><para>Metering Mode</para></entry>
                        <entry><para>Metering mode used to acquire the image (IE Unknown, Average, CenterWeightedAverage, Spot, MultiSpot, Pattern, Partial).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Model</para></entry>
                        <entry><para>Model</para></entry>
                        <entry><para>Model of camera used to take the image.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Orientation</para></entry>
                        <entry><para>Orientation</para></entry>
                        <entry><para>Represents the orientation of the image wrt camera (IE "top,left" or "bottom,right").</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Software</para></entry>
                        <entry><para>Software</para></entry>
                        <entry><para>Software used to produce/enhance the image.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Title</para></entry>
                        <entry><para>Title</para></entry>
                        <entry><para>Title of image.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.WhiteBalance</para></entry>
                        <entry><para>White Balance</para></entry>
                        <entry><para>White balance setting of the camera when the picture was taken (auto or manual).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Image.Width</para></entry>
                        <entry><para>Width</para></entry>
                        <entry><para>Width in pixels.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ActionAdvised</para></entry>
                        <entry><para>Action Advised</para></entry>
                        <entry><para>The type of action that this object provides to a previous object. '01' Object Kill, '02' Object Replace, '03' Object Append, '04' Object Reference.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ARMID</para></entry>
                        <entry><para>ARM Identifier</para></entry>
                        <entry><para>Identifies the Abstract Relationship Method (ARM).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ARMVersion</para></entry>
                        <entry><para>ARM Version</para></entry>
                        <entry><para>Identifies the version of the Abstract Relationship Method (ARM).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.AudioDuration</para></entry>
                        <entry><para>Audio Duration</para></entry>
                        <entry><para>The running time of the audio data in the form HHMMSS.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.AudioOutcue</para></entry>
                        <entry><para>Audio Outcue</para></entry>
                        <entry><para>The content at the end of the audio data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.AudioSamplingRate</para></entry>
                        <entry><para>Audio Sampling Rate</para></entry>
                        <entry><para>The sampling rate in Hz of the audio data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.AudioSamplingRes</para></entry>
                        <entry><para>Audio Sampling Resolution</para></entry>
                        <entry><para>The number of bits in each audio sample.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.AudioType</para></entry>
                        <entry><para>Audio Type</para></entry>
                        <entry><para>The number of channels and type of audio (music, text, etc.) in the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Byline</para></entry>
                        <entry><para>By-line</para></entry>
                        <entry><para>Name of the creator of the object, e.g. writer, photographer or graphic artist (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.BylineTitle</para></entry>
                        <entry><para>By-line Title</para></entry>
                        <entry><para>Title of the creator or creators of the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Caption</para></entry>
                        <entry><para>Caption, Abstract</para></entry>
                        <entry><para>A textual description of the data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Category</para></entry>
                        <entry><para>Category</para></entry>
                        <entry><para>Identifies the subject of the object in the opinion of the provider (Deprecated).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.CharacterSet</para></entry>
                        <entry><para>Coded Character Set</para></entry>
                        <entry><para>Control functions used for the announcement, invocation or designation of coded character sets.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.City</para></entry>
                        <entry><para>City</para></entry>
                        <entry><para>City of object origin.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ConfirmedDataSize</para></entry>
                        <entry><para>Confirmed Data Size</para></entry>
                        <entry><para>Total size of the object data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Contact</para></entry>
                        <entry><para>Contact</para></entry>
                        <entry><para>The person or organization which can provide further background information on the object (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ContentLocCode</para></entry>
                        <entry><para>Content Location Code</para></entry>
                        <entry><para>The code of a country/geographical location referenced by the content of the object (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ContentLocName</para></entry>
                        <entry><para>Content Location Name</para></entry>
                        <entry><para>A full, publishable name of a country/geographical location referenced by the content of the object (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.CopyrightNotice</para></entry>
                        <entry><para>Copyright Notice</para></entry>
                        <entry><para>Any necessary copyright notice.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.CountryCode</para></entry>
                        <entry><para>Country Code</para></entry>
                        <entry><para>The code of the country/primary location where the object was created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.CountryName</para></entry>
                        <entry><para>Country Name</para></entry>
                        <entry><para>The name of the country/primary location where the object was created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Credit</para></entry>
                        <entry><para>Credit</para></entry>
                        <entry><para>Identifies the provider of the object, not necessarily the owner/creator.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.DateCreated</para></entry>
                        <entry><para>Date Created</para></entry>
                        <entry><para>The date the intellectual content of the object was created rather than the date of the creation of the physical representation.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.DateSent</para></entry>
                        <entry><para>Date Sent</para></entry>
                        <entry><para>The day the service sent the material.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Destination</para></entry>
                        <entry><para>Destination</para></entry>
                        <entry><para>Routing information.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.DigitalCreationDate</para></entry>
                        <entry><para>Digital Creation Date</para></entry>
                        <entry><para>The date the digital representation of the object was created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.DigitalCreationTime</para></entry>
                        <entry><para>Digital Creation Time</para></entry>
                        <entry><para>The time the digital representation of the object was created.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.EditorialUpdate</para></entry>
                        <entry><para>Editorial Update</para></entry>
                        <entry><para>The type of update this object provides to a previous object. The link to the previous object is made using the ARM. '01' indicates an additional language.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.EditStatus</para></entry>
                        <entry><para>Edit Status</para></entry>
                        <entry><para>Status of the object, according to the practice of the provider.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.EnvelopeNum</para></entry>
                        <entry><para>Envelope Number</para></entry>
                        <entry><para>A number unique for the date and the service ID.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.EnvelopePriority</para></entry>
                        <entry><para>Envelope Priority</para></entry>
                        <entry><para>Specifies the envelope handling priority and not the editorial urgency. '1' for most urgent, '5' for normal, and '8' for least urgent. '9' is user-defined.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ExpirationDate</para></entry>
                        <entry><para>Expiration Date</para></entry>
                        <entry><para>Designates the latest date the provider intends the object to be used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ExpirationTime</para></entry>
                        <entry><para>Expiration Time</para></entry>
                        <entry><para>Designates the latest time the provider intends the object to be used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.FileFormat</para></entry>
                        <entry><para>File Format</para></entry>
                        <entry><para>File format of the data described by this metadata.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.FileVersion</para></entry>
                        <entry><para>File Version</para></entry>
                        <entry><para>Version of the file format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.FixtureID</para></entry>
                        <entry><para>Fixture Identifier</para></entry>
                        <entry><para>Identifies objects that recur often and predictably, enabling users to immediately find or recall such an object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Headline</para></entry>
                        <entry><para>Headline</para></entry>
                        <entry><para>A publishable entry providing a synopsis of the contents of the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ImageOrientation</para></entry>
                        <entry><para>Image Orientation</para></entry>
                        <entry><para>The layout of the image area: 'P' for portrait, 'L' for landscape, and 'S' for square.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ImageType</para></entry>
                        <entry><para>Image Type</para></entry>
                        <entry><para>The data format of the image object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Keywords</para></entry>
                        <entry><para>Keywords</para></entry>
                        <entry><para>Used to indicate specific information retrieval words (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.LanguageID</para></entry>
                        <entry><para>Language Identifier</para></entry>
                        <entry><para>The major national language of the object, according to the 2-letter codes of ISO 639:1988.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.MaxObjectSize</para></entry>
                        <entry><para>Maximum Object Size</para></entry>
                        <entry><para>The largest possible size of the object if the size is not known.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.MaxSubfileSize</para></entry>
                        <entry><para>Max Subfile Size</para></entry>
                        <entry><para>The maximum size for a subfile dataset containing a portion of the object data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ModelVersion</para></entry>
                        <entry><para>Model Version</para></entry>
                        <entry><para>Version of IIM part 1.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ObjectAttribute</para></entry>
                        <entry><para>Object Attribute Reference</para></entry>
                        <entry><para>Defines the nature of the object independent of the subject (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ObjectCycle</para></entry>
                        <entry><para>Object Cycle</para></entry>
                        <entry><para>Where 'a' is morning, 'p' is evening, 'b' is both.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ObjectName</para></entry>
                        <entry><para>Object Name</para></entry>
                        <entry><para>A shorthand reference for the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ObjectSizeAnnounced</para></entry>
                        <entry><para>Object Size Announced</para></entry>
                        <entry><para>The total size of the object data if it is known.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ObjectType</para></entry>
                        <entry><para>Object Type Reference</para></entry>
                        <entry><para>Distinguishes between different types of objects within the IIM.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.OriginatingProgram</para></entry>
                        <entry><para>Originating Program</para></entry>
                        <entry><para>The type of program used to originate the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.OrigTransRef</para></entry>
                        <entry><para>Original Transmission Reference</para></entry>
                        <entry><para>A code representing the location of original transmission.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.PreviewData</para></entry>
                        <entry><para>Preview Data</para></entry>
                        <entry><para>The object preview data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.PreviewFileFormat</para></entry>
                        <entry><para>Preview File Format</para></entry>
                        <entry><para>Binary value indicating the file format of the object preview data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.PreviewFileFormatVer</para></entry>
                        <entry><para>Preview File Format Version</para></entry>
                        <entry><para>The version of the preview file format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ProductID</para></entry>
                        <entry><para>Product ID</para></entry>
                        <entry><para>Allows a provider to identify subsets of its overall service.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ProgramVersion</para></entry>
                        <entry><para>Program Version</para></entry>
                        <entry><para>The version of the originating program.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Province</para></entry>
                        <entry><para>Province, State</para></entry>
                        <entry><para>The Province/State where the object originates.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.RasterizedCaption</para></entry>
                        <entry><para>Rasterized Caption</para></entry>
                        <entry><para>Contains rasterized object description and is used where characters that have not been coded are required for the caption.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.RecordVersion</para></entry>
                        <entry><para>Record Version</para></entry>
                        <entry><para>Identifies the version of the IIM, Part 2.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.RefDate</para></entry>
                        <entry><para>Reference Date</para></entry>
                        <entry><para>The date of a prior envelope to which the current object refers.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.RefNumber</para></entry>
                        <entry><para>Reference Number</para></entry>
                        <entry><para>The Envelope Number of a prior envelope to which the current object refers.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.RefService</para></entry>
                        <entry><para>Reference Service</para></entry>
                        <entry><para>The Service Identifier of a prior envelope to which the current object refers.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ReleaseDate</para></entry>
                        <entry><para>Release Date</para></entry>
                        <entry><para>Designates the earliest date the provider intends the object to be used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ReleaseTime</para></entry>
                        <entry><para>Release Time</para></entry>
                        <entry><para>Designates the earliest time the provider intends the object to be used.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.ServiceID</para></entry>
                        <entry><para>Service Identifier</para></entry>
                        <entry><para>Identifies the provider and product.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.SizeMode</para></entry>
                        <entry><para>Size Mode</para></entry>
                        <entry><para>Set to 0 if the size of the object is known and 1 if not known.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Source</para></entry>
                        <entry><para>Source</para></entry>
                        <entry><para>The original owner of the intellectual content of the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.SpecialInstructions</para></entry>
                        <entry><para>Special Instructions</para></entry>
                        <entry><para>Other editorial instructions concerning the use of the object.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.State</para></entry>
                        <entry><para>Province, State</para></entry>
                        <entry><para>The Province/State where the object originates.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Subfile</para></entry>
                        <entry><para>Subfile</para></entry>
                        <entry><para>The object data itself. Subfiles must be sequential so that the subfiles may be reassembled.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.SubjectRef</para></entry>
                        <entry><para>Subject Reference</para></entry>
                        <entry><para>A structured definition of the subject matter. It must contain an IPR, an 8 digit Subject Reference Number and an optional Subject Name, Subject Matter Name, and Subject Detail Name each separated by a colon (:).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Sublocation</para></entry>
                        <entry><para>Sub-location</para></entry>
                        <entry><para>The location within a city from which the object originates.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.SupplCategory</para></entry>
                        <entry><para>Supplemental Category</para></entry>
                        <entry><para>Further refines the subject of the object (Deprecated).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.TimeCreated</para></entry>
                        <entry><para>Time Created</para></entry>
                        <entry><para>The time the intellectual content of the object was created rather than the date of the creation of the physical representation (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.TimeSent</para></entry>
                        <entry><para>Time Sent</para></entry>
                        <entry><para>The time the service sent the material.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.UNO</para></entry>
                        <entry><para>Unique Name of Object</para></entry>
                        <entry><para>An eternal, globally unique identification for the object, independent of provider and for any media form.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.Urgency</para></entry>
                        <entry><para>Urgency</para></entry>
                        <entry><para>Specifies the editorial urgency of content and not necessarily the envelope handling priority. '1' is most urgent, '5' normal, and '8' least urgent.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>IPTC.WriterEditor</para></entry>
                        <entry><para>Writer/Editor</para></entry>
                        <entry><para>The name of the person involved in the writing, editing or correcting the object or caption/abstract (multiple values allowed).</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.PageSize</para></entry>
                        <entry><para>Page Size</para></entry>
                        <entry><para>Page size format.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.PageWidth</para></entry>
                        <entry><para>Page Width</para></entry>
                        <entry><para>Page width in mm.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.PageHeight</para></entry>
                        <entry><para>Page Height</para></entry>
                        <entry><para>Page height in mm.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Version</para></entry>
                        <entry><para>PDF Version</para></entry>
                        <entry><para>The PDF version of the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Producer</para></entry>
                        <entry><para>Producer</para></entry>
                        <entry><para>The application that converted the document to PDF.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.EmbeddedFiles</para></entry>
                        <entry><para>Embedded Files</para></entry>
                        <entry><para>Number of embedded files in the document.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Optimized</para></entry>
                        <entry><para>Fast Web View</para></entry>
                        <entry><para>Set to "1" if optimized for network access.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Printing</para></entry>
                        <entry><para>Printing</para></entry>
                        <entry><para>Set to "1" if printing is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.HiResPrinting</para></entry>
                        <entry><para>Printing in High Resolution</para></entry>
                        <entry><para>Set to "1" if high resolution printing is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Copying</para></entry>
                        <entry><para>Copying</para></entry>
                        <entry><para>Set to "1" if copying the contents is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Modifying</para></entry>
                        <entry><para>Modifying</para></entry>
                        <entry><para>Set to "1" if modifying the contents is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.DocAssembly</para></entry>
                        <entry><para>Document Assembly</para></entry>
                        <entry><para>Set to "1" if inserting, rotating, or deleting pages and creating navigation elements is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.Commenting</para></entry>
                        <entry><para>Commenting</para></entry>
                        <entry><para>Set to "1" if adding or modifying text annotations is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.FormFilling</para></entry>
                        <entry><para>Form Filling</para></entry>
                        <entry><para>Set to "1" if filling of form fields is allowed.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>PDF.AccessibilitySupport</para></entry>
                        <entry><para>Accessibility Support</para></entry>
                        <entry><para>Set to "1" if accessibility support (eg. screen readers) is enabled.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Contact</para></entry>
                        <entry><para>Contact</para></entry>
                        <entry><para>Contact information for the creators or distributors of the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Description</para></entry>
                        <entry><para>Description</para></entry>
                        <entry><para>A textual description of the data.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.License</para></entry>
                        <entry><para>License</para></entry>
                        <entry><para>License information.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Location</para></entry>
                        <entry><para>Location</para></entry>
                        <entry><para>Location where track was recorded.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Contact</para></entry>
                        <entry><para>Maximum bitrate</para></entry>
                        <entry><para>Maximum bitrate in kbps.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Contact</para></entry>
                        <entry><para>Minimum bitrate</para></entry>
                        <entry><para>Minimum bitrate in kbps.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Contact</para></entry>
                        <entry><para>Nominal bitrate</para></entry>
                        <entry><para>Nominal bitrate in kbps.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Organization</para></entry>
                        <entry><para>Organization</para></entry>
                        <entry><para>Organization producing the track.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Vendor</para></entry>
                        <entry><para>Vendor</para></entry>
                        <entry><para>Vorbis vendor ID.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Vorbis.Version</para></entry>
                        <entry><para>Vorbis Version</para></entry>
                        <entry><para>Vorbis version.</para></entry>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>

        <tip>
            <para>Non-existent metatags are expanded to empty strings.</para>
        </tip>
        </sect3>

        <sect3 id="gnome-commander-advanced-rename-ranges">
        <title>Ranges</title>
        <para>Ranges are a method of accessing a part of a string. The concept of ranges is based on python slices.</para>

        <para>A range (start_index:end_index) starts at the start_index and finishes one character before the end_index.</para>

        <para>
        <guilabel>Range syntax</guilabel>
        <itemizedlist>
            <listitem>
                <para><guilabel>(start_index:end_index)</guilabel></para>
            </listitem>
            <listitem>
                <para><guilabel>(start_index)</guilabel> &#x2261; (start_index:)</para>
            </listitem>
            <listitem>
                <para><guilabel>(start_index,length)</guilabel> &#x2261; (start_index:start_index+length)</para>
            </listitem>
        </itemizedlist>
        </para>

        <para>
        If one of the indices is dropped, it is assumed that you want everything in that direction.
        I.e. (:3) means "every character from the beginning of the string up to character 3, non-inclusive."
        (3:) would, on the other hand, mean "every character from the string, starting at character 3 (inclusive) up to,
        and including, the last one." If index is negative, it is relative to the end of the string.
        Index -3 stands for "the third character from the end of the string".
        </para>

        <tip>
            <para>Position of the first letter is '0'.</para>
        </tip>
        </sect3>

        <sect3 id="gnome-commander-advanced-rename-g-date-time-format">
        <title>g_date_time_format() format controls</title>
        <para>
          The date format is defined by GIO's g_date_time_format() function. Below you will find a
          number of format qualifiers of this function. For more information please read the
          <ulink url="https://docs.gtk.org/glib/method.DateTime.format.html">online documentation</ulink>,
          which might provide even more qualifiers.
        </para>
        <informaltable frame="topbot">
            <tgroup cols="2">
                <colspec colname="col1"/>
                <colspec colname="col2"/>
                <thead>
                    <row valign="top">
                        <entry colname="col1" colsep="0" valign="top"><para>Placeholder</para></entry>
                        <entry colname="col2" valign="top"><para>Replacement</para></entry>
                    </row>
                </thead>
                <tbody>
                    <row valign="top">
                        <entry><para>%a</para></entry>
                        <entry><para>The abbreviated weekday name according to the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%A</para></entry>
                        <entry><para>The abbreviated month name according to the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%b</para></entry>
                        <entry><para>The abbreviated month name according to the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%B</para></entry>
                        <entry><para>The full month name according to the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%c</para></entry>
                        <entry><para>The preferred date and time representation for the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%C</para></entry>
                        <entry><para>The century number (year/100) as a 2-digit integer</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%d</para></entry>
                        <entry><para>The day of the month as a decimal number (range 01 to 31)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%e</para></entry>
                        <entry><para>Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%F</para></entry>
                        <entry><para>Equivalent to %Y-%m-%d (the ISO 8601 date format)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%G</para></entry>
                        <entry><para>The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number
                                     (see %V). This has the same format and value as %y, except that if the ISO week number belongs
                                     to the previous or next year, that year is used instead</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%g</para></entry>
                        <entry><para>Like %G, but without century, i.e., with a 2-digit year (00-99)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%h</para></entry>
                        <entry><para>Equivalent to %b</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%H</para></entry>
                        <entry><para>The hour as a decimal number using a 24-hour clock (range 00 to 23)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%I</para></entry>
                        <entry><para>The hour as a decimal number using a 12-hour clock (range 01 to 12)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%j</para></entry>
                        <entry><para>The day of the year as a decimal number (range 001 to 366)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%k</para></entry>
                        <entry><para>The hour (24-hour  clock) as a decimal number (range 0 to 23); single digits are preceded by a blank
                                    (see also %H)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%l</para></entry>
                        <entry><para>The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded  by  a  blank
                                    (see also %I)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%m</para></entry>
                        <entry><para>The month as a decimal number (range 01 to 12)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%M</para></entry>
                        <entry><para>The minute as a decimal number (range 00 to 59)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%O</para></entry>
                        <entry><para>Modifier: use alternative format, see below</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%p</para></entry>
                        <entry><para>Either  "AM"  or "PM" according to the given time value, or the corresponding strings for the current locale.
                                     Noon is treated as "pm" and midnight as "am"</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%P</para></entry>
                        <entry><para>Like %p but in lowercase: "am" or "pm" or a corresponding string for the current locale</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%r</para></entry>
                        <entry><para>The time in a.m. or p.m. notation.  In the POSIX locale this is equivalent to "%I:%M:%S %p"</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%R</para></entry>
                        <entry><para>The time in 24-hour notation (%H:%M).  For a version including the seconds, see %T below</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%s</para></entry>
                        <entry><para>The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%S</para></entry>
                        <entry><para>The second as a decimal number (range 00 to 61)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%T</para></entry>
                        <entry><para>The time in 24-hour notation (%H:%M:%S)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%u</para></entry>
                        <entry><para>The day of the week as a decimal, range 1 to 7, Monday being 1.  See also %w</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%V</para></entry>
                        <entry><para>The  ISO  8601:1988  week number of the current year as a decimal number, range 01 to 53, where week 1 is the
                                     first week that has at least 4 days in the current year, and with Monday as the first day of  the  week.
                                     See also %U and %W</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%w</para></entry>
                        <entry><para>The day of the week as a decimal, range 0 to 6, Sunday being 0.  See also %u</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%x</para></entry>
                        <entry><para>The preferred date representation for the current locale without the time</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%X</para></entry>
                        <entry><para>The preferred time representation for the current locale without the date</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%y</para></entry>
                        <entry><para>The year as a decimal number without a century (range 00 to 99)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%Y</para></entry>
                        <entry><para>The year as a decimal number including the century</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%z</para></entry>
                        <entry><para>The time-zone as hour offset from GMT.  Required to emit RFC822-conformant dates
                                    (using "%a, %d %b %Y %H:%M:%S %z")</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%Z</para></entry>
                        <entry><para>The time zone or name or abbreviation</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%+</para></entry>
                        <entry><para>The date and time in date format</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>%%</para></entry>
                        <entry><para>A literal "%" character</para></entry>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>

        <note>
            <para>Some conversion specifiers can be modified by preceding them by the O modifier to indicate that an alternative
            format should be used. If the alternative format or specification does not exist for the current locale,
            the behaviour will be as if the unmodified conversion specification were used.</para>
        </note>
    </sect3>
    </sect2>
    <!-- ================ Remote Server Subsection ======================= -->
    <sect2 id="gnome-commander-remote-connections">
      <title>Remote Connections</title>
      <para>The Remote Connections dialog gives an overview about the stored connections to remote servers. It is also your starting point for opening a connection to a remote server.</para>
      <para>Open the dialog by clicking <menuchoice><guimenu>Connections</guimenu><guimenuitem>Remote Server...</guimenuitem></menuchoice> in the menu bar or by hitting <keycombo><keycap>CTRL</keycap><keycap>F</keycap></keycombo>.</para>
      <para>It is divided into four parts:
      <orderedlist>
	<listitem><para>Connections list,</para></listitem>
	<listitem><para>Buttons to <guimenuitem>Add</guimenuitem>, <guimenuitem>Edit</guimenuitem> and to <guimenuitem>Remove</guimenuitem> a selected connection,</para></listitem>
	<listitem><para>Option for setting the anonymous FTP password globally.</para></listitem>
      <listitem><para>A <guimenuitem>Close</guimenuitem> and a <guimenuitem>Connect</guimenuitem> button.</para></listitem></orderedlist></para>
      <para>Double click on a connection or select a connection and hit <keycombo><keycap>ENTER</keycap></keycombo> will open the remote connection in the active pane of &app;.</para>
      <para> An example figure with three anonymous FTP and one secure SSH connection is shown below.</para>
      <para> In the subsection <xref linkend="gnome-commander-config-remote-connections"></xref> it is shown how to edit a connection by clicking on the <guimenuitem>Add</guimenuitem> or <guimenuitem>Edit</guimenuitem> button.</para>
      <!-- ==== Figure ==== -->
      <figure id="remote-connections-example">
	<title>Remote Connections Overview</title>
	<screenshot>
          <mediaobject>
            <imageobject>
	      <imagedata fileref="figures/gnome-commander_dialog_remote_connections.png" format="PNG"/>
            </imageobject>
            <textobject><phrase>Overview of remote servers.</phrase>
            </textobject>
	  </mediaobject>
	</screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <!-- ================ Remote Server Subsection ======================= -->
      <sect3 id="gnome-commander-config-remote-connections">
	<title>Adding and Configuring Remote Connections</title>
	<para>Remote connection details can be set up temporarily or permanently, depending on how they are added to &app;:
	<itemizedlist>
	  <listitem><para>By hitting the shortcut <keycombo><keycap>CTRL</keycap><keycap>N</keycap></keycombo> a
	  temporary connection is configured. That's why no connection alias is needed in this case. If you 
	  restart &app;, the connection details have to be entered again to connect to the same 
	  server.</para></listitem>
	  <listitem><para>By adding a remote connection via the <guimenuitem>Add</guimenuitem> button in the 
	  Remote Connections dialog (see above), the connection is stored permanently in this dialog. If you
	  restart &app; the stored connection is available again.</para></listitem>
	</itemizedlist>
	</para>
	<para>Currently, (&app; version 1.4) there are six different connection types available:
	<orderedlist>
	  <listitem><para>SSH</para></listitem>
	  <listitem><para>Public FTP</para></listitem>
	  <listitem><para>FTP (with login)</para></listitem>
	  <listitem><para>Windows share</para></listitem>
	  <listitem><para>WebDAV (HTTP)</para></listitem>
	  <listitem><para>Secure WebDAV (HTTPS)</para></listitem>
	  <listitem><para>Custom location</para></listitem>
	</orderedlist></para>
	<para>Depending on the choice, different login details have to be entered in the 
	Remote Server dialog.</para>
	<para>See an example for a public FTP server in the figure below.</para>
	<!-- ==== Figure ==== -->
	<figure id="remote-connections-new">
          <title>Creating Server Connection</title>
          <screenshot>
            <mediaobject>
              <imageobject>
		<imagedata fileref="figures/gnome-commander_dialog_remote_server.png" format="PNG"/>
              </imageobject>
              <textobject><phrase>Creating a new remote server connection.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
	</figure>
	<!-- ==== End of Figure ==== -->
      </sect3>
    </sect2>
    <!-- ================ Internal Viewer Subsection ======================= -->
    <sect2 id="gnome-commander-internal-viewer">
      <title>Using the Internal Viewer</title>
      <para>The internal viewer allows viewing contents of files in text, Unicode,
       binary, hex or graphical mode.</para>
      <para>To start viewing files use <keycap>F3</keycap> (default viewer - defined
	      in <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>) or
          <keycombo><keycap>SHIFT</keycap><keycap>F3</keycap></keycombo> (internal viewer). The internal viewer uses MMAP
	       whenever possible for the fastest file loading.
      </para>
      <sect3 id="gnome-commander-internal-viewer-modes">
        <title>View Modes</title>
        <para>The <guilabel>View Modes</guilabel> group (In the <menuchoice><guimenu>View</guimenu></menuchoice> menu) 
	contains the preferences that you can set to view images and texts in the internal viewer window:</para>
	<para>
	  <orderedlist>
            <listitem><para>Text mode</para></listitem>
            <listitem><para>Binary mode</para></listitem>
            <listitem><para>Hex dump mode</para></listitem>
            <listitem><para>Image mode</para></listitem>
	  </orderedlist>
	</para>
	<para>For all of the three text modes (mode 1 to 3) you can change the text encoding in 
	<menuchoice><guimenu>Text</guimenu><guimenuitem>Encoding</guimenuitem></menuchoice>.</para>
	<para>For the image display mode you can choose if additional meta data should be shown below the image by selecting
	<menuchoice><guimenu>Image</guimenu><guimenuitem>Show Metadata Tags</guimenuitem></menuchoice>.</para>
	<para>Below of the <guilabel>View Modes</guilabel> in the <menuchoice><guimenu>View</guimenu></menuchoice> menu you can
	set the zoom factor. You can</para>
	<para>
	  <itemizedlist>
            <listitem><para>Zoom in (<keycombo><keycap>CTRL</keycap><keycap>+</keycap></keycombo>),</para></listitem>
            <listitem><para>Zoom out (<keycombo><keycap>CTRL</keycap><keycap>-</keycap></keycombo>),</para></listitem>
            <listitem><para>Zoom to normal size (<keycombo><keycap>CTRL</keycap><keycap>0</keycap></keycombo>), or</para></listitem>
            <listitem><para>Fit the image into the window of the internal viewer.</para></listitem>
	  </itemizedlist>
	</para>
      </sect3>
      <sect3 id="gnome-commander-internal-viewer-scroll-image">
        <title>To Scroll an Image</title>
        <para>To scroll around an image that is larger than the image window or
                  full screen window, you can use the following methods:</para>
        <itemizedlist>
          <listitem>
            <para>Use the arrow keys on the keyboard.</para>
          </listitem>
          <listitem>
            <para>Drag the scrollbars on the window borders.</para>
          </listitem>
          <listitem>
            <para>Move the mouse scroll wheel for up/down movement; <keycombo><keycap>CTRL</keycap></keycombo>+mouse wheel for left/right movement</para>
          </listitem>
          <listitem>
            <para>Click at a random position of the image and drag it by pulling your mouse in the opposite direction
	    to which you want to scroll. For example, if you want to scroll down the image, drag the image upwards.</para>
          </listitem>
        </itemizedlist>
      </sect3>
      <sect3 id="gnome-commander-internal-viewer-keyboard">
        <title>Keyboard mappings</title>
        <informaltable frame="topbot">
        <tgroup cols="2">
        <colspec colname="col1"/>
        <colspec colname="col2"/>
        <thead>
        <row valign="top">
        <entry colname="col1" colsep="0" valign="top"><para>Shortcut</para></entry>
        <entry colname="col2" valign="top"><para>Mapping</para></entry>
        </row>
        </thead>
        <tbody>
        <row valign="top">
        <entry><para>Escape</para><keycombo><keycap>CTRL</keycap><keycap>Q</keycap></keycombo></entry>
        <entry><para>Closes the internal viewer window</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>W</keycap></keycombo></entry>
        <entry><para>Toggles line wrapping (applicable only in text display modes)</para></entry>
        </row>
        <row valign="top">
        <entry><para><keycombo><keycap>T</keycap></keycombo></para><keycombo><keycap>ALT</keycap><keycap>ENTER</keycap></keycombo></entry>
        <entry><para>Shows metadata tags</para></entry>
        </row>
        <row valign="top">
        <entry><para>Input Modes:</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>A</keycap></keycombo></entry>
        <entry><para>Sets ASCII input mode. When in ASCII mode, you can also set the required character encoding
        from the "View|Character Encoding" submenu</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>Q</keycap></keycombo></entry>
        <entry><para>Sets ASCII input mode, with codepage 437 encoding (suitable for binary and hex mode viewing)</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>U</keycap></keycombo></entry>
        <entry><para>Sets UTF-8 input mode</para></entry>
        </row>
        <row valign="top">
        <entry><para>Display modes:</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>1</keycap></keycombo></entry>
        <entry><para>Sets display mode to text, with fixed width font</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>2</keycap></keycombo></entry>
        <entry><para>Sets display mode to binary. Switching to Binary display mode
        will automatically set ASCII input mode (UTF-8 is not supported with binary display)</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>3</keycap></keycombo></entry>
        <entry><para>Sets display mode to hex dump. Switching to hex display mode
        will automatically set ASCII input mode (UTF-8 is not supported with hex dump display)</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>4</keycap></keycombo></entry>
        <entry><para>Tries to load the file as an image. Loading is done using GDK,
        so every GDK-supported format should work.</para></entry>
        </row>
        <row valign="top">
        <entry><para>Zooming:</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>+</keycap></keycombo></entry>
        <entry><para>Zooms in or increment the font size</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>-</keycap></keycombo></entry>
        <entry><para>Zooms out or decrement the font size</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>0</keycap></keycombo></entry>
        <entry><para>Sets normal size</para></entry>
        </row>
        <row valign="top">
        <entry><para>Image manipulation:</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>R</keycap></keycombo></entry>
        <entry><para>Rotates the image 90&#x00b0; (applicable only in IMAGE display mode)</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>R</keycap></keycombo></entry>
        <entry><para>Rotates the image 270&#x00b0; (applicable only in IMAGE display mode)</para></entry>
        </row>
        <row valign="top">
        <entry><para>Image manipulation:</para></entry>
        </row>
        <row valign="top">
        <entry><keycombo><keycap>CTRL</keycap><keycap>S</keycap></keycombo></entry>
        <entry>
            <para>Saves the current window size, input mode, and other settings as the default.</para>
            <note><para>Starting display mode is determined by the file's content, and is not saved as a user setting.</para></note>
        </entry>
        </row>
        </tbody>
        </tgroup>
        </informaltable>
      </sect3>
    </sect2>
  </sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->
  <sect1 id="gnome-commander-prefs">
    <title>Settings</title>
    <para>To configure &app;, hit <keycombo><keycap>CTRL</keycap><keycap>O</keycap></keycombo> or in the menubar choose
        <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>
      The <guilabel>Options</guilabel> dialog contains the following tabbed sections:</para>
    <!-- general preferences section -->
    <sect2 id="gnome-commander-prefs-general">
      <title>General</title>
      <para>The <guilabel>General</guilabel> tab is used to configure the &app; basic
        behavior.
      </para>
      <para>The settings alter the behavior of the  following features:</para>
      <para>
        <itemizedlist>
          <listitem>
            <para><guilabel>Left mouse button</guilabel> configures the action
            resulting from clicking the left mouse button.</para>
          </listitem>
            <listitem>
            <para><guilabel>Middle mouse button</guilabel> configures the action resulting from clicking the middle mouse button.</para>
          </listitem>
          <listitem>
            <para><guilabel>Right mouse button</guilabel> configures the action
            resulting from clicking the right mouse button.</para>
          </listitem>
          <listitem>
            <para><guilabel>Deletion</guilabel> configures the usage of the trash can.</para>
          </listitem>
          <listitem>
            <para><guilabel>Selection</guilabel> makes directories selectable also by keyboard shortcuts.</para>
          </listitem>
          <listitem>
            <para><guilabel>Sorting/Quick search</guilabel> configures whether sorting and the quick search is
            case sensitive.</para>
          </listitem>
          <listitem>
            <para><guilabel>Quick search</guilabel> configures the combination of keys used for quick search
            and also the pattern matching system used.</para>
          </listitem>
          <listitem>
            <para><guilabel>Multiple instances</guilabel> configures the number of &app; that can be launched</para>
          </listitem>
          <listitem>
            <para><guilabel>Save on exit</guilabel> configures the storage of location when &app; is closed.</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>To modify the general options click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>,
         then click on the <guilabel>General</guilabel> tab.
       </para>
       <para>The options available are described in more details in the
         <xref linkend="gcmd-TBL-setting1"/>.</para>
      <para/>
      <table frame="topbot" id="gcmd-TBL-setting1">
        <title>General option tab</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Header</para>
              </entry>
              <entry colname="colspec2">
                <para>Option</para>
              </entry>
              <entry colname="colspec3">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Left Mouse button</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Single click to open items</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option, a single left mouse button click
                on a file will open it with the default application.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Double click to open items</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option, a double click with the left
                mouse button on a file will open it with the default application.
                </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Single click unselects files</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option, a single left mouse button click
                on an unselected file or folder will unselect the current selection. If the option is not active
		a left click on any file will not affect the current selection.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Middle Mouse button</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Up one directory</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option a middle click with the mouse on
                any item in &app; will display the parent directory of the current one.</para>
                <note><para>The middle click is usually emulated by clicking both left and right buttons simultaneously on two buttons mice.</para></note>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Opens new tab</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option, a middle click on a directory in &app;
                with the mouse will open it in a new tab.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Right Mouse button</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Shows pop up menu</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option a right click with the mouse on
                an item in &app; will open a contextual menu at the location of
                the click.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Select files</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option, a right click on an item in &app;
                with the mouse will select it.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Deletion</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Move to trash</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When selecting this option files and folders are by default moved to trash instead of deleting them permanently.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Sorting/Quick search</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Case sensitive</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When this option is activated &app; will differentiate the
                sorting order between upper case and lower case, upper case items are
                then listed before lower case ones. Also the quicksearch will
                differentiate between upper case and lower case if this option
                is activated.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <guilabel>Quick search using</guilabel>
                </para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>CTRL+ALT+Letters</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By selecting this option when you press <keycombo><keycap>CTRL</keycap><keycap>Alt</keycap><keycap>Letter</keycap></keycombo> &app; will scroll down the selection cursor in the active
                   pane to the first item using that letter. You can then enter more
                   letters after the first one to refine the search. By then pressing the up or down arrow key
                   the cursor will jump to all files or folders which match your selection.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Alt+letters (menu access with <keycap>F10</keycap>)</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When you press <keycombo><keycap>Alt</keycap><keycap>Letter</keycap></keycombo> &app; will scroll down the selection cursor in the active
                   pane to the first item using that letter. You can then enter more
                   letters after the first one to refine the search.</para>
                <note>
                  <para>By selecting this option you alter the standard GNOME behavior
                  and to access the menus with the keyboard you will need to use the
                  <keycap>F10</keycap> key.</para>
                </note>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Just letters (command line access with <keycombo><keycap>CTRL</keycap><keycap>Alt</keycap><keycap>C</keycap></keycombo>)</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>When you press a letter &app; will scroll down the selection cursor in the active
                   pane to the first item using that letter. You can then enter more
                   letters after the first one to refine the search.</para>
                <note>
                  <para>By selecting this option you alter the standard GNOME behavior
                  and to access the command line with the keyboard you will need to use the command
                  <keycombo><keycap>CTRL</keycap><keycap>Alt</keycap><keycap>C</keycap></keycombo>.</para>
                </note>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Match beginning of the file name</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By selecting this option when you start to search for a letter or a letter combination, &app; will scroll down the selection cursor in the active
                   pane to the first item beginning with that letter or that letter combination.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para/>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Match end of the file name</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By selecting this option when you start to search for a letter or a letter combination, &app; will scroll down the selection cursor in the active
                   pane to the first item ending with that letter or that letter combination.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><guilabel>Multiple instances</guilabel></para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Don't start a new instance</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By activating this option &app; can only have one instance running.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><guilabel>Save on exit</guilabel></para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Directories</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By activating this option &app; saves the current folder location on exit. When restarted, the two active location are reopened.</para>
                <note>
                  <para>Regardless of 'Save on exit' option, locations for locked tabs are always saved on exit.</para>
                </note>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><guilabel></guilabel></para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Tabs</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By activating this option &app; saves all the opened tabs locations on exit. When restarted, all the tabs are reopened in their previous location.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><guilabel></guilabel></para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Directory history</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By activating this option &app; saves the history of opened directories on exit. When restarted, the history of visited directories is accessible again.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><guilabel></guilabel></para>
              </entry>
              <entry colname="colspec2" valign="top">
                <para>Commandline history</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>By activating this option &app; saves the history of executed commandline commands on exit. When restarted, the history of commands in the commandline accessible again.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>


    </sect2>
    <!-- Format options-->
    <sect2 id="gnome-commander-prefs-format">
      <title>Format</title>
      <para>The Format tab contains the options on how file informations are displayed.
       </para>
      <para>
        <itemizedlist>
          <listitem>
            <para><guilabel>Size display mode</guilabel> select the size information
            format.</para>
          </listitem>
          <listitem>
            <para><guilabel>Permission display mode</guilabel> select the permissions
            display format.</para>
          </listitem>
          <listitem>
            <para><guilabel>Date format</guilabel> select the date display format.
            </para>
          </listitem>
        </itemizedlist>
      </para>
      <para>To modify the Format options click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>, then click on
         the <guilabel>Format</guilabel> tab.</para>
      <para>The options available are described in more details in the
       <xref linkend="gcmd-TBL-setting2"/></para>
      <!-- ==== Figure ==== -->
      <figure id="options-format-fig">
        <title>Format options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_format.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; format preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <table frame="topbot" id="gcmd-TBL-setting2">
        <title>Format option tab</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Header</para>
              </entry>
              <entry colname="colspec2">
                <para>Option</para>
              </entry>
              <entry colname="colspec3">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Size display mode</guilabel>
                </para>
              </entry>
              <entry>
                <para>Powered</para>
              </entry>
              <entry>
                <para>The powered option displays file sizes using units such as B KB
                MB</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
              </entry>
              <entry>
                <para>&lt;locale&gt;</para>
              </entry>
              <entry>The locale option uses the current local settings number format
              to display the file size in bytes. </entry>
            </row>
            <row>
              <entry>
                <para/>
              </entry>
              <entry>Grouped</entry>
              <entry>The grouped entry displays the file size in groups of three
              digits separated by a space. The unit used is the byte.</entry>
            </row>
            <row>
              <entry>
                <para/>
              </entry>
              <entry>Plain</entry>
              <entry>The plain option displays the file size in bytes without any
              separation.</entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Permission display mode</guilabel>
                </para>
              </entry>
              <entry>
                <para>Text (rw-r--r--)</para>
              </entry>
              <entry>
                <para>Display the permission in text format. Using r for read, w
                for write, x for executable.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
              </entry>
              <entry>
                <para>Number (644)</para>
              </entry>
              <entry>Display the permission in octal numerical format.</entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Date format</guilabel>
                </para>
              </entry>
              <entry>
                <para>Format</para>
              </entry>
              <entry>
                <para>The date format is defined by GIO's g_date_time_format() function.
                For more information about possible date format qualifiers read more at
                <xref linkend="gnome-commander-advanced-rename-g-date-time-format"/>.
                </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para/>
    </sect2>
    <!-- Layout options -->
    <sect2 id="gnome-commander-prefs-layout">
      <title>Layout</title>
      <para>The layout preferences tab allows you to configure the appearance of &app;.
       You can allocate fonts, row heights, icons and color theme.</para>
      <para>
        <itemizedlist>
          <listitem>
            <para><guilabel>File Panes</guilabel>: In this section you can modify the
            way &app; is displayed.</para>
          </listitem>
          <listitem>
            <para><guilabel>Mime icon settings</guilabel> in this section you can
            configure how and which  icons display when they are enabled in the
            previous section.</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>To modify the Panes layout options click on <menuchoice><guimenu>
         Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>,
         then click on the <guilabel>Layout</guilabel> tab.</para>
      <para>The options available are described in more details in the
       <xref linkend="gcmd-TBL-setting3"/></para>
      <!-- ==== Figure ==== -->
      <figure id="options-layout-fig">
        <title>Layout options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_layout.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; layout preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <table frame="topbot" id="gcmd-TBL-setting3">
        <title>Layout option tab</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Header</para>
              </entry>
              <entry colname="colspec2">
                <para>Option</para>
              </entry>
              <entry colname="colspec3">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>File panes</guilabel>
                </para>
              </entry>
              <entry colname="colspec2">
                <para>Font</para>
              </entry>
              <entry colname="colspec3">
                <para>This button opens a font selection dialog, where you can preview
                and select the preferred font and size in which text is displayed in
                the panes.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Row height</para>
              </entry>
              <entry colname="colspec3">
                <para>This is the height of every row displayed in the panes in pixels
                you can increase or decrease it here using the spin button or entering
                the size manually.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Display file extensions</para>
              </entry>
              <entry colname="colspec3">
                <para>You can select here how file extensions are displayed in this
                drop down list. There are three options available:
                <itemizedlist>
                	<listitem>
                		<para><guibutton>In both columns</guibutton> where the extension is displayed in filename and extension columns</para>
                	</listitem>
                	<listitem>
                		<para><guibutton>In separate column</guibutton> where the extension is displayed in its own column</para>
                      </listitem>
                  <listitem>
                        <para><guibutton>With filename</guibutton> where the extension is only displayed in the file name column; in this case the ext column is still displayed to allow sorting by extension</para>
                  </listitem>
                 </itemizedlist>
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Graphical mode</para>
              </entry>
              <entry colname="colspec3">
                <para>The graphical mode has three display options in the drop down
                list:
                	<itemizedlist>
                		<listitem>
                			<para><guibutton>No icons</guibutton> this option does not display an icon item in the first column in the pane it displays a &quot;/&quot; in front of directories to distinguish them from files.</para>
                		</listitem>
                     <listitem>
                     	<para><guibutton>File type icons</guibutton> this option displays simple icons for files and folder.</para>
                     </listitem>
                     <listitem><para><guibutton>MIME icons</guibutton> this option displays the mime icon associated with the file type. Selecting this option activates the <guilabel>MIME icon settings</guilabel> section below.</para>
                     </listitem>
                  </itemizedlist>
                 </para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Color scheme</para>
              </entry>
              <entry colname="colspec3">
                <para>&app; comes with six color themes. You can also use the theme
                as defined by your current GNOME theme (<guibutton>Respect theme
                colors</guibutton>). There is also an option to customize the theme
                (<guibutton>Custom</guibutton>). This option activates the <guibutton>
                Edit</guibutton> button.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Edit</para>
              </entry>
              <entry colname="colspec3">
                <para>When the <guibutton>Custom</guibutton> option is selected this
                button activates. Clicking on it will open a dialog box where you can
                select row and alternate row colors for the foreground (text color)
                and background, the alternate colors are used by every other row,
                the selected file colors and the cursor position colors. For more information see below at <xref linkend="gnome-commander-prefs-layout-colors"/>.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Colorize files according to the LS_COLORS environment variable</para>
              </entry>
              <entry colname="colspec3">
                <para>This option uses LS_COLORS variable to highlight file types just
                 like the command &quot;ls&quot;. For more information see below at <xref linkend="gnome-commander-prefs-layout-ls_colors"/>.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel>MIME&#160;icon settings</guilabel>
              </entry>
              <entry colname="colspec2">
                <para>Icon size</para>
              </entry>
              <entry colname="colspec3">
                <para>Specify the size of icons used to represent the files when
                <guibutton>MIME icon</guibutton> is activated above.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Scaling quality</para>
              </entry>
              <entry colname="colspec3">
                <para>Select the render quality of the icons (higher is better).
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para/>
                <guilabel/>
              </entry>
              <entry colname="colspec2">
                <para>Theme icon directory</para>
              </entry>
              <entry colname="colspec3">
                <para>If you wish to customize the theme icon select the folder
                containing the custom icons here.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para/>

		<sect3 id="gnome-commander-prefs-layout-colors">
		<title>Configuring Custom Colors</title>
		<para>To configure the custom colors for &app; click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options</guimenuitem></menuchoice>, click on the <guilabel>Layout</guilabel> tab, Select <guilabel>Custom</guilabel> in the <guilabel>Color scheme:</guilabel> drop down list then click the <guilabel>Edit</guilabel> button.</para>
		<para>This feature allows you to configure how &app; displays elements to suit your needs. By default the unselected elements are all displayed in the same way. This can become confusing, to solve this you can configure alternate colors for alternate rows.</para>
		<para><guilabel>Foreground</guilabel> describes the color used for the text, and <guilabel>background</guilabel> is the background color used for the row.</para>
		<itemizedlist>
			<listitem><para><guilabel>Default</guilabel> this is the text and background colors used by default. These colors are used for standard unselected items.</para>
			</listitem>
			<listitem><para><guilabel>Alternate</guilabel> If you wish to have a different color on alternate rows to help distinguish the files you can change the colors defined here. By default they are set to the same colors as the default.</para>
			</listitem>
			<listitem><para><guilabel>Selected File</guilabel>, all selected items will be marked using the colors defined here. They differ from the default to help visualization of the marked items.</para>
			</listitem>
			<listitem><para><guilabel>Cursor</guilabel> is the row currently activated. This highlights the position and is useful when navigating files with the keyboard.</para>
			</listitem>
		</itemizedlist>
		<para>See the example figure of the Edit Colors... dialog below.</para>
		<!-- ==== Figure ==== -->
		<figure id="options-layout-colors">
		  <title>Configuring Custom Colors</title>
		  <screenshot>
		    <mediaobject>
		      <imageobject>
			<imagedata fileref="figures/gnome-commander_options_layout_colors.png" format="PNG"/>
		      </imageobject>
		      <textobject>
			<phrase>Shows &app; dialog for editing custom colors.</phrase>
		      </textobject>
		    </mediaobject>
		  </screenshot>
		</figure>
		<!-- ==== End of Figure ==== -->
		</sect3>
		<sect3 id="gnome-commander-prefs-layout-ls_colors">
			<title>Configuring Custom LS_COLORS</title>
			 <para>&app; does not differentiate files types by default.</para>
			 <para>You can configure it to differentiate file types like LS_COLORS does when using the command shell. For more information on this you can look up the <ulink url="http://linux.die.net/man/5/dir_colors">dir_colors man page</ulink>.</para>
			 <para>To enable the use of LS_COLORS for &app; click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options</guimenuitem></menuchoice>, than on the <guilabel>Layout</guilabel> tab and activate the <guilabel>Colorize files according to the LS_COLORS environment variable</guilabel> check box.</para>
			 <para>If you prefer other shades of colors than given by the LS_COLOR variable you may change them by clicking on the <guilabel>Edit colors...</guilabel> button.</para>
			 <note><para>Some users reported that custom LS_COLORS, defined in ~/.dir_colors, are not applied if &app; was started by clicking on a .desktop file or by starting it using the GNOME menu. In that case you have to make sure that LS_COLORS is set in the file ~/.profile or ~/.xprofile.</para>
			 <para>For this you will need to find out the default TERM value of your system. Therefore, login to a virtual terminal by pressing <keycombo><keycap>CTRL</keycap><keycap>ALT</keycap><keycap>F1</keycap></keycombo> and execute the command <keycombo><keycap>echo $TERM</keycap></keycombo>. If the output is <keycombo><keycap>linux</keycap></keycombo>, the entry in ~/.profile might look like this:</para>
			 <programlisting>
   # Set colors
   export TERM=linux
   test -r ~/.dir_colors &amp;&amp; eval &quot;$(dircolors -b ~/.dir_colors)&quot;</programlisting></note>

		</sect3>
<!-- ====Confirmation==== -->
    </sect2>
    <!-- Tabs options -->
    <sect2 id="gnome-commander-prefs-tabs">
      <title>Tabs</title>
      <!--brief description-->
      <para>The tabs preferences tab allows you to configure parameters for tabs.</para>
      <itemizedlist>
        <listitem>
          <para>By checking <guilabel>Always show the tab bar</guilabel> in the tab bar section, &app; will always show the tab bar, even if only one tab is opened.</para>
        </listitem>
        <listitem>
          <para>In the tab lock indicator section, you can configure the way how a locked tab will by indicated. There are three different possibilities:
          <itemizedlist>
            <listitem><para><guilabel>Lock icon</guilabel>: An icon is shown,</para></listitem>
            <listitem><para><guilabel>* (asterix)</guilabel>: An asterix is shown,</para></listitem>
            <listitem><para><guilabel>Styled text</guilabel>: The name of the tab is colored.</para></listitem>
          </itemizedlist>
	  </para>
        </listitem>
      </itemizedlist>
      <!-- ==== Figure ==== -->
      <figure id="options-tabs-fig">
        <title>Tabs options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_tabs.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; tabs preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <para/>
    </sect2>
    <sect2 id="gnome-commander-prefs-confirmation">
      <title>Confirmation</title>
      <para>The Confirmation tab allows you to configure when a confirmation dialog
      is displayed. You may also configure the behavior of &app; when the confirmation
      dialog does not appear.</para>
      <para>
        <itemizedlist>
          <listitem>
            <para><guilabel>Delete</guilabel> whether deleting an item needs to be
            confirmed</para>
          </listitem>
          <listitem>
            <para><guilabel>Copy overwrite</guilabel> configure the action when an item
            copied already exists in the target location</para>
          </listitem>
          <listitem>
            <para><guilabel>Move overwrite</guilabel> configure the action when an item
            moved already exists in the target location</para>
          </listitem>
          <listitem>
            <para><guilabel>Default Drag and Drop Action</guilabel> configure the action when an item
            is dropped after dragging it with the mouse</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>To modify the confirmation settings click on <menuchoice><guimenu>
       Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>,
       then click on the <guilabel>Confirmation</guilabel> tab.</para>
      <para>The options available are described in more details in the
       <xref linkend="gcmd-TBL-setting4"/>.</para>
      <!-- ==== Figure ==== -->
      <figure id="options-confirmation-fig">
        <title>Confirmation options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_confirmation.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; confirmation preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <para/>
      <table frame="topbot" id="gcmd-TBL-setting4">
        <title>Layout option tab</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Header</para>
              </entry>
              <entry colname="colspec2">
                <para>Option</para>
              </entry>
              <entry colname="colspec3">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Delete</guilabel>
                </para>
              </entry>
              <entry colname="colspec2">
                <para>Confirm before delete</para>
              </entry>
              <entry colname="colspec3">
                <para>When activated &app; opens a dialog to confirm file deletion.
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Confirm defaults to OK</para>
              </entry>
              <entry colname="colspec3">
                <para>Selects default action in the dialog.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Copy overwrite</guilabel>
                </para>
              </entry>
              <entry colname="cospec2">
                <para>Silently</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files copied it will be silently
						overwritten.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="cospec2">
                <para>Query first</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files copied &app; will open a
						dialog asking for user confirmation. The user can authorize the
						overwriting of the file or skip the file.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="cospec2">
                <para>Skip all</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files copied, the files will be
						skipped and not copied into the target directory.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Move overwrite</guilabel>
                </para>
              </entry>
              <entry colname="cospec2">
                <para>Silently</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files moved it will be silently
						overwritten.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="cospec2">
                <para>Query first</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files moved &app; will open a
						dialog asking for user confirmation. The user can authorize the
						overwriting of the file or skip the file. The skipped file will then be still
						present in the source location.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="cospec2">
                <para>Skip all</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if a file name in the target
						location is the same as one of the files copied, the file will be
						skipped and not moved into the target directory. The selected files
						will not be moved</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Drag and Drop</guilabel>
                </para>
              </entry>
              <entry colname="cospec2">
                <para>Confirm mouse operation</para>
              </entry>
              <entry colname="colspec3">
                <para>When this option is selected and if an item is dragged and dropped by using the mouse, a dialog opens in which the user is asked what should happen:
		<itemizedlist>
		  <listitem><para><guilabel>Copy here</guilabel>: A copy of the item is created</para></listitem>
		  <listitem><para><guilabel>Move here</guilabel>: The item is moved</para></listitem>
		  <listitem><para><guilabel>Link here</guilabel>: A link to the item is created</para></listitem>
		  <listitem><para><guilabel>Cancel</guilabel>: No action is performed</para></listitem>
		</itemizedlist>
		</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gnome-commander-prefs-filters">
      <title>Filters</title>
      <!--Brief description-->
      <para>The filter section of the option dialog allows you to select which types of files are hidden.</para>
      <para>To modify the filter settings click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>, then click on the
       <guilabel>Filters</guilabel> tab.</para>
      <para>The description for the files you can add in the hidden section is in the
        <xref linkend="gcmd-TBL-setting5"></xref></para>
      <!-- ==== Figure ==== -->
      <figure id="options-filters-fig">
        <title>Filters options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_filters.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; filters preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <para/>
      <table frame="topbot" id="gcmd-TBL-setting5">
        <title>Filters option tab</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Header</para>
              </entry>
              <entry colname="colspec2">
                <para>Option</para>
              </entry>
              <entry colname="colspec3">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Filetypes to hide</guilabel>
                </para>
              </entry>
              <entry colname="colspec2">
                <para>Unknown</para>
              </entry>
              <entry colname="colspec3">
                <para>Unknown filetypes are files that MIME does not have a definition
                for (on this system).</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Regular files</para>
              </entry>
              <entry colname="colspec3">
                <para>Any normal files that contain text or binary executable.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Directories</para>
              </entry>
              <entry colname="colspec3">
                <para>Directories or folders are special types of files that contain a list of other files.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Fifo files </para>
              </entry>
              <entry colname="colspec3">
                <para>A FIFO file does not contain any user information. Instead, it allows two or more processes to communicate with each other by reading/writing to/from this file.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Socket files</para>
              </entry>
              <entry colname="colspec3">
                <para>Socket files are the representation of physical devices in the filesystem.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Character devices</para>
              </entry>
              <entry colname="colspec3">
                <para>A peripheral device that transfers data one byte at a time such as a serial port.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Block devices</para>
              </entry>
              <entry colname="colspec3">
                <para>A peripheral device that transfers a group of bytes of data at a time such as a disk.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Also hide</guilabel>
                </para>
              </entry>
              <entry colname="colspec2">
                <para>Hidden Files</para>
              </entry>
              <entry colname="colspec3">
                <para>Hidden files and directory in linux are preceded by the ".". Hidden files usually contain application settings</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Backup files</para>
              </entry>
              <entry colname="colspec3">
                <para>Backup files are standard files. They contain a previous version of a file using the same name. The extension of this file is usually changed to "~" or "bak".</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Symlinks</para>
              </entry>
              <entry colname="colspec3">
                <para>A symlink is an object linking to a file or a folder.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para></para>
              </entry>
              <entry colname="colspec2">
                <para>Backup files</para>
              </entry>
              <entry colname="colspec3">
                <para>If backup files are hidden you can add more filename extensions here that are used as backup files on your system.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
   </sect2>
    <!-- Preferred programs settings-->
    <sect2 id="gnome-commander-prefs-programs">
      <title>Programs</title>
      <!-- Brief description-->
      <para>This section of the options dialog lets you configure preferred applications for different tasks.
      In the <guilabel>Other favourite apps</guilabel> section you can specify even more applications for opening 
      certain document types. See <xref linkend="gcmd-TBL-setting6"></xref> and below for more information.</para>
      <!-- == Figure ==== -->
      <figure id="options-programs-fig">
        <title>Programs options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_programs.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; programs preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <para/>
      <para>
      	<table frame="topbot" id="gcmd-TBL-setting6">
          <title>Programs option tab</title>
          <tgroup cols="2" colsep="0" rowsep="0">
            <colspec colname="colspec0" colwidth="50.36*"/>
            <colspec colname="colspec1" colwidth="63.64*"/>
            <thead>
              <row rowsep="1">
              	<entry>
                  <para>Header</para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Option</para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Description</para>
              	</entry>
              </row>
            </thead>
            <tbody>
              <row>
              	<entry>
                  <para>
		    <guilabel>MIME application</guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Always download remote files before opening in external program</para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Whether the associated application is started before the remote file is downloaded locally.</para>
              	</entry>
              </row>
              <row>
            	<entry>
	          <para><guilabel>Standard programs</guilabel>
   	          </para>
            	</entry>
            	<entry colname="cospec2">
            	  <para>Viewer:</para>
            	</entry>
            	<entry colname="colspec3">
		  <para>Set which application is used when the view command is used by pressing the <keycap>F3</keycap> key. Default value: "gedit %s". %s is the variable containing the selected items. See <xref linkend="gcmd-TBL-setting7"></xref> tab for more information. By default &app; uses an internal viewer. See next row.</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Use internal viewer</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>When this option is activated (default) &app; uses its internal viewer to display the selected item, if it is deactivated the application defined above will be used instead.</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Editor:</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>In this text box you can type in the command line used to start your favourite text editor. Default value: "gedit %s"</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Differ:</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>In this text box you can type in the command line used to start your favourite comparison tool. %s is the variable containing the selected files to compare. Default value: "meld %s"</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Send files:</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>In this text box you can type in the command line used to send files to a preferred application. %s is the variable containing the selected files to be sent. Default value: "nautilus-sendto %s"</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Terminal:</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>In this text box you can type in the command line used to start you favourite terminal application. Default value: "gnome-terminal".</para>
            	</entry>
              </row>
	      <row>
            	<entry>
            	  <para><guilabel>Other favorite apps</guilabel></para>
            	</entry>
            	<entry colname="colspec2">
            	  <para>Add</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>You can add any other application in this section. The applications defined here will appear in the contextual menu. A dialog box is opened when you click on this button. This dialog box options are described below.</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Edit</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>Clicking this button will open a dialog were you can modify the parameters used to launch the application selected. The same dialog box as above is opened when you click on this button. This dialog box options are described below.</para>
            	</entry>
              </row>
	      <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Remove</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>Clicking this button will remove the application selected from the list.</para>
            	</entry>
              </row>
	      <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Up</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>Clicking this button will move the application up in the list, this will also affect the order in which the list is displayed in the contextual menu.</para>
            	</entry>
              </row>
	      <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Down</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>Clicking this button will move the application down in the list, this will also affect the order in which the list is displayed in the contextual menu.</para>
            	</entry>
              </row>
	      <row>
            	<entry>
            	  <para><guilabel>Global app options</guilabel></para>
            	</entry>
            	<entry colname="colspec2">
            	  <para>Terminal command for apps in the list above</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>In this text box you can type in the command line used to start your app from the list above with a favourite terminal application. %s is the variable used to pass the command to be executed  in the terminal. Default value: "gnome-terminal -e %s".</para>
            	</entry>
              </row>
              <row>
            	<entry><para></para></entry>
            	<entry colname="colspec2">
            	  <para>Leave terminal window open</para>
            	</entry>
            	<entry colname="colspec3">
            	  <para>With this checkbox you can decide if you want the leave a terminal window open when the command in it finishes.</para>
            	</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </para>
      <para>As you can see in the list above, "%s" can be used for filename expansion. All possible expansion types are listed in the table below:</para>
      <para>
      	<table frame="topbot" id="gcmd-TBL-setting7">
          <title>String expansion</title>
          <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50.36*"/>
          <colspec colname="colspec1" colwidth="63.64*"/>
          <thead>
            <row rowsep="1">
              <entry colname="colspec0">
                <para>String</para>
              </entry>
              <entry colname="colspec1">
                <para>Expands to...</para>
              </entry>
            </row>
            </thead>
            <tbody>
              <row>
            	<entry colname="cospec0">
            	  <para>%f</para>
            	</entry>
            	<entry colname="colspec1">
		  <para>File name (or list for multiple selections)</para>
            	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%F</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Quoted filename (or list for multiple selections)</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%p</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Full file system path (or list for multiple selections)</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%P</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Quoted full file system path (or list for multiple selections)</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%s</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Synonym for %P (for compatibility with previous versions of &app;)</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%u</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Fully qualified URI for the file (or list for multiple selections)</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%d</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Full path to the directory containing file</para>
              	</entry>
              </row>
              <row>
              	<entry colname="colspec0">
                  <para>%D</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Quoted full path to the directory containing file</para>
              	</entry>
              </row>
              <row rowsep="1">
              	<entry colname="colspec0">
                  <para>%%</para>
              	</entry>
              	<entry colname="colspec1">
                  <para>Percent sign</para>
              	</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </para>
      <para>The section below describes the process of adding or modifying other applications to the contextual menu</para>
      <para>In the <xref linkend="options-application-fig"></xref> box you can input a number of different parameters to run 
      the application you want. You will probably need to check the various options available for the application in its manual 
      pages.</para>
      <note><para>The dialog box used to modify existing applications is the same as the one described below.</para></note>
         <!-- ==== Figure ==== -->
      <figure id="options-application-fig">
        <title>New Application dialog</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_dialog_application.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; new application dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
            <para>
      	<table frame="topbot" id="gcmd-apps">
        		<title>New Application tab</title>
        			<tgroup cols="2" colsep="0" rowsep="0">
          			<colspec colname="colspec0" colwidth="50.36*"/>
          			<colspec colname="colspec1" colwidth="63.64*"/>
          				<thead>
            				<row rowsep="1">
              					<entry>
                					<para>Header</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Option</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Description</para>
              					</entry>
            				</row>
          				</thead>
          				<tbody>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Label:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>This text box contains the label that is displayed in the contextual menu.
                					</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Command:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>This text box contains the command line used to start the application and open the selected items.
                					</para>
                					<para><note><para>It is recommended that you read the help or the manual pages of the application to start it properly and to configure it with the correct options.</para></note></para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Icon:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Choose Icon
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Clicking on this button opens a dialog box where you can choose the Icon that will displayed in the contextual menu.
                					</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Options</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Can handle multiple files
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Whether the application can handle multiple file names to be passed in the command used to start it.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Can handle URIs
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Whether the application can handle a file name provided as a URI. This is especially important when you work on remote files. You can get more information about this in the Help and Manual pages of the application itself.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Requires terminal
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Whether the application requires a terminal to be opened. In this case &app; starts the application in an independent terminal.
                					</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Show for</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>All files
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>When this option is selected right clicking on any file will display the application in the contextual menu.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>All directories
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>When this option is selected right clicking on any directory will display the application in the contextual menu.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>All directories and files
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>When this option is selected right clicking on any file or directory will display the application in the contextual menu.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Some files
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>When this option is selected right clicking on the files specified in the <guimenu>File patterns</guimenu> below will display the application in the contextual menu.
                					</para>
              					</entry>
            				</row><row>
              					<entry>
                					<para>
					                  <guilabel></guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>File patterns
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>This contains the file extensions specific to the application. The syntax is as follow: "*.extension" use ";" as a separator between the different extensions if there are more than one.
                					</para>
              					</entry>
            				</row>
            			</tbody>
            		</tgroup>
            	</table>
            	</para>
    </sect2>
    <sect2 id="gnome-commander-prefs-devices">
      <title>Devices</title>
      <!--Brief description -->
      <para>This section of the option dialog lets you configure devices so that you can access them by pressing a button in the device buttons toolbar or an entry in the connections menu.</para>
      <para>This can be useful if you have configured devices through your fstab file. In this case, these devices might not be shown automatically in the devices buttons toolbar.</para>
      <itemizedlist>
	      <listitem><para>In the <guilabel>Devices</guilabel> window all devices which have been added manually are shown together with their icon.</para></listitem>
       	<listitem><para>Below the <guilabel>Devices</guilabel> window you have two options:
	        <itemizedlist>
	          <listitem><para><guilabel>Show Samba workgroups icons</guilabel>: If activated, a SMB workgroups icon will be shown in the device buttons toolbar.</para></listitem>
	          <listitem><para><guilabel>Show only the icons</guilabel>: If activated, device icons are shown without their alias name in the device buttons toolbar.</para></listitem>
	      </itemizedlist></para></listitem>
      </itemizedlist>
      <para>On the right hand side there are five buttons, described in the <xref linkend="gcmd-dev"></xref> table below.</para>
      <!-- ==== Figure ==== -->
      <figure id="options-devices-fig">
        <title>Devices options</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_options_devices.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; devices preferences dialog.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
      <para>
      	<table frame="topbot" id="gcmd-dev">
          <title>Devices tab</title>
          <tgroup cols="2" colsep="0" rowsep="0">
            <colspec colname="colspec0" colwidth="50.36*"/>
            <colspec colname="colspec1" colwidth="63.64*"/>
            <thead>
              <row rowsep="1">
              	<entry>
                  <para>Header</para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Option</para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Description</para>
              	</entry>
              </row>
            </thead>
            <tbody>
              <row>
              	<entry>
                  <para>
		    <guilabel>Devices:</guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Add:
                  </para>
              	</entry>
              	<entry colname="colspec3">
                  <para>You can add a device by pressing this button. The device defined here will appear in the device buttons toolbar and an entry in the connections menu. A dialog box is opened when you click on this button.
                  </para>
              	</entry>
              </row>
              <row>
              	<entry>
                  <para>
		    <guilabel></guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Edit:
                  </para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Clicking this button will open a dialog were you can modify a device which is selected in the <guimenu>Devices</guimenu> window list.
                  </para>
              	</entry>
              </row>
              <row>
              	<entry>
                  <para>
		    <guilabel></guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Remove:
                  </para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Clicking this button will remove the application selected from the <guimenu>Devices</guimenu> window list.
                  </para>
              	</entry>
              </row>
              <row>
              	<entry>
                  <para>
		    <guilabel></guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Up:
                  </para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Clicking this button will move the device up in the list. This will also affect the order in which the list is displayed in the contextual menu.
                  </para>
              	</entry>
            	</row><row>
              	<entry>
                  <para>
		    <guilabel></guilabel>
               	  </para>
              	</entry>
              	<entry colname="colspec2">
                  <para>Down:
                  </para>
              	</entry>
              	<entry colname="colspec3">
                  <para>Clicking this button will move the device down in the list. This will also affect the order in which the list is displayed in the contextual menu.
                  </para>
              	</entry>
	      </row>
            </tbody>
          </tgroup>
        </table>
      </para>
      <note><para>The dialog box used to add new and to modify existing devices is the same. The explanation for this one follows below.</para></note>
      <para>
      	<table frame="topbot" id="options-edit-dev-tab">
        		<title>Devices option tab</title>
        			<tgroup cols="2" colsep="0" rowsep="0">
          			<colspec colname="colspec0" colwidth="50.36*"/>
          			<colspec colname="colspec1" colwidth="63.64*"/>
          				<thead>
            				<row rowsep="1">
              					<entry>
                					<para>Header</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>Option</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>Description</para>
              					</entry>
            				</row>
          				</thead>
          				<tbody>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Alias:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>This text box contains the label that is displayed in the contextual menu.
                					</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Device/Label:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                          <para>This text box contains the device which should be accessed. Usually it is located in the /dev directory, so you can for example write /dev/sdx1 here. The device would then be mounted via "mount /dev/sdx1".
                          On the other hand you can also add a label of a device which you have configured in the system fstab. If the string entered in the text box does not start with a "/" character (e.g. Media), the device is mounted with "mount -L" (e.g. "mount -L Media").
                					</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Mount point:</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                          <para>Here you specify where the device should be mounted to, so that &app; knows where to jump to when the mount was successful, for example /mnt/cdrom.</para>
              					</entry>
            				</row>
            				<row>
              					<entry>
                					<para>
					                  <guilabel>Icon</guilabel>
               					</para>
              					</entry>
              					<entry colname="colspec2">
                					<para>
                					</para>
              					</entry>
              					<entry colname="colspec3">
                					<para>By clicking on the button you can specify the icon which should be displayed in the contextual menu.
                					</para>
              					</entry>
            				</row>
            			</tbody>
            		</tgroup>
            	</table>
            	</para>
    </sect2>
  </sect1>

<!-- ============= Keyboard shortcuts ===================== -->
<!-- This section contains info about the keyboard mappings.-->
  <sect1 id="gnome-commander-keyboard">
    <title>Keyboard Shortcuts</title>
    <para>In this section the keyboard shortcuts in &app; are presented. In the table below you will find each keyboard shortcut, its mappings and an info if it is user definable.</para>
    <para>If you want to know more about how to change a keyboard shortcut or how to assign a new one (if user definable), look at the section <xref linkend="gnome-commander-user-actions"></xref>.</para>
    <tip><para>The daily usage of &app; is very effective if you know by heart at least the most important keyboard shortcuts for moving and file handling (see section <xref linkend="gnome-commander-usage"></xref>). Learn them and &app; will be an even more effective tool for you.</para></tip>
    <note>
      <para>Some keyboard shortcuts may not work as expected under your environment, e.g. GNOME.
                The reason for that is that the environment uses some global
                shortcuts (i.e. <keycombo><keycap>ALT</keycap><keycap>F7</keycap></keycombo> moves the entire application window in GNOME),
                which suppresses assigned keyboard mapping of &app;. Use the
                keyboard shortcuts preference tool of your environment to customize the default keyboard
                shortcuts to your requirements.</para>
    </note>
    <informaltable frame="topbot">
      <tgroup cols="2">
        <colspec colname="col1"/>
        <colspec colname="col2"/>
        <thead>
        <row valign="top">
            <entry colname="col1" colsep="0" valign="top"><para>Shortcut</para></entry>
            <entry colname="col2" valign="top"><para>Mapping</para></entry>
            <entry colname="col3" align="center" valign="top"><para>User definable</para></entry>
        </row>
        </thead>
        <tbody>
        <row valign="top">
            <entry><para><keycombo><keycap>F1</keycap></keycombo></para></entry>
            <entry><para>Help</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F2</keycap></keycombo></para></entry>
            <entry><para>Rename a file</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F3</keycap></keycombo></para></entry>
            <entry><para>View files</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F4</keycap></keycombo></para></entry>
            <entry><para>Edit file</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F5</keycap></keycombo></para></entry>
            <entry><para>Copy files</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F6</keycap></keycombo></para></entry>
            <entry><para>Rename or move files</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F7</keycap></keycombo></para></entry>
            <entry><para>Create directory</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F8</keycap></keycombo></para></entry>
            <entry><para>Delete files</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F9</keycap></keycombo></para></entry>
            <entry><para>Search</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>F12</keycap></keycombo></para></entry>
            <entry><para>Display main menu</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>1</keycap></keycombo></para></entry>
            <entry><para>Change left connection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>2</keycap></keycombo></para></entry>
            <entry><para>Change right connection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>F3</keycap></keycombo></entry>
            <entry><para>View with external viewer</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>F7</keycap></keycombo></entry>
            <entry><para>Search</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>F8</keycap></keycombo></entry>
            <entry><para>Open the history list for the command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>DOWN</keycap></keycombo></entry>
            <entry><para>Open the history list of visited directories</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>SHIFT</keycap><keycap>F2</keycap></keycombo></entry>
            <entry><para>Compare directories</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>SHIFT</keycap><keycap>F3</keycap></keycombo></entry>
            <entry><para>View with internal viewer</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>SHIFT</keycap><keycap>F4</keycap></keycombo></entry>
            <entry><para>Edit a new file</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>SHIFT</keycap><keycap>F5</keycap></keycombo></entry>
            <entry><para>Make a copy of the file in the current directory.</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>SHIFT</keycap><keycap>F6</keycap></keycombo></entry>
            <entry><para>Rename a file</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SHIFT</keycap><keycap>F10</keycap></keycombo></para></entry>
            <entry><para>Bring up the context menu for the selected files.</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F3</keycap></keycombo></entry>
            <entry><para>Sort by name</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F4</keycap></keycombo></entry>
            <entry><para>Sort by extension</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F5</keycap></keycombo></entry>
            <entry><para>Sort by date/time</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F6</keycap></keycombo></entry>
            <entry><para>Sort by size</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F7</keycap></keycombo></entry>
            <entry><para>Unsorted</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>F5</keycap></keycombo></para></entry>
            <entry><para>Create symbolic link</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SUPER</keycap><keycap>1</keycap></keycombo></para></entry>
            <entry><para>Change left connection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SUPER</keycap><keycap>2</keycap></keycombo></para></entry>
            <entry><para>Change right connection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SUPER</keycap><keycap>F</keycap></keycombo></para></entry>
            <entry><para>Search files</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>=</keycap></keycombo></entry>
            <entry><para>Select files using a pattern</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>NUM +</keycap></keycombo></entry>
            <entry><para>Select files using a pattern</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>NUM -</keycap></keycombo></entry>
            <entry><para>Unselect files using a pattern</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>NUM *</keycap></keycombo></entry>
            <entry><para>Invert selection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>NUM /</keycap></keycombo></entry>
            <entry><para>Restore selection</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>=</keycap></keycombo></entry>
            <entry><para>Select all files</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>-</keycap></keycombo></entry>
            <entry><para>Unselect all files</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>NUM +</keycap></keycombo></entry>
            <entry><para>Select all files with the same extension</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>ALT</keycap><keycap>NUM -</keycap></keycombo></entry>
            <entry><para>Unselect all files with the same extension</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>BACKSPACE</keycap></keycombo></para>
                   <para><keycombo><keycap>CTRL</keycap><keycap>PageUp</keycap></keycombo></para></entry>
            <entry><para>Change to parent directory (cd ..)</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ENTER</keycap></keycombo></para></entry>
            <entry><para>Change directory or execute command line if not empty</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SHIFT</keycap><keycap>ENTER</keycap></keycombo></para></entry>
            <entry><para>Execute command line in the defined terminal and leaves the terminal window open</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>PageDown</keycap></keycombo></para></entry>
            <entry><para>Change directory</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>LEFT</keycap></keycombo></para></entry>
            <entry><para>Go back to the last visited directory</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>RIGHT</keycap></keycombo></para></entry>
            <entry><para>Go forward to the next visited directory</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>\</keycap></keycombo></para></entry>
            <entry><para>Go to the root directory</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>~</keycap></keycombo></para>
                   <para><keycombo><keycap>CTRL</keycap><keycap>`</keycap></keycombo></para></entry>
            <entry><para>Go to the home directory</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>INSERT</keycap></keycombo></para></entry>
            <entry><para>Select file or directory</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SPACE</keycap></keycombo></para></entry>
            <entry><para>Select file or directory (as <keycombo><keycap>INSERT</keycap></keycombo>).
                         If <keycombo><keycap>SPACE</keycap></keycombo> is used on an unselected directory under the cursor,
                         the contents in this directory are counted and the size is shown in the "full" view instead of the string DIR</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>ENTER</keycap></keycombo></para></entry>
            <entry><para>Show properties for the selected file</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>SHIFT</keycap><keycap>ENTER</keycap></keycombo></para></entry>
            <entry><para>The contents of all directories in the current directory are counted. The sizes of the directories are then shown
            in the "full" view instead of the string DIR</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>DELETE</keycap></keycombo></para></entry>
            <entry><para>Delete files</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>SHIFT</keycap><keycap>DELETE</keycap></keycombo></para></entry>
            <entry><para>Delete files permanently (do not move them to the trash can, even if this is configured in the options)</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>C</keycap></keycombo></entry>
            <entry><para>Copy files to clipboard (not a global one yet)</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>X</keycap></keycombo></entry>
            <entry><para>Cut files to clipboard (not a global one yet)</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>V</keycap></keycombo></entry>
            <entry><para>Paste from clipboard to current dir (not a global one yet)</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>C</keycap></keycombo></entry>
            <entry><para>Copy selected file names to clipboard</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>A</keycap></keycombo></entry>
            <entry><para>Select all files</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>A</keycap></keycombo></entry>
            <entry><para>Unselect all files</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>D</keycap></keycombo></entry>
            <entry><para>Open favorite directories (bookmarks)</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>M</keycap></keycombo></entry>
            <entry><para>Advanced Rename Tool</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>TAB</keycap></keycombo></para></entry>
            <entry><para>Switch between left and right file list</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>U</keycap></keycombo></entry>
            <entry><para>Switch between left and right file list</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>LEFT</keycap></keycombo></para></entry>
            <entry><para>Copy the current working directory from the active left file list to the right one</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>RIGHT</keycap></keycombo></para></entry>
            <entry><para>Copy the current working directory from the active right file list to the left one</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>.</keycap></keycombo></entry>
            <entry><para>Copy the current working directory from the inactive file list to the active one</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>.</keycap></keycombo></entry>
            <entry><para>Copy the current working directory from the active file list to the inactive one</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>S</keycap></keycombo></entry>
            <entry><para>Open slide popup for setting the panel sizes</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>T</keycap></keycombo></entry>
            <entry><para>Open directory in a new tab</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>W</keycap></keycombo></entry>
            <entry><para>Close current tab</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>W</keycap></keycombo></entry>
            <entry><para>Close all tabs</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>TAB</keycap></keycombo></entry>
            <entry><para>Switch to the next tab</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>TAB</keycap></keycombo></entry>
            <entry><para>Switch to the previous tab</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>R</keycap></keycombo></entry>
            <entry><para>Refresh the active file list</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>O</keycap></keycombo></entry>
            <entry><para>Options dialog</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>H</keycap></keycombo></entry>
            <entry><para>Toggle hidden files on/off</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>=</keycap></keycombo></entry>
            <entry><para>Set both panels equal</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>N</keycap></keycombo></entry>
            <entry><para>Open new remote connection</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>F</keycap></keycombo></entry>
            <entry><para>Connect to remote server</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>F</keycap></keycombo></entry>
            <entry><para>Disconnect from remote server</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>5</keycap></keycombo></entry>
            <entry><para>Create MD5 (128-bit) checksum</para></entry>
            <entry><para>yes</para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ALT</keycap><keycap>Letter(s)</keycap></keycombo></para>
                   <para><keycombo><keycap>CTRL</keycap><keycap>ALT</keycap><keycap>Letter(s)</keycap></keycombo></para></entry>
            <entry><para>Quick search for a file name (starting with specified letter) in the current directory</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>Letter</keycap></keycombo></para></entry>
            <entry><para>Redirect to command line, cursor jumps to command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>ESC</keycap></keycombo></para></entry>
            <entry><para>Clear the command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>K</keycap></keycombo></entry>
            <entry><para>Delete to the end of line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>W</keycap></keycombo></entry>
            <entry><para>Delete the word to the left of the cursor</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>T</keycap></keycombo></entry>
            <entry><para>Delete the word to the right of the cursor</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>P</keycap></keycombo></entry>
            <entry><para>The full path of the current directory is added to the command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>ENTER</keycap></keycombo></entry>
            <entry><para>The file name under the cursor in the source directory is added to the end of the command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>ENTER</keycap></keycombo></entry>
            <entry><para>The file name under the cursor including its path is added to the end of the command line</para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para></para></entry>
            <entry><para></para></entry>
            <entry><para></para></entry>
        </row>
        <row valign="top">
            <entry><para><keycombo><keycap>CTRL</keycap><keycap>DOWN</keycap></keycombo></para>
                   <para><keycombo><keycap>CTRL</keycap><keycap>E</keycap></keycombo></para>
                   <para><keycombo><keycap>ALT</keycap><keycap>F8</keycap></keycombo></para></entry>
            <entry><para>A list with the latest command lines (history list) is opened. Use the <keycombo><keycap>UP</keycap></keycombo>
            and <keycombo><keycap>DOWN</keycap></keycombo> cursor keys to select an entry.
            By pressing the <keycombo><keycap>LEFT</keycap></keycombo> or <keycombo><keycap>RIGHT</keycap></keycombo> key, you can edit the command line.
            This automatically closes the list</para></entry>
            <entry><para/></entry>
        </row>
        </tbody>
      </tgroup>
    </informaltable>
  </sect1>

<!-- ============= User actions ===================== -->
<!-- This section contains info about the user actions.-->
  <sect1 id="gnome-commander-user-actions">
    <title>User Actions</title>
    <para>User actions trigger predefined functions (actions) and make &app; very flexible. They are accessed by a key or set of keys (shortcut key). </para>
    <sect2 id="gnome-commander-user-actions-managing">
      <title>Managing user actions</title>
      <para>The menu for user actions and associated keyboard shortcuts can be opened by clicking on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Keyboard Shortcuts...</guimenuitem></menuchoice>. Below, the usage of the dialog is <guimenuitem>Keyboard Shortcuts...</guimenuitem> explained.</para>
      <para>In the keyboard shortcut dialog a table with three columns is shown:
      <orderedlist>
	<listitem><para><guilabel>Shortcut Key</guilabel>: Key combination the user has to press to perform the action.</para></listitem>
	<listitem><para><guilabel>Action</guilabel>: Action to perform by pressing the shortcut key.</para></listitem>
	<listitem><para><guilabel>Options</guilabel>: Some user actions require an option to perform the action, e.g. the command to be executed by the &quot;Execute command&quot; action.</para></listitem>
      </orderedlist></para>
      <para>You can <guilabel>Add</guilabel> a new shortcut and <guilabel>Remove</guilabel> a selected one with the related buttons on the right.</para>
      <para>The default dialog window is shown in the figure <xref linkend="keyboard-shortcuts"></xref> below.</para>
      <para>Available user actions are shown in the table <xref linkend="gnome-commander-user-actions-list"></xref> below.</para> 
      <para>Find the default key bindings in the previous section <xref linkend="gnome-commander-keyboard"></xref>.</para>
      <tip>
        <para>It&apos;s possible to assign more than one key combinations to an action. 
	To do so, click on the <guilabel>Add</guilabel> button, choose a new shortcut 
	and choose the action which is already assigned to another shortcut. Some actions 
	are already assigned to multiple shortcuts by default.</para>
      </tip>
      <para>Key bindings are stored in the &lt;KeyBindings&gt; section of &app; config file (<guilabel>~/.gnome-commander/gnome-commander.xml</guilabel>).</para>
         <!-- ==== Figure ==== -->
      <figure id="keyboard-shortcuts">
        <title>Keyboard Shortcuts</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome-commander_dialog_keyboard_shortcuts.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; keyboard shortcuts.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <!-- ==== End of Figure ==== -->
    </sect2>
    <sect2 id="gnome-commander-user-actions-list">
        <title>List of user actions</title>
        <informaltable frame="topbot">
            <tgroup cols="2">
                <colspec colname="col1"/>
                <colspec colname="col2"/>
                <thead>
                    <row valign="top">
                        <entry colname="col1" colsep="0" valign="top"><para>User action</para></entry>
                        <entry colname="col2" valign="top"><para>Description</para></entry>
                    </row>
                </thead>
                <tbody>
                    <row valign="top">
                        <entry><para>About &app;</para></entry>
                        <entry><para>About &app;</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Advanced rename tool</para></entry>
                        <entry><para>Advanced rename tool</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Back one directory</para></entry>
                        <entry><para>Go back to the last visited directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Back to the first directory</para></entry>
                        <entry><para>Go forward to the first visited directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Bookmark current directory</para></entry>
                        <entry><para>Bookmark current directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Change directory</para></entry>
                        <entry><para>Change directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Change left connection</para></entry>
                        <entry><para>Change left connection</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Change owner/group</para></entry>
                        <entry><para>Change file ownership</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Change permissions</para></entry>
                        <entry><para>Change file access permissions</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Change right connection</para></entry>
                        <entry><para>Change right connection</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Close all tabs</para></entry>
                        <entry><para>Close all tabs</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Close connection</para></entry>
                        <entry><para>Disconnect from remote server</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Close duplicate tabs</para></entry>
                        <entry><para>Close duplicate tabs</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Close the current tab</para></entry>
                        <entry><para>Close the current tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Compare directories</para></entry>
                        <entry><para>Compare directories</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Compare files (diff)</para></entry>
                        <entry><para>Compare files using the differ in <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem><guimenuitem>Programs</guimenuitem></menuchoice></para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Configure plugins</para></entry>
                        <entry><para>Configure plugins</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Copy</para></entry>
                        <entry><para>Copy files to clipboard (not a global one yet)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Copy files</para></entry>
                        <entry><para>Copy files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Copy file names</para></entry>
                        <entry><para>Copy file names to clipboard</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Copy files with rename</para></entry>
                        <entry><para>Copy file with rename</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Create directory</para></entry>
                        <entry><para>Create directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Create symbolic link</para></entry>
                        <entry><para>Create symbolic link</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Cut</para></entry>
                        <entry><para>Cut files to clipboard (not a global one yet)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Delete</para></entry>
                        <entry><para>Delete files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Delete files</para></entry>
                        <entry><para>Delete files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Display main menu</para></entry>
                        <entry><para>Display main menu</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Do nothing</para></entry>
                        <entry><para>Do nothing (use to block key bindings)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Edit a new file</para></entry>
                        <entry><para>Edit a new file</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Edit file</para></entry>
                        <entry><para>Edit file</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Equal panel size</para></entry>
                        <entry><para>Set equal panes (50/50)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Execute command</para></entry>
                        <entry><para>Execute user defined command. &app; replaces found placeholders with:</para>
                               <para></para>
                                    <itemizedlist>
                                        <listitem>
                                            <para><guilabel>%f</guilabel> file name (or list for multiple selections)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%F</guilabel> quoted filename (or list for multiple selections)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%p</guilabel> full file system path (or list for multiple selections)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%P</guilabel> quoted full file system path (or list for multiple selections)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%u</guilabel> fully qualified URI for the file (or list for multiple selections)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%d</guilabel> full path to the directory containing file</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%D</guilabel> quoted full path to the directory containing file</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%s</guilabel> synonym for <guilabel>%P</guilabel> (for compatibility with previous versions of &app;)</para>
                                        </listitem>
                                        <listitem>
                                            <para><guilabel>%%</guilabel> percent sign</para>
                                        </listitem>
                                    </itemizedlist>
                                    <note>
                                        <para>Unknown placeholders are copied verbatim without any substitution.</para>
                                    </note></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Forward one directory</para></entry>
                        <entry><para>Go forward to the next visited directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Forward to the last directory</para></entry>
                        <entry><para>Go forward to the last visited directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>&app; on the web</para></entry>
                        <entry><para>Visit &app; home page</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Go to bookmarked location</para></entry>
                        <entry><para>Go to bookmarked location.</para>
                               <note><para>Nonexistent bookmark names are ignored.</para></note></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Help contents</para></entry>
                        <entry><para>Help</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Help on keyboard shortcuts</para></entry>
                        <entry><para>Help on keyboard shortcuts</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Home directory</para></entry>
                        <entry><para>Go to the home directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Invert selection</para></entry>
                        <entry><para>Invert selection</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Keyboard shortcuts</para></entry>
                        <entry><para>Configure keyboard shortcuts</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Lock/unlock tab</para></entry>
                        <entry><para>Lock/unlock tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Manage bookmarks</para></entry>
                        <entry><para>Open favourite directories (bookmarks) dialog</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Maximize panel size</para></entry>
                        <entry><para>Maximize panel size</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Move files</para></entry>
                        <entry><para>Move files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>New connection</para></entry>
                        <entry><para>Open new remote connection</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Next tab</para></entry>
                        <entry><para>Next tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open connection</para></entry>
                        <entry><para>Open remote connection</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in a new tab</para></entry>
                        <entry><para>Open directory in a new tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the active window</para></entry>
                        <entry><para>Copy the current working directory from the inactive file list to the active one</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the inactive window</para></entry>
                        <entry><para>Copy the current working directory from the active file list to the inactive one</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the left window</para></entry>
                        <entry><para>Copy the current working directory from the active right file list to the left one</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the new tab</para></entry>
                        <entry><para>Open directory in the new tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the new tab (inactive window)</para></entry>
                        <entry><para>Open directory in the new tab (inactive window)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open directory in the right window</para></entry>
                        <entry><para>Copy the current working directory from the active left file list to the right one</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open folder</para></entry>
                        <entry><para>Open the current location in Nautilus file manager</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open terminal</para></entry>
                        <entry><para>Open terminal in the current directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Open terminal as root</para></entry>
                        <entry><para>Opens a terminal with root privileges.</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Options</para></entry>
                        <entry><para>Options dialog</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Paste</para></entry>
                        <entry><para>Paste from clipboard to current directory (not a global one yet)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Previous tab</para></entry>
                        <entry><para>Previous tab</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Properties</para></entry>
                        <entry><para>Show properties for the selected file</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Quick search</para></entry>
                        <entry><para>Quick search</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Quit</para></entry>
                        <entry><para>Exit &app;</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Refresh</para></entry>
                        <entry><para>Refresh the active file list</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Rename files</para></entry>
                        <entry><para>Rename files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Report a problem</para></entry>
                        <entry><para>Report problem to gitlab.gnome.org</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Root directory</para></entry>
                        <entry><para>Go to the root directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Search</para></entry>
                        <entry><para>File search</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Select all</para></entry>
                        <entry><para>Select all files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Send files</para></entry>
                        <entry><para>Send files via email or instant messenger (using nautilus-sendto)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Show directory history</para></entry>
                        <entry><para>Open the history list of visited directories</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Show user defined files</para></entry>
                        <entry><para>Use file selection filter</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Start &app; as root</para></entry>
                        <entry><para>Start &app; in root mode at the same location</para>
                               <warning><para>Be careful while running &app; with root privileges
                                              as you may damage your system.</para></warning></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Synchronize directories</para></entry>
                        <entry><para>Synchronize directories (using meld)</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Toggle selection</para></entry>
                        <entry><para>Toggle selection for cursor</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Toggle selection and move cursor downward</para></entry>
                        <entry><para>Select file or directory and move cursor downward</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Unselect all</para></entry>
                        <entry><para>Unselect all files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>Up one directory</para></entry>
                        <entry><para>Go forward to the parent directory</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>View file</para></entry>
                        <entry><para>View files</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>View with external viewer</para></entry>
                        <entry><para>View with external viewer</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>View with internal viewer</para></entry>
                        <entry><para>View with internal viewer</para></entry>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>
    </sect2>
  </sect1>

<!-- ================= Additional Popup Menu Actions ================= -->
<!-- This section contains info about the simple plugin system of gcmd.-->
  <sect1 id="popup-menu-actions">
    <title>Additional Pop-up Menu Actions</title>
    <sect2 id="popup-menu-actions-introduction">
        <title>Introduction</title>
        <para>
            The pop-up menu of &app;, which can be opened by right-clicking on a file or folder or by pressing
            <keycombo><keycap>SHIFT</keycap><keycap>F10</keycap></keycombo>, can be easily extended by putting executable files into
            <guilabel>~/.config/gnome-commander/scripts/</guilabel>. For each file in this directory a separate entry in the pop-up menu will be displayed.
            When such a menu entry is clicked, the associated script will be executed with the names of all selected items as arguments. When the
            <keycap>SHIFT</keycap> key is pressed while clicking the pop-up menu entry, the script will be called separately for each selected file.
        </para>
        <figure id="popup-menu-actions-example-fig">
            <title>Example picture of the pop-up menu with four additional entries</title>
            <screenshot>
                <mediaobject>
                    <imageobject>
                        <imagedata fileref="figures/gnome-commander_simple_plugins_example.png" format="PNG"/>
                    </imageobject>
                </mediaobject>
            </screenshot>
        </figure>
    </sect2>
    <sect2 id="popup-menu-actions-file-format">
        <title>File format</title>
        <para>
            The files can be binary or simple text files. In the latter case it is possible to handle some config variables over to &app;
            by using a key-value format: <guilabel>#[key]: [value]</guilabel>, with '#' being the first character in a text line.
        </para>
        <para>Currently, the following keys are implemented:</para>
        <informaltable frame="topbot">
            <tgroup cols='3'>
                <colspec colname="Key"/>
                <colspec colname="Description"/>
                <colspec colname="Comment"/>
                <tbody>
                    <row valign="top">
                        <entry><para>name</para></entry>
                        <entry><para>The label of the menu item</para></entry>
                        <entry><para>If undefined, the script file name will be used</para></entry>
                    </row>
                    <row valign="top">
                        <entry><para>term</para></entry>
                        <entry><para>Run the script in a terminal window</para></entry>
                        <entry><para>To activate this, set value to 'true'</para></entry>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>
    </sect2>
    <sect2 id="popup-menu-actions-examples">
        <title>Example Pop-up menu scripts</title>
        <para>Some example scripts can be found <ulink url="https://gitlab.gnome.org/GNOME/gnome-commander/tree/master/gcmd-scripts" type="https">online</ulink> in
        the &app; git repository.</para>
    </sect2>
  </sect1>

      <!-- ============= Tips and tricks ======================== -->
      <!-- This section contains info some very simple tips and tricks.-->
      <sect1 id="gnome-commander-tips-and-tricks">
	<title>Tips and Tricks</title>
	<para>Some very simple tips and tricks on using and getting the most out of &app;.</para>
	<sect2 id="gnome-commander-handling-archives">
	  <title>Handling Archives</title>
	  <para>&app; still lacks built-in browsing of compressed archives. However the program can be configured so
	  that working with archives becomes quite practical anyway.</para> 
	  <para>There are two different ways: The preferred one is to activate the built-in 
	  <application>Fileroller</application> plugin in the menu 
	  <menuchoice><guimenu>Plugins</guimenu><guimenuitem>Configure Plugins...</guimenuitem></menuchoice>. By 
	  activating this plugin you get additional entries in the popup menu by right clicking on selected files 
	  and folders (make sure that <application>Fileroller</application> is installed in your system). 
	  By clicking on an archive, the popup menu lets you choose where to extract the archive to.</para>
	  <para>The second, outdated but still working way is the following:</para>
	  <itemizedlist>
            <listitem>
	      <para>
		If you don&apos;t already have the program <application>Fileroller</application>,
              download it and install it.</para>
            </listitem>
            <listitem>
	      <para>Open the <guimenu>Options</guimenu> dialog and go to the <guimenuitem>Programs</guimenuitem> tab.</para>
            </listitem>
            <listitem>
	      <para>Add two favorite apps using the values shown in the figures below.</para>
            </listitem>
	  </itemizedlist>
	  <para>You can now right click any file or folder and choose <guimenuitem>Create archive...</guimenuitem>
	  to compress it and right click compressed files and choose <guimenuitem>Extract archive...</guimenuitem>
	  to extract it.</para>
          <!-- ==== Figure ==== -->
	  <figure id="create-archive">
            <title>Create Archive</title>
            <screenshot>
              <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/create_archive.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>This entry allows creating archives easily.</phrase>
		</textobject>
              </mediaobject>
            </screenshot>
	  </figure>
	  <!-- ==== End of Figure ==== -->
	  <!-- ==== Figure ==== -->
	  <figure id="extract-archive">
            <title>Extract Archive</title>
            <screenshot>
              <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/extract_archive.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>This entry allows extract archives easily.</phrase>
		</textobject>
              </mediaobject>
            </screenshot>
	  </figure>
	  <!-- ==== End of Figure ==== -->
	</sect2>
	<sect2 id="gnome-commander-copy-path-names">
	  <title>Copying File Names and Paths</title>
          <itemizedlist>
            <listitem>
	      <para>To copy names of selected files to the environment's clipboard, use the Copy File Names action 
	      on the <guimenu>Edit</guimenu> menu or the "**" icon on the toolbar.</para>
            </listitem>
            <listitem>
	      <para>To copy full paths of selected files to the environment's clipboard, hold down
	      <keycap>SHIFT</keycap> while activating either the Copy File Names action on the <guimenu>Edit</guimenu> 
	      menu or the "**" icon on the toolbar.</para>
            </listitem>
            <listitem>
	      <para>To copy the full path of the current directory, right click on the directory indicator at the top
          of the directory list.</para>
            </listitem>
            <listitem>
	      <para>To insert the current file's path in &app;'s command line, press 
	      <keycombo><keycap>CTRL</keycap><keycap>SHIFT</keycap><keycap>ENTER</keycap></keycombo>.</para>
            </listitem>
            <listitem>
	      <para>To insert the current file's name in &app;'s command line, press 
	      <keycombo><keycap>CTRL</keycap><keycap>ENTER</keycap></keycombo>.</para>
            </listitem>
          </itemizedlist>
	</sect2>
  </sect1>

<!-- ============= Installation =========================== -->
<!-- This section contains info about the program installation.-->
  <sect1 id="gnome-commander-installation">
    <title>&app; Installation</title>
    <sect2 id="gnome-commander-getting-app">
      <title>Getting &app;</title>
      <para>
            It&apos;s recommended to use the &app; package that is provided by your distribution.
            Refer to &app; for the <ulink type="http" url="https://gcmd.github.io/download.html#external">list of distributions</ulink>
            supporting &app; packages.
        </para>
      <para>
            All current and historical releases can be found on the <ulink type="http" url="http://ftp.gnome.org/pub/GNOME/sources/gnome-commander/">GNOME FTP server</ulink>, too.
        </para>
    </sect2>
    <sect2 id="gnome-commander-versioning">
      <title>Versioning</title>
      <para>
        &app; is being developed in a stable and a testing branch, where the test releases fill the purpose of testing new ideas.
        Successful ones will then get backported to the stable branch. The version numbers (major, minor and micro) follows
        the quite usual standard of odd and even versioning, where odd minor versions stands for the unstable releases
        and the even numbered branch eventually gets the thoroughly tested new functions backported.</para>
    </sect2>
    <sect2 id="gnome-commander-stable-version">
      <title>Current stable version</title>
      <para>If you'd like to compile the latest stable version of &app; yourself, get it as a tar.xz
      file from the <ulink type="http" url="https://gcmd.github.io/download.html">download section</ulink>
      on the &app; home page.</para>
      <para>After extracting the archive, first have a look at the <guimenu>README</guimenu> file, 
      where you get an overview of the downloaded release. Also, have a look at the 
      <guimenu>INSTALL</guimenu> file. The installation is explained in detail there.</para>
    </sect2>
    <sect2 id="gnome-commander-development-version">
      <title>Development version</title>
      <para>For those of you who feel really adventurous, or maybe want to hack on the freshest code,
        the latest development source snapshots are available by using git:</para>
      <para>
        <command>git clone https://gitlab.gnome.org/GNOME/gnome-commander.git</command>
      </para>
      <note>
        <para>The above works only to do a first time download and not for updating the code,
        if you already have a version of the code simply run <command>git pull</command> to get the latest revisions.</para>
      </note>
      <para>Just remember to run <command>./autogen.sh</command> before building by <command>make</command>.</para>
      <warning><para>Be aware that there can be serious bugs in code from GNOME git repository. 
      This code is intended for hacking, development and testing purposes only.</para></warning>
    </sect2>
  </sect1>

<!-- ============= Configuration files ==================== -->
<!-- This section contains info about the program configuration files.-->
  <sect1 id="gnome-commander-configuration-files">
    <title>Configuration Files</title>
    <para>This section gives an overview of the configuration files used by &app;:
    </para>
    <note>
        <para>
          Since &app; version 1.10.0 the location of configuration files changed from <guilabel>~/.gnome-commander</guilabel>
          to <guilabel>~/.config/gnome-commander</guilabel>. Existing files are automatically moved when starting &app; 1.10.0
          the first time.
        </para>
    </note>
    <para>
      <term>
        <guilabel>~/.config/gnome-commander/scripts/*</guilabel>
      </term>
      In this directory the user can place scripts for the <xref linkend="popup-menu-actions"></xref>.
    </para>
    <note>
      <para>
        Since &app; version 1.10.0 the following option files are obsolete. If they have been created by ealier &app; versions
        then the filename is extended automatically by <guilabel>*.deprecated</guilabel> and their settings are imported in
        GSettings under the path <guilabel>org.gnome.gnome-commander</guilabel>.
      </para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>~/.config/gnome-commander/devices</guilabel>
        </term>
        <listitem>
          <para/>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>~/.config/gnome-commander/fav-apps</guilabel>
        </term>
        <listitem>
          <para/>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>~/.config/gnome-commander/gnome-commander.xml</guilabel>
        </term>
        <listitem>
          <para/>
        </listitem>
      </varlistentry>
    </variablelist>
    </note>
    <note>
        <para>
            Since &app; version  1.6.0 the options file <guilabel>~/.gnome2/gnome-commander</guilabel> is obsolete.
            The settings of this file are now stored in GSettings under the path <guilabel>org.gnome.gnome-commander</guilabel>.
        </para>
    </note>
  </sect1>

<xi:include href="releases.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default.
     You can use it to describe known bugs and limitations of the
      program if there are any - please be frank and list all
     problems you know of.
-->
  <sect1 id="gnome-commander-bugs">
    <title>Known Bugs and Limitations</title>
    <para>You can report or view &app; bugs at <ulink type="http" url="https://gitlab.gnome.org/GNOME/gnome-commander/issues">gitlab.gnome.org</ulink>.</para>
    <para>Some words about bugs: Though &app; is relatively free from bugs and is a quite mature program, no programs will ever be totally bug free.
        New bugs can be introduced with new features, or through other programs and libraries it depends on,
        this goes especially for development and testing versions. Quality bug reporting is very important
        and can be a very good help for the developers to make a better program.
        Bug reporting is not an act of dissatisfaction, so you are very welcome to help us find, hunt down and kill the bugs.
        Testing of the new releases and bug reporting is the best way users without programming knowledge can help out in the development of a program,
        and those with programming knowledge are very welcome to suggest fixes and/or send patches to the developers,
        all in the spirit of free and open source software.</para>
    <para>Known limitation:
    <itemizedlist>
    <listitem><para></para></listitem>
    </itemizedlist></para>
  <para><emphasis>Given enough eyeballs, all bugs are shallow.</emphasis></para>

  <para><foreignphrase>Linus law.</foreignphrase></para>
 </sect1>

<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="gnome-commander-about">
    <title>About &app;</title>
    <sect2 id="gnome-commander-history">
      <title>History of &app;</title>
      <para> &app; was primarily written by Marcus Bjurman, who was the one initiating this 
      project in 2001 and developed it up to version 1.1.6 in January 2004.</para>
      <para>Later on, since 2004, &app; was maintained by the new lead developer Piotr Eljasiak, 
      working at the project already since 2002. In this time, Assaf Gordon contributed by 
      implementing the internal file viewer.</para>
      <para>Piotr conducted the development until version 1.2.8.15. In this time Magnus Stålnacke 
      was responsible for the homepage. On the mailing list, amongst others, Michael and Magnus 
      contributed with many great ideas and by helping finding bugs and other inconsistencies. 
      After Magnus resigned from the project, Thomas Jost helped to maintain the homepage at 
      Savannah.org</para>
      <para>Unfortunately, Piotr suddenly passed away in the beginning of 2012 and &app; had no 
      maintainer for nearly two years. Late in 2013, Uwe Scholz, a user of &app; since the 
      days before version 1.0, took over the project as project maintainer.</para>
    </sect2>
    <sect2 id="gnome-commander-location">
      <title>Location</title>
      <para>In the beginning, &app; had its home at Sourceforge. Later, the project moved to
      Savannah.org, where it got its own homepage and its mailing lists. In the end 
      of 2003, the source tree moved to Gnome.org. Though, the homepage and mailing lists were 
      still hosted at Savannah.</para>
      <para>Since 2013, the location of the &app; home page has been moved to GitHub.org.</para>
    </sect2>
    <sect2 id="gnome-commander-bug-reporting">
      <title>Bug Reporting</title>
    <para>
      If you found a bug, you can check if it is already reported on our 
      <ulink type="http" url="https://gitlab.gnome.org/GNOME/gnome-commander/issues">GitLab</ulink>
      page at Gnome.org. If not, please report the bug. If you want to fix it by yourself
      have a look at the section <xref linkend="gnome-commander-development-version"></xref>.</para>
    </sect2>
    <sect2 id="gnome-commander-License">
      <title>License</title>
      <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A copy of this license can be found at this
      <ulink type="http" url="https://www.gnu.org/licenses/gpl-2.0.html">link</ulink>,
      or in the file COPYING included with the source code of this program.</para>
    </sect2>
  </sect1>
</article>
