Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeutils@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

4 files changed, 270 insertions, 0 deletions

diff --git a/doc/kdf/Makefile.am b/doc/kdf/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kdf/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kdf/index.docbook b/doc/kdf/index.docbook
new file mode 100644
index 0000000..672ef81
--- /dev/null
+++ b/doc/kdf/index.docbook
@@ -0,0 +1,266 @@
+<?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>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>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 &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 &copy; 1998-2000 &Michael.Kropfberger; &Michael.Kropfberger.mail;</para>
+
+<para>Documentation Copyright &copy; 2000 &Jonathan.Singer; &Jonathan.Singer.mail;</para>
+
+&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
+-->
diff --git a/doc/kdf/kdf.png b/doc/kdf/kdf.png
new file mode 100644
index 0000000..737ec7c
--- /dev/null
+++ b/doc/kdf/kdf.png
diff --git a/doc/kdf/kdf_config.png b/doc/kdf/kdf_config.png
new file mode 100644
index 0000000..09c9c91
--- /dev/null
+++ b/doc/kdf/kdf_config.png