<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.5.4">
  <!ENTITY manrevision "2.1">
  <!ENTITY date "February 2004">
  <!ENTITY app "<application>Disk Mounter</application>">
  <!ENTITY appname "Disk Mounter">
]>
<!-- 
      (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 Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&appname; Manual V&manrevision;</title>       
    <copyright>
      <year>2004</year>
      <holder>Sun Microsystems</holder>
    </copyright>
    <copyright> 
      <year>2002</year> 
      <holder>John Fleck</holder> 
    </copyright> 
    <copyright> 
      <year>2000</year> 
      <holder>Dan Mueth</holder> 
    </copyright>
<!-- translators: uncomment this:

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

   -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;
   <!-- 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. -->

    <authorgroup> 
      <author>
        <firstname>Sun</firstname>
        <surname>GNOME Documentation Team</surname>
        <affiliation><orgname>Sun Microsystems</orgname></affiliation>
      </author>
      <author> 
	<firstname>John </firstname> 
	<surname> Fleck</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>jfleck@inkstain.net</email> </address> 
	</affiliation> 
      </author> 
      <author> 
	<firstname>Dan </firstname> 
	<surname> Mueth</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>muet@alumni.uchicago.edu</email> </address> 
	</affiliation> 
      </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>


    <revhistory>
      <revision> 
	<revnumber>&appname; Applet Manual V&manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
          <para role="author">Sun GNOME Documentation Team</para>
          <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
      <revision> 
	<revnumber>Disk Mounter Applet Manual V2.0</revnumber> 
	<date>March 2002</date> 
	<revdescription> 
	  <para role="author">John Fleck
	    <email>jfleck@inkstain.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
      <revision> 
	<revnumber>Drive Mount Applet Manual</revnumber> 
	<date>April 2000</date> 
	<revdescription> 
	  <para role="author">Dan Mueth 
	    <email>muet@alumni.uchicago.edu</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &appname;.
    </releaseinfo>
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; applet or
	this manual, follow the directions in the 
	<ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>Disk Mounter Applet</primary> 
  </indexterm> 
  

  <!-- ============= Introduction  ================================ -->
  <sect1 id="drivemountapplet-intro">
    <title>Introduction</title>

    <figure id="drivemountapplet-fig"> 
      <title>&appname; Applet</title> 
      <screenshot> 
        <mediaobject> 
          <imageobject><imagedata
            fileref="figures/drivemount-applet_window.png" format="PNG"/> 
          </imageobject>
          <textobject> 
            <phrase>The &appname; applet.</phrase> 
          </textobject> 
        </mediaobject> 
      </screenshot> 
    </figure>

    <para>
      The &app; applet enables you to quickly mount and unmount various types of drives and file systems. 
    </para>
    <para>
      For the &app; applet to work properly, your system administrator must configure your system appropriately. For more information about the necessary system administration tasks, see <ulink url="man:fstab" type="man"><citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry></ulink>.
    </para>

    <sect2 id="drivemount-intro-add">
      <title>To Add &appname; to a Panel</title>
      <para>
        To add &app; to a panel, right-click on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Utility</guisubmenu><guimenuitem>&appname;</guimenuitem></menuchoice>. 
      </para>
    </sect2>

    <sect2 id="drivemount-intro-mount">
      <title>Manually Mounting and Unmounting File Systems</title>
      <para>
        Many file systems on Linux and UNIX systems must be manually mounted and unmounted. 
      </para>
      <para>
        When a file system is mounted, you can read and write to the file system. When you finish working with a file system, you should unmount the file system. 
      </para>
      <para>
        You must unmount removable drives, such as floppy disks and Zip disks, before you remove the media, because Linux and UNIX systems do not always write the changes immediately. Such systems typically buffer the changes to the disk, to improve the speed of the system. 
      </para>
      <para>
        Partitions on fixed drives, such as your hard drive, are typically mounted automatically when your computer boots, and unmounted when your computer shuts down. Removable media must be mounted and unmounted manually, for example by using the &app; applet.  
      </para>
    </sect2>

    <sect2 id="drivemount-intro-mountpoint">
      <title>Mount Points</title>
      <para>
        The root file system is the main file system on your computer. The root file system starts with the following character: <literal>/</literal> 
      </para>
      <para>
        Other file systems are associated with empty directories inside the root file system. These directories are called mount points. When a file system is mounted, the contents of the file system are accessible from the associated mount point. 
      </para>
      <para>
        For example, most systems create a mount point called <literal>/mnt/floppy</literal>:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            If your floppy drive is not mounted, <literal>/mnt/floppy</literal> is an empty directory.
          </para>
        </listitem>
        <listitem>
          <para>
            If your floppy drive is mounted, <literal>/mnt/floppy</literal> provides access to the contents of your floppy disk.
          </para>
        </listitem>
      </itemizedlist>
    </sect2>

  </sect1>

  <!-- ============= Usage  ================================ -->
  <sect1 id="drivemount-usage">
    <title>Usage</title>

    <sect2 id="drivemount-usage-tooltip">
    <title>To Display the Mount Point and Mount Status of a Drive</title>
      <para>
        To display the mount point and mount status of a drive, move the mouse pointer to the drive icon in the panel. A tooltip displays the mount point and mount status of the drive.
      </para>
    </sect2>

    <sect2 id="drivemount-usage-mount">
    <title>To Mount or Unmount a Drive</title>
      <para>
        To mount or unmount a drive, click on the drive icon in the panel.
      </para>
    </sect2>

    <sect2 id="drivemount-usage-browse">
    <title>To Browse the Contents of a Drive</title>
      <para>
        To use a file manager to browse the contents of a drive, right-click on the drive icon in the panel, then choose <guimenuitem>Browse</guimenuitem>.
      </para>
      <para>
        You can only browse the contents of a mounted drive.
      </para>
    </sect2>

    <sect2 id="drivemount-usage-eject">
    <title>To Eject a Disk From a Drive</title>
      <para>
        To eject a disk from a drive, right-click on the drive icon in the panel, then choose <guimenuitem>Eject</guimenuitem>.
      </para>
    </sect2>

  </sect1>

  <!-- ============= Customization ============================= -->
  <sect1 id="drivemountapplet-prefs">
    <title>Preferences</title>
    <para>
      To configure the &app; applet, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. The <guilabel>Disk Mounter Preferences</guilabel> dialog is displayed.
    </para>
    <variablelist>
      <varlistentry>
        <term><guilabel>Mount directory</guilabel></term>
        <listitem>
          <para>
            Enter the name of the mount point for this drive. Alternatively, use the <guibutton>Browse</guibutton> button to select the mount point.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Update interval ... seconds</guilabel></term>
        <listitem>
          <para>
            Use this spin box to specify the interval at which you want &app; to check the status of the drive and update the icon if necessary.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Icon</guilabel></term>
        <listitem>
          <para>
            Select a drive type from the drop-down list. &app; automatically provides icons for each defined drive type, to indicate whether the drive is mounted or unmounted.
          </para>
          <para>
            Alternatively, select <guilabel>Custom</guilabel> from the drop-down list. Click on the <guilabel>Mounted icon</guilabel> and <guilabel>Unmounted icon</guilabel> buttons to choose icons that indicate whether the drive is mounted or unmounted.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Eject disk when unmounting</guilabel></term>
        <listitem>
          <para>
            Select this option to eject the disk when you unmount the drive.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Use automount friendly status test</guilabel></term>
        <listitem>
          <para>
            Select this option only if you use the automount facility.
          </para>
          <para>
            If you do not use the automount facility, you do not need to select the <guilabel>Use automount friendly status test</guilabel> option. When you position the mouse pointer over a drive icon in the panel, &app; runs the <command>stat</command> command, which tests the mount status.
          </para>
          <para>
            However, if you use the automount facility, &app; behaves differently, as follows:
          </para>
          <itemizedlist>
            <listitem>
              <para>
                If you use the automount facility and you do not select the <guilabel>Use automount friendly status test</guilabel> option, &app; runs the <command>stat</command> command, which mounts the drive instead of testing the mount status. 
              </para>
            </listitem>
            <listitem>
              <para>
                If you use the automount facility and you select the <guilabel>Use automount friendly status test</guilabel> option, &app; runs the <command>mount</command> command, which tests the mount status.
              </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
    </variablelist>

 </sect1>
</article>
