You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
255 lines
7.2 KiB
255 lines
7.2 KiB
<?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 "tdeutils">
|
|
<!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>2003-09-16</date>
|
|
<releaseinfo>0.</releaseinfo>
|
|
|
|
<abstract><para>&kdiskfree; displays available file devices, along with
|
|
information about them.</para>
|
|
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>KDE</keyword>
|
|
<keyword>kdf</keyword>
|
|
<keyword>tdeutils</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 &kcontrol; Disk-Free 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 <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 &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>
|
|
|
|
<para>In the picture above, four devices are shown: one reiserfs-formatted
|
|
hard drive partition mounted at the filesystem 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 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 moving the slider. The value in the box on the left is
|
|
the interval (in seconds) between updates of the &kdiskfree; display to
|
|
reflect the current status.</para> <para>The File Manager setting
|
|
controls the command executed when the <guimenuitem>Open
|
|
Filemanager</guimenuitem> pop-up 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>
|
|
|
|
&underFDL;
|
|
&underGPL;
|
|
|
|
</chapter>
|
|
|
|
&documentation.index;
|
|
</book>
|