<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&kdiskfree;"> <!ENTITY package "kdeutils"> <!ENTITY % English "INCLUDE" > <!-- change language only here --> <!ENTITY % addindex "IGNORE"> ]> <book lang="&language;"> <bookinfo> <title>The &kdiskfree; Handbook</title> <authorgroup> <author> &Jonathan.Singer; &Jonathan.Singer.mail; </author> <author> &Michael.Kropfberger; &Michael.Kropfberger.mail; </author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <copyright> <year>2000-2002</year> <holder>&Jonathan.Singer;</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2010-01-12</date> <releaseinfo>v0.11 (&kde; 4.4)</releaseinfo> <abstract><para>&kdiskfree; 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>&kdiskfree; 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>&kdiskfree; is similar to the &kinfocenter; Partitions module<!-- (<application>kcmdf</application>) -->, but takes up less screen space. It is useful if you want to keep a &kdiskfree; window available at all times.</para> </chapter> <chapter id="using-kdf"> <title>Using &kdiskfree;</title> <sect1 id="starting-kdf"> <title>Starting &kdiskfree;</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 application launcher. 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 &kdiskfree; window displays the available file devices.</para> <para>Normally, the following pieces of information are included:</para> <screenshot> <screeninfo>&kdiskfree; Screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kdf.png" format="PNG"/> </imageobject> <textobject> <phrase>&kdiskfree; 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> <!--! new screenshot <para>In the picture above, four devices are shown: one reiserfs-formatted hard drive partition mounted at the file system root (<filename class="directory">/</filename>), two &CD-ROM;'s, and a 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 with the &RMB; 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 in File Manager</guimenuitem> opens a new window with a graphical view of the files on that device.</para> </sect1> <sect1 id="the-menus"> <title>The &kdiskfree; menu bar</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> &kdiskfree;</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Settings</guimenu> menu and dialog</title> <variablelist> <varlistentry> <term> <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice> </term> <listitem> <para>The standard &kde; dialog for setting shortcuts.</para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure KDiskFree...</guimenuitem> </menuchoice> </term> <listitem><para><action>Opens a configuration dialog.</action></para> <screenshot> <screeninfo>Configure &kdiskfree; Screen</screeninfo> <mediaobject> <imageobject> <imagedata fileref="kdf_config.png" format="PNG"/> </imageobject> <textobject> <phrase>Configure &kdiskfree; 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 editing the value. The value in the box is the interval (in seconds) between updates of the &kdiskfree; display to reflect the current status.</para> <para>The <guilabel>File Manager</guilabel> setting controls the command executed when the <guimenuitem>Open Filemanager</guimenuitem> popup menu item is selected.</para> <para>There are also two check boxes. One controls if a file manager 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>&kdiskfree;</para> <para>Program Copyright © 1998-2000 &Michael.Kropfberger; &Michael.Kropfberger.mail;</para> <para>Documentation Copyright © 2000 &Jonathan.Singer; &Jonathan.Singer.mail;</para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underFDL; &underGPL; </chapter> &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 -->