<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&kdf;"> <!ENTITY package "kdeutils"> <!ENTITY % English "INCLUDE" > <!-- change language only here --> <!ENTITY % addindex "IGNORE"> ]> <book lang="&language;"> <bookinfo> <title>The &kdf; Handbook</title> <authorgroup> <author> <firstname>Jonathan</firstname> <surname>Singer</surname> <affiliation> <address><email>jsinger@leeta.net</email></address> </affiliation> </author> <author> <firstname>Michael</firstname> <surname>Kropfberger</surname> <affiliation><address><email>michael.kropfberger@gmx.net</email></address></affiliation> </author> <othercredit role="reviewer"> <firstname>Lauri</firstname> <surname>Watts</surname> <contrib>Reviewer</contrib> </othercredit> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <copyright> <year>2000</year> <holder>Jonathan Singer</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2001-07-06</date> <releaseinfo>0.00.50</releaseinfo> <abstract><para>&kdf; displays available file devices, along with information about them.</para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>kdf</keyword> <keyword>kdeutils</keyword> <keyword>disks</keyword> <keyword>devices</keyword> <keyword>mount</keyword> <keyword>unmount</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para>&kdf; displays the available file devices (hard drive partitions, floppy and &CD; drives, &etc;) along with information on their capacity, free space, type and mount point. It also allows you to mount and unmount drives and view them in a file manager.</para> <para>&kdf; is similar to the &kcontrol; DiskFree module <!-- (<application>kcmdf</application>) -->, but takes up less screen space. It is useful if you want to keep a &kdf; window available at all times.</para> </chapter> <chapter id="using-kdf"> <title>Using &kdf;</title> <sect1 id="starting-kdf"> <title>Starting &kdf;</title> <para>Type <userinput><command>kdf</command></userinput> at a command prompt or select <guimenuitem>Disk Free</guimenuitem> from the <guisubmenu>System</guisubmenu> group in the <guimenu>K</guimenu> menu. The standard &Qt; and &kde; command options are available, and can be listed by entering <userinput><command>kdf</command> <option>--help</option></userinput> at the command prompt.</para> </sect1> <sect1 id="main-window"> <title>The Main window</title> <para>The main &kdf; window displays the available file devices.</para> <para>Normally, the following pieces of information are included:</para> <screenshot> <screeninfo>&kdf; Screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kdf.png" format="PNG"/> </imageobject> <textobject> <phrase>&kdf; Screen</phrase> </textobject> </mediaobject> </screenshot> <itemizedlist> <listitem><para>an icon depicting the type of storage</para></listitem> <listitem><para>device name</para></listitem> <listitem><para>filesystem type</para></listitem> <listitem><para>total size</para></listitem> <listitem><para>mount point</para></listitem> <listitem><para>free disk space</para></listitem> <listitem><para>the percentage of space used as a number and as a graph.</para></listitem> </itemizedlist> <para>In the picture above, four devices are shown: two ext2-formatted hard drive partitions, one mounted at the filesystem root (<filename class="directory">/</filename>) and one at <filename class="directory">/old</filename>, a mounted iso9660 &CD-ROM; and an unmounted floppy drive.</para> <para><mousebutton>Left</mousebutton> clicking on the header of a particular column sorts the devices according to that variable. A second <mousebutton>left</mousebutton> click sorts in the opposite order.</para> <para>Clicking on a row pops up a menu. If that device is not currently mounted, the <guimenuitem>Mount Device</guimenuitem> option is available. If the device is mounted, it can be unmounted by choosing <guimenuitem>Unmount Device</guimenuitem>. Selecting <guimenuitem>Open Filemanager</guimenuitem> opens a new window with a graphical view of the files on that device.</para> </sect1> <sect1 id="the-menus"> <title>The &kdf; menubar</title> <sect2> <title>The <guimenu>File</guimenu> Menu</title> <variablelist> <varlistentry> <term> <menuchoice> <guimenu>File</guimenu> <guimenuitem>Update</guimenuitem> </menuchoice></term> <listitem><para><action>Immediately updates the display to reflect the current status</action></para></listitem> </varlistentry> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem><para><action>Closes</action> &kdf;</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Options</guimenu> menu and dialog</title> <variablelist> <varlistentry> <term> <menuchoice> <guimenu>Options</guimenu> <guimenuitem>Configure KDiskFree</guimenuitem> </menuchoice> </term> <listitem><para><action>Opens a configuration dialog.</action></para> <screenshot> <screeninfo>Configure &kdf; Screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kdf_config.png" format="PNG"/> </imageobject> <textobject> <phrase>Configure &kdf; Screen</phrase> </textobject> </mediaobject> </screenshot> <para>This dialog has two tabbed windows, <guilabel>General Settings</guilabel> and <guilabel>Mount Commands</guilabel></para> <variablelist> <varlistentry> <term>General Settings</term> <listitem><para>Click on the word <guilabel>visible</guilabel> or <guilabel>hidden</guilabel> to turn display of an data field on or off.</para> <para>Change the update frequency by moving the slider. The value in the box on the left is the interval (in seconds) between updates of the &kdf; display to reflect the current status.</para> <para>The FileManager setting controls the command executed when the <guimenuitem>Open Filemanager</guimenuitem> pop-up menu item is selected.</para> <para>There are also two checkboxes. One controls if a filemanager window will be automatically opened when a device is mounted. The other causes an alert window to pop up if a disk gets critically full.</para> </listitem> </varlistentry> <varlistentry> <term><guilabel>Mount Commands</guilabel></term> <listitem><para>Allows the user to specify the mount and unmount commands for a given device, as well as the icon used to represent it. More information on these commands can be found on the man page for <application>mount</application> (type <userinput><command>man</command> <option>mount</option></userinput> at the command prompt).</para></listitem> </varlistentry> </variablelist> </listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Help</guimenu> menu</title> &help.menu.documentation; </sect2> </sect1> </chapter> <chapter id="credits"> <title>Credits and License</title> <para>&kdf;</para> <para>Program copyright 1998-2000 Michael Kropfberger <email>mkropfbe@edu.uni-klu.ac.at</email></para> <para>Documentation copyright 2000 Jonathan Singer <email>jsinger@leeta.net</email></para> &underFDL; &underGPL; </chapter> <appendix id="installation"> <title>Installation</title> <sect1 id="getting-and-installing-kdf"> <title>How to obtain and install &kdf;</title> &install.intro.documentation; &install.compile.documentation; </sect1> </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: // vim:ts=2:sw=2:tw=78:noet -->