
<sect1 id="diskusage-applet">
  <title>Disk Usage Applet</title> 

  <para> <application>Disk Usage Applet</application>, shown in <xref
  linkend="diskusage-applet-fig1">, provides a panel monitor for the
  amount of space in use and available on your disk drives. To add
  this applet to the panel, right-click on the panel and choose
         <menuchoice>
	<guimenu>Panel</guimenu>
	<guisubmenu>Add to panel</guisubmenu>
	<guisubmenu>Applet</guisubmenu>
	<guisubmenu>Monitors</guisubmenu>
	<guimenuitem>Disk Usage</guimenuitem>
      </menuchoice>
  </para>
  
 
    <figure id="diskusage-applet-fig1">
     <title>Disk Usage Applet</title>
     <screenshot>
      <screeninfo>Disk Usages Applet</screeninfo>
      <graphic format="png" fileref="figures/diskusage-applet" srccredit="John
	       Fleck">
      </graphic>
    </screenshot>
   </figure>

   <!-- ============= Usage  ================================ -->

  <sect2 id="diskusage-applet-usage">
    <title> Usage</title>
    <para><application>Disk Usage Applet</application> provides
    real-time monitoring of the available space on your disk
    drives.</para>
    <para>It provides three pieces of information. The colored pie
    graphically represents how much space is used and how much is
    available. <guilabel>MP:</guilabel> indicates the mount point of
    the disk it is currently monitoring. <guilabel>av:</guilabel>
    indicates the amount of space available on the selected drive, in
    kilobytes. Clicking on the applet changes the drive being
    monitored. Doing so repeatedly cycles through all available drives.</para>
  
  <para>
    Right-clicking on the applet brings up a menu containing the
    following items:
    <itemizedlist>
        <listitem>
	  <para>
	    <guimenuitem>File system</guimenuitem> &mdash; allows you
	    to change the file system <application>Disk Usage
	    Applet</application> monitors.</para>
	</listitem>
	<listitem>
	  <para>
	    <guimenuitem>Properties</guimenuitem>&mdash; opens the
	    <link linkend="diskusage-applet-prefs">
                <guilabel>Properties</guilabel>
            </link> dialog
	    </para>
	</listitem>

        <listitem>
	  <para>
	    <guimenuitem>Update</guimenuitem> &mdash; this can be used
	    to force the applet to update the filesystem list the applet
	    uses.
          </para>
	</listitem>
	
	 <listitem>
      <para>
       <guimenuitem>Help</guimenuitem> &mdash;
       displays this document.
      </para>
     </listitem>

     <listitem>
      <para>
       <guimenuitem>About&hellip;</guimenuitem> &mdash;
       shows basic information about <application>Disk Usage
       Applet</application>, including the applet's version and the
       author's name.
      </para>
     </listitem>
	
	

      </itemizedlist>
    </para>
  </sect2>
 <!-- ============= Customization ============================= -->
  <sect2 id="diskusage-applet-prefs">
    <title>Customization</title>
    <para>
      You can customize <application>Disk Usage Applet</application> by
      right-clicking on it and choosing
      <guimenuitem>Properties</guimenuitem>. This will launch the
      <interface>Properties&hellip;</interface> dialog, which allows you to
      change various settings.
    </para>
    <figure id="diskusage-applet-fig2">
     <title>Preferences dialog</title>
     <screenshot>
      <screeninfo>Preferences dialog</screeninfo>
      <graphic format="png" fileref="figures/diskusage-applet-prefs"
	       srccredit="John Fleck">
      </graphic>
    </screenshot>
   </figure>
     <para>
     The properties are:
     <itemizedlist>

      
      <listitem>
       <para>
        <guilabel>Colors</guilabel> &mdash;  To change the colors
      displayed in the applet, click on the <guibutton>colored
      buttons</guibutton> next to <guilabel>Used Diskspace</guilabel>,
      <guilabel>Free Diskspace</guilabel>,
      <guilabel>Textcolor</guilabel> and
      <guilabel>Backgroundcolor</guilabel>. A color wheel dialog will
      pop up offering you color options to make changes. When
      finished, click on the <guibutton>OK</guibutton> button on the
      color options window.

       </para>
      </listitem>

      <listitem>
       <para>
        <guilabel>Size</guilabel> &mdash; <guilabel>Applet
    Size</guilabel> and can be used to change the height (on a
    horizontal panel) or width (on a vertical panel) of the applet.</para>

    <para>By checking the <guilabel>Automatically pick best applet
    size</guilabel> check box, you can force <application>Disk Usage
    Applet</application> to automatically choose the appropriate size
    for your panel.
       </para>
      </listitem>

 <listitem>
       <para>
        <guilabel>Fonts</guilabel> &mdash; Clicking on the bar in this
        window opens a dialog box allowing you to change the font
        displayed in the applet.
       </para>
      </listitem>
 <listitem>
       <para>
        <guilabel>Update Frequency</guilabel> &mdash; changes
    the amount of time, in seconds, between updates of
    <application>Disk Usage Applet</application>.
       </para>
      </listitem>

     </itemizedlist>
    </para>


    <para> 
     </para>

   
   
    <para> After you have made all the choices you want, click on
      <guibutton>OK</guibutton> to make the changes and close the
      <interface>Properties</interface> dialog. To cancel the changes
      and return to previous values, click on
      <guibutton>Cancel</guibutton> button.
    </para>
  </sect2>
  
  <!-- ============= Authors ================================ -->

  <sect2 id="authors">
   <title>Authors</title>
   <para>
    <application>Disk Usage Applet</application> was written by Dave Finton
    <email>dfinton@d.umn.edu</email>, Bruno Widmann
    <email>bwidmann@tks.fh-sbg.ac.at</email> and Martin Baulig
    <email>martin@home-of-linux.org</email>. Please send all comments,
    suggestions, and bug reports to the <ulink
    url="http://bugs.gnome.org" type="http">GNOME bug tracking
    database</ulink>. (Instructions for submitting bug reports can be
    found <ulink url="http://bugs.gnome.org/Reporting.html" type="http">
    on-line</ulink>. If you are using
    GNOME 1.1 or later, you can also use <application>Bug Report
    Tool</application> (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
   </para>

   <para>
    This manual was written by John Fleck
    (<email>jfleck@inkstain.net</email>). Please send all comments and
    suggestions regarding this manual to the <ulink type="http"
    url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink> 
    by sending an email to <email>docs@gnome.org</email>. You can also
    submit comments online by using the <ulink type="http"
    url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
    Table</ulink>.
   </para>

   <!-- For translations: uncomment this:

   <para>
    Latin translation was done by ME
    (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
    suggestions regarding this translation to SOMEWHERE.
   </para>

   -->

  </sect2>


  <!-- ============= Application License ============================= -->

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

</sect1>




