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/kdeadmin@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

48 files changed, 5677 insertions, 0 deletions

diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..6812bd2
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,5 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+SUBDIRS = $(AUTODIRS)
+
diff --git a/doc/kcron/Makefile.am b/doc/kcron/Makefile.am
new file mode 100644
index 0000000..1a8064c
--- /dev/null
+++ b/doc/kcron/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = AUTO   
diff --git a/doc/kcron/index.docbook b/doc/kcron/index.docbook
new file mode 100644
index 0000000..5ff2e14
--- /dev/null
+++ b/doc/kcron/index.docbook
@@ -0,0 +1,900 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
+"dtd/kdex.dtd" [
+  <!ENTITY kappname "&kcron;">
+  <!ENTITY package "kdeadmin">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+  <!ENTITY % addindex "IGNORE">
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+
+<title>The &kcron; Handbook</title>
+
+<authorgroup>
+
+<author>
+<firstname>Morgan</firstname>
+<othername>N.</othername>
+<surname>Sandquist</surname>
+<affiliation><address><email>morgan@pipeline.com</email></address>
+</affiliation>
+</author>
+
+<othercredit role="developer">
+<firstname>Gary</firstname>
+<surname>Meyer</surname>
+<affiliation><address><email>gary@meyer.net</email></address>
+</affiliation>
+<contrib>Developer</contrib>
+</othercredit>
+
+<othercredit role="reviewer">
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+<affiliation><address><email>lauri@kde.org</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<copyright>
+<year>2000</year>
+<holder>Morgan N. Sandquist</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2003-09-16</date>
+<releaseinfo>3.1.91</releaseinfo>
+
+<abstract><para>&kcron; is an application that schedules programs to be
+run.</para></abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdeadmin</keyword>
+<keyword>KCron</keyword>
+<keyword>cron</keyword>
+<keyword>crontab</keyword>
+<keyword>scheduler</keyword>
+</keywordset>
+
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>&kcron; is an application for scheduling programs to run in the
+background. It is a graphical user interface to <command>cron</command>,
+the &UNIX; system scheduler.</para>
+
+</chapter>
+
+<chapter id="using-kcron">
+<title>Using &kcron;</title>
+
+<important><para>Don't forget to tell your system to start the
+<filename>crond</filename> cron daemon first, or &kcron; won't
+work.</para></important>
+
+<sect1 id="kcron-start-up">
+<title>&kcron; Start Up</title>
+
+<para>When &kcron; starts you will see a summarized view of existing
+scheduled tasks and associated environment variables. If you are running
+as the root user, you will see these items for all users on the computer
+as well as the system scheduled tasks. Each of the folders can be
+expanded and contracted.</para>
+
+<screenshot>
+<screeninfo>&kcron; at start up.</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="kcronstart.png" format="PNG"/></imageobject>
+<textobject><phrase>&kcron; at start up.</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<sect2>
+<title>Scheduled Tasks</title>
+
+<para>Scheduled tasks appear under a <guilabel>Tasks</guilabel>
+folder. For each scheduled task, the following are displayed:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Name</guilabel></term>
+<listitem><para>Name to identify the scheduled task.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Value</guilabel></term>
+<listitem><para>Program file and parameters.</para></listitem>
+</varlistentry>
+<varlistentry> 
+<term><guilabel>Description</guilabel></term>
+<listitem><para>Natural language description of scheduled
+task.</para></listitem>
+</varlistentry> 
+</variablelist>
+
+<para>If a task has been disabled, no program file and parameters will
+appear, and the description will be disabled.</para>
+
+</sect2>
+
+<sect2>
+<title>Environment Variables</title>
+
+<para>Environment variables appear under a
+<guilabel>Variables</guilabel> folder. For each environment variable,
+the following are displayed: </para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Name</guilabel></term>
+<listitem><para>Variable name.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Value</guilabel></term>
+<listitem><para>Variable value.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Description</guilabel></term>
+<listitem><para>Natural language description of variable.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>Environment variables appearing here will override any existing
+environment variable for all scheduled tasks. If an environment variable
+has been disabled, no value will appear and the description will be
+disabled.</para>
+
+<screenshot>
+<screeninfo>&kcron; main window</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="kcron.png" format="PNG"/></imageobject>
+<textobject><phrase>&kcron; main window</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+</sect2>
+</sect1>
+
+<sect1 id="new-task">
+<title>Adding Scheduled Tasks</title>
+
+<para>To create a new scheduled task, first select the
+<guilabel>Tasks</guilabel> folder. Then select
+<menuchoice><guimenu>Edit</guimenu> <guimenuitem>New...</guimenuitem>
+</menuchoice>. Alternatively, you can use the
+<mousebutton>right</mousebutton> mouse button menu and choose
+<menuchoice><guimenuitem>New...</guimenuitem></menuchoice>, or simply
+press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>.</para>
+
+<sect2>
+<title>The <guilabel>Edit Task</guilabel> Dialog</title>
+
+<screenshot>
+<screeninfo><guilabel>Edit Task</guilabel> dialog.</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="newtask.png" format="PNG"/></imageobject>
+<textobject><phrase><guilabel>Edit Task</guilabel> dialog</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Comment</guilabel></term>
+<listitem><para>Enter a description of the task to schedule.</para>
+</listitem> 
+</varlistentry>
+<varlistentry>
+<term><guilabel>Program</guilabel></term>
+<listitem><para>Enter the name of the program. You can specify either a
+relative path or absolute path. If you want to look up the program, click
+<guibutton>Browse...</guibutton>.</para>
+</listitem> 
+</varlistentry>
+<varlistentry>
+<term><guibutton>Enabled</guibutton></term>
+<listitem><para>To enable or disable the task, select or de-select
+<guilabel>Enabled</guilabel>.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Silent</guilabel></term>
+<listitem>
+<para>
+Turns off logging of the command and the output from the command.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Months</guilabel></term>
+<listitem><para>Select the months during which the task is to be
+scheduled.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Days of the Month</guilabel></term>
+<listitem><para>Select the days of the month on which the task is to be
+scheduled.</para>
+</listitem> 
+</varlistentry>
+<varlistentry>
+<term><guilabel>Days of the Week</guilabel></term>
+<listitem><para>Select the days of the week on which the task is to be
+scheduled.</para>
+</listitem> 
+</varlistentry>
+<varlistentry>
+<term><guilabel>Daily</guilabel></term>
+<listitem><para>If you want to schedule the task to run daily, select
+<guibutton>Run every day</guibutton>.</para>
+</listitem> 
+</varlistentry>
+<varlistentry>
+<term><guilabel>Hours</guilabel></term>
+<listitem><para>Select the hours on which the task is to be
+scheduled.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Minutes</guilabel></term>
+<listitem><para>Select the minute at which the task is to be scheduled. &kcron;
+does not support scheduling tasks at smaller than five minute intervals.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>OK</guibutton></term>
+<listitem><para>Completes the creation of this task.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Cancel</guibutton></term>
+<listitem><para>Cancels the creation of this task.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>If you select both days of the month, and days of the week, the
+task will run when either condition is met. For instance, if you select
+the 1st and 15th, and select Sunday, the program will be run every 1st
+and 15th of the selected months (regardless of day of week) as well as
+every Sunday of the selected months (regardless of day of the
+month).</para>
+
+<para>The scheduled task is not actually set up until the
+<filename>crontab</filename> has been saved.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="manage-tasks">
+<title>Managing Scheduled Tasks</title>
+
+<para>As with creating new tasks, changes to tasks will not actually be
+made until the <filename>crontab</filename> is saved.</para>
+
+<sect2>
+<title>Cutting Scheduled Tasks</title>
+
+<para>To cut a scheduled task, first select the task to be cut. Then
+select <menuchoice><guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem></menuchoice>.</para> <para>Alternatively,
+you can use the <mousebutton>right</mousebutton> mouse button menu and
+choose <menuchoice><guimenuitem>Cut</guimenuitem></menuchoice>, or
+simply press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>.</para>
+
+</sect2>
+
+<sect2>
+<title>Copying Scheduled Tasks</title>
+
+<para>To copy a scheduled task, first select the task to be copied. Then
+select
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>
+.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton> mouse
+button menu and choose <menuchoice><guimenuitem>Copy</guimenuitem></menuchoice>,
+or simply press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>.</para>
+
+</sect2>
+
+<sect2>
+<title>Pasting Scheduled Tasks</title>
+
+<para>To paste a scheduled task, first a scheduled task must have
+already been cut or copied to the clipboard. Once a scheduled task has
+been cut or copied, paste will be enabled. Then select the
+<guilabel>Tasks</guilabel> folder. Finally, select <menuchoice>
+<guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem>
+</menuchoice>.</para>
+
+<para> Alternatively, you can use the <mousebutton>right</mousebutton> mouse
+button menu and choose
+<menuchoice><guimenuitem>Paste</guimenuitem></menuchoice>, or simply press
+<keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>.</para>
+
+</sect2>
+
+<sect2>
+<title>Modifying Scheduled Tasks</title>
+
+<para>To modify a scheduled task, first select the task to be
+modified. Then select
+<menuchoice>
+<guimenu>Edit</guimenu> <guimenuitem>Modify...</guimenuitem>
+</menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>Modify...</guimenuitem></menuchoice>, or simply
+press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.  You
+will see the <guilabel>Edit Task</guilabel> dialog, with which you would
+modify the task as described <link linkend="new-task">above</link>.</para>
+
+</sect2>
+
+<sect2>
+<title>Deleting Scheduled Tasks</title>
+
+<para>To delete a scheduled task, first select the task to be
+deleted. Then select <menuchoice> <guimenu>Edit</guimenu>
+<guimenuitem>Delete</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose <guimenuitem>Delete</guimenuitem>.</para>
+
+</sect2>
+
+<sect2>
+<title>Enabling/Disabling Scheduled Tasks</title>
+
+<para>To enable or disable a scheduled task, first select the disabled
+task. Disabled tasks will have <guilabel>Disabled</guilabel> in their
+descriptions. Then select <menuchoice> <guimenu>Edit</guimenu>
+<guimenuitem>Enabled</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>Enabled</guimenuitem></menuchoice>.  Confirm
+that the scheduled task's program name, parameters, and description are
+correctly displayed.</para>
+
+</sect2>
+
+<sect2>
+<title>Running Scheduled Tasks</title>
+
+<para>To run a scheduled task immediately, first select the task.  Then
+select <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Run
+Now</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose <menuchoice><guimenuitem>Run
+Now</guimenuitem></menuchoice>.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="new-variable">
+<title>Adding Environment Variables</title>
+
+<para>To create a new environment variable, first select the
+<guilabel>Variables</guilabel> folder. Then select <menuchoice>
+<guimenu>Edit</guimenu><guimenuitem>New...</guimenuitem>
+</menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>New...</guimenuitem></menuchoice>, or simply
+press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>.</para>
+
+<sect2>
+<title>The <guilabel>Edit Variable</guilabel> dialog</title>
+
+<screenshot>
+<screeninfo><guilabel>Edit Variable</guilabel> dialog.</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="newvariable.png" format="PNG"/></imageobject>
+<textobject><phrase><guilabel>Edit Variable</guilabel>
+dialog.</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Variable</guilabel></term> 
+<listitem><para>Enter the environment variable name. You can use the drop-down
+list box to select from the most common environment variables used by scheduled
+tasks. Those include:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>HOME</guimenuitem></term>
+<listitem><para>To be used instead of the default user's home
+folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>MAILTO</guimenuitem></term>
+<listitem><para>To send email output to an email address other than the user's
+default email address.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>PATH</guimenuitem></term>
+<listitem><para>To be used to search folders for program
+files.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>SHELL</guimenuitem></term>
+<listitem><para>To be used instead of the user's default
+value.</para></listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Value</guilabel></term>
+<listitem><para>Enter the environment variable value.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Comment</guilabel></term>
+<listitem><para>Enter a description for the environment variable, such as its
+purpose.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Enabled</guilabel></term>
+<listitem>
+<para>To enable or disable the variable, select or de-select
+<guibutton>Enabled</guibutton>.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>OK</guibutton></term>
+<listitem>
+<para>Completes the setting of this variable.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Cancel</guibutton></term>
+<listitem>
+<para>Cancels the setting of this variable.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>The environment variable is not actually set up until the
+<filename>crontab</filename> has been saved.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="manage-variables">
+<title>Managing Environment Variables</title>
+
+<note><para>As with creating new variables, changes to variables will
+not actually be made until the <filename>crontab</filename> is
+saved.</para></note>
+
+<sect2>
+<title>Cutting Environment Variables</title>
+
+<para>To cut an environment variable, first select the variable to be
+cut. Then select <menuchoice><guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>Cut</guimenuitem></menuchoice>, or simply press
+<keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>.</para>
+
+</sect2>
+
+<sect2>
+<title>Copying Environment Variables</title>
+
+<para>To copy an environment variable, first select the variable to be
+copied. Then select <menuchoice> <guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose <guimenuitem>Copy</guimenuitem>, or simply
+press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>.</para>
+
+</sect2>
+
+<sect2>
+<title>Pasting Environment Variables</title>
+
+<para>To paste an environment variable, first an environment variable
+must have already been cut or copied to the clipboard. Once an
+environment variable has been cut or copied, paste will be enabled. Then
+select the <guilabel>Variables</guilabel> folder. Finally, select
+<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem>
+</menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>Paste</guimenuitem></menuchoice>, or simply
+press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>.</para>
+</sect2>
+
+<sect2>
+<title>Modifying Environment Variables</title>
+
+<para>To modify an environment variable, first select the variable to be
+modified. Then select <menuchoice> <guimenu>Edit</guimenu>
+<guimenuitem>Modify...</guimenuitem> </menuchoice>.  Alternatively, you
+can use the <mousebutton>right</mousebutton> mouse button menu and
+choose <guimenuitem>Modify...</guimenuitem>, or simply press <keycombo
+action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.  You
+will see the <guilabel>Edit Variable</guilabel> dialog, in which you would
+modify the variable as described <link linkend="new-variable">above</link>.</para>
+
+</sect2>
+
+<sect2>
+<title>Deleting Environment Variables</title>
+
+<para>To delete an environment variable, first select the variable to be
+deleted. Then select
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem>
+</menuchoice></para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton> mouse
+button menu and choose <guimenuitem>Delete</guimenuitem>.</para>
+
+</sect2>
+
+<sect2>
+<title>Enabling/Disabling Environment Variables</title>
+
+<para>To enable or disabled an environment variable, first select the
+disabled variable. Disabled variables will have
+<guilabel>Disabled</guilabel> in their descriptions. Then select
+<menuchoice>
+<guimenu>Edit</guimenu> <guimenuitem>Enabled</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can use the <mousebutton>right</mousebutton>
+mouse button menu and choose
+<menuchoice><guimenuitem>Enabled</guimenuitem></menuchoice>.  Confirm
+that the environment variable's name and value are correctly
+displayed.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="saving-crontab">
+<title>Saving the <filename>crontab</filename></title>
+
+<para>Once all scheduled tasks and environment variables have been
+created and/or properly modified, save the <filename>crontab</filename>
+by selecting
+<menuchoice>
+<guimenu>File</guimenu> <guimenuitem>Save</guimenuitem> </menuchoice>.</para>
+
+<para>Alternatively, you can simply press <keycombo
+action="simul">&Ctrl;<keycap>S</keycap></keycombo>. Additions or changes
+will not actually be made until this is done.</para>
+
+</sect1>
+
+<sect1 id="printing-crontab">
+<title>Printing the <filename>crontab</filename></title>
+
+<para>To print the <filename>crontab</filename> as it has been saved,
+select <menuchoice> <guimenu>File</guimenu>
+<guimenuitem>Print</guimenuitem> </menuchoice>.</para>
+
+
+<!-- FIXME: New screenshot of expanded print dialog -->
+
+<screenshot>
+<screeninfo>Printing the <filename>crontab</filename>.</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="print.png" format="PNG"/></imageobject>
+<textobject><phrase>Printing the
+<filename>crontab</filename>.</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>The standard &kde; printer dialog will display.  If you select
+<guilabel>Expand</guilabel> you will see that there are two extra
+&kcron; specific options in the Print Dialog box.</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Print Crontab</guilabel></term>
+<listitem>
+<para>Prints the <filename>crontab</filename> for the current user.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Print All Users</guilabel></term>
+<listitem>
+<para>Prints the <filename>crontab</filename>s for all users.  This option is
+enabled only for users with super-user privileges.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+<sect1 id="kcron-mainwindow">
+<title>The main &kcron; window</title>
+
+<sect2>
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para><action>Saves changes</action> to the <filename>crontab</filename>.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo 
+action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> 
+<guimenu>File</guimenu> <guimenuitem>Print...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para><action>Prints</action> the <filename>crontab</filename>.</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>Quits</action> &kcron;.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+<sect2>
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem> </menuchoice></term>
+<listitem><para><action>Cut the selected task or
+variable.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Copy the selected task or 
+variable.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Paste a task or variable that has been cut or
+copied.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>New...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Create a new task or
+variable.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Modify...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Modify the selected task or
+variable.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Delete</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Delete the selected task or
+variable.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Enabled</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para><action>Enable/disable the selected task or variable.</action></para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Run Now</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Run the selected task now.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Displays toolbar.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Statusbar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Displays statusbar.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+</sect1>
+</chapter>
+
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+<qandaset id="questions-and-answers">
+<qandaentry>
+<question>
+<para>Why aren't the changes I'm making to scheduled tasks and/or environment
+variables taking effect?</para>
+</question>
+<answer><para>Additions or changes to scheduled tasks do not actually happen until the
+<filename>crontab</filename> has been <link
+linkend="saving-crontab">saved</link>.</para>
+</answer>
+</qandaentry>
+</qandaset>
+</chapter>
+
+<chapter id="credits">
+
+<title>Credits and License</title>
+
+<para>&kcron;</para>
+
+<para>Program copyright 2000 Gary Meyer <email>gary@meyer.net</email></para>
+
+<para>Documentation copyright 2000 Morgan N. Sandquist
+<email>morgan@pipeline.com</email></para>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-kcron">
+<title>How to obtain &kcron;</title>
+
+&install.intro.documentation;
+
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>In order to successfully compile &kcron;, you need the following
+libraries:</para>
+
+<itemizedlist>
+<listitem><para><command>cron</command>, such as
+<command>vixie-cron</command>.  &kcron; uses the
+<filename>crontab</filename> command to modify user's scheduled
+tasks.</para></listitem>
+<listitem><para>POSIX-compliant &UNIX;, such as provided by
+glibc. &kcron; uses some standard &UNIX; system calls for localization of
+dates and times</para></listitem> 
+</itemizedlist>
+
+</sect1>
+
+<sect1 id="compilation">
+<title>Compilation and Installation</title>
+
+&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:
+-->     
diff --git a/doc/kcron/kcron.png b/doc/kcron/kcron.png
new file mode 100644
index 0000000..b800ebf
--- /dev/null
+++ b/doc/kcron/kcron.png
diff --git a/doc/kcron/kcronstart.png b/doc/kcron/kcronstart.png
new file mode 100644
index 0000000..fd4c21b
--- /dev/null
+++ b/doc/kcron/kcronstart.png
diff --git a/doc/kcron/newtask.png b/doc/kcron/newtask.png
new file mode 100644
index 0000000..86da56c
--- /dev/null
+++ b/doc/kcron/newtask.png
diff --git a/doc/kcron/newvariable.png b/doc/kcron/newvariable.png
new file mode 100644
index 0000000..2334952
--- /dev/null
+++ b/doc/kcron/newvariable.png
diff --git a/doc/kcron/print.png b/doc/kcron/print.png
new file mode 100644
index 0000000..c622f26
--- /dev/null
+++ b/doc/kcron/print.png
diff --git a/doc/kdat/Makefile.am b/doc/kdat/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kdat/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kdat/index.docbook b/doc/kdat/index.docbook
new file mode 100644
index 0000000..b5fb94e
--- /dev/null
+++ b/doc/kdat/index.docbook
@@ -0,0 +1,833 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
+"dtd/kdex.dtd" [
+  <!ENTITY kappname "&kdat;">
+  <!ENTITY package "kdeadmin">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>&kdat; Documentation</title>
+
+<authorgroup>
+
+<author>
+<firstname>Sean</firstname>
+<surname>Vyain</surname>
+<affiliation><address><email>svyain@mail.tds.net</email></address></affiliation>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<copyright>
+<year>2000</year>
+<holder>Sean Vyain</holder>
+</copyright>
+
+<date>2000-10-03</date>
+<releaseinfo>2.00.00</releaseinfo>
+
+<abstract><para>This documentation describes &kdat; 
+2.0</para></abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KDat</keyword>
+<keyword>tape</keyword>
+<keyword>tape management</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="Introduction">
+<title>Introduction</title>
+
+<para>&kdat; is a tar-based tape archiver. It is designed to work with
+multiple archives on a single tape. &kdat; was inspired by two separate 
+goals.
+The first, was to provide a nice, <abbrev>GUI</abbrev> front-end to tar 
+that
+supported the fast selective extraction features of the
+<application>dds2tar</application> program. The second goal was to 
+answer my wife's
+question, <quote>How much longer is it going to be backing 
+up?!?</quote></para>
+
+<!-- //////// -->
+<sect1 id="features">
+<title>Features</title>
+
+<itemizedlist>
+<listitem><para>Simple graphical interface to local filesystem and tape
+contents.</para>
+</listitem>
+<listitem><para>Multiple archives on the same physical tape.</para>
+</listitem>
+<listitem><para>Complete index of archives and files is stored on local 
+hard
+disk.</para>
+</listitem>
+<listitem><para>Selective restore of files from an archive.</para>
+</listitem>
+<listitem><para>Backup profiles for frequently used backups.</para>
+</listitem>
+</itemizedlist>
+
+</sect1>
+</chapter>
+
+<chapter id="using-kdat">
+<title>Using &kdat;</title>
+
+<sect1 id="mount">
+<title>Mounting/unmounting a tape</title>
+
+<para>Before a tape can be used, it must be mounted by &kdat;. There are 
+
+
+
+
+three
+ways to mount a tape:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Mount Tape</guimenuitem> from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>Click on the <guiicon>tape drive</guiicon> icon on the
+toolbar.</para>
+</listitem>
+<listitem><para>&RMB; click on the tape drive tree node, and select
+<guimenuitem>Mount Tape</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>&kdat; will rewind the tape, and read the header information from  
+the tape. If &kdat; does not recognize the header on the tape, you will  
+be prompted to <link linkend="formatting">format</link> the tape.</para>
+
+<para>If &kdat; recognizes the header it will look for the corresponding
+tape index on your local disk. If the tape index cannot be found you  
+will be prompted to <link linkend="indexing">recreate the index from  
+tape</link>.</para>
+
+<para>If all goes well, the tape drive icon will change to indicate that
+the tape has been mounted, and a message will appear in the status bar.  
+The contents of the tape can be explored under the tape drive tree  
+node.</para>
+
+<para>Before ejecting a tape, you must unmount the tape. There are three
+ways to unmount the tape:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Unmount Tape</guimenuitem> from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>Click on the <guiicon>tape drive</guiicon> icon on the
+toolbar.</para>
+</listitem>
+<listitem><para>&RMB; click on the tape drive tree node, and select
+<guimenuitem>Unmount Tape</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>&kdat; will acknowledge that the tape has been unmounted by 
+changing the
+tape drive icon, and displaying a message in the status bar. The tape 
+may now
+be safely ejected.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="formatting">
+<title>Formatting a tape</title>
+
+<para>Before a tape can be used by &kdat;, it must be formatted by
+&kdat;.</para>
+
+<para>Some types of tapes must be formatted before they can be used to
+store data. <emphasis>This is not what &kdat; does when formatting a
+tape.</emphasis> If your tape drive requires that the tapes be formatted 
+
+
+
+
+before
+using them, then they must be formatted before they can be 
+<quote>formatted</quote>
+by &kdat;. Typically floppy tape drives require that their media be 
+formatted, but
+DAT drives do not.</para>
+
+<para>There are two ways to format a tape:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Format Tape...</guimenuitem> from 
+the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>&RMB; click on the tape drive tree node, and select
+<guimenuitem>Format Tape...</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>You will be prompted for a name for the tape, and the stated
+capacity of the tape. Both of these parameters can be changed
+after the tape has been formatted. The tape name is only used
+to identify the tape to the user; it is not used to identify the
+tape index associated with the tape. Instead, a unique tape
+identifier is automatically generated and written to the tape.
+The stated capacity of the tape is used by &kdat; to warn the user
+if there will not be enough space to complete a backup.</para>
+
+<para>After entering the tape name and capacity, &kdat; will proceed to
+format the tape. <emphasis>ALL DATA ON THE TAPE WILL BE LOST</emphasis>.
+Once &kdat; has finished formatting the tape, the tape will be 
+automatically
+mounted and is ready for use.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="backing-up">
+<title>Backing up files to tape</title>
+
+<para>Before initiating a backup, you must select some files to archive. 
+
+
+
+
+There
+are three ways to select files for backup:</para>
+
+<orderedlist>
+<listitem><para>Highlight a file or folder in the local file tree. 
+Only the
+selected file or subfolder will be archived.</para>
+</listitem>
+<listitem><para>Highlight a <link linkend="profile">backup 
+profile</link> in the
+tree. Only the files in the backup profile will be archived.</para>
+</listitem>
+<listitem><para>Checkmark selected files in the local file tree. Only 
+the
+checked files and/or subfolders will be archived.</para>
+</listitem>
+</orderedlist>
+
+<para>There are four ways to initiate a backup:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Backup...</guimenuitem> from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>Click on the <guiicon>backup</guiicon> icon in the
+toolbar.</para>
+</listitem>
+<listitem><para>&RMB; click on a file or folder in the local file 
+tree, and
+select <guimenuitem>Backup...</guimenuitem>.</para>
+</listitem>
+<listitem><para>&RMB; click on a <link linkend="profile">backup 
+profile</link>,
+and select <guimenuitem>Backup...</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>Once the backup has been initiated, the <guilabel>Backup
+Options</guilabel> dialog will appear. This dialog gives you a chance to
+review the selected files, and change the backup options.</para>
+
+<para>After accepting the backup options, the 
+<guilabel>Backup</guilabel>
+dialog will  appear. This dialog shows the progress of the backup 
+including
+throughput and time remaining.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="verifying">
+<title>Verifying tape files against local files</title>
+
+<para>Before initiating a verify, you must select some files to 
+verify.</para>
+
+<para>There are two ways to select files for verification:</para>
+
+<orderedlist>
+<listitem><para>Highlight a file or folder in one of the archives 
+under the
+tape drive tree node. Only the selected file or subfolder will be
+verified.</para>
+</listitem>
+<listitem><para>Checkmark selected files in one of the archives under 
+the tape
+drive tree node. Only the checked files and/or subfolders will be
+verified.</para>
+</listitem>
+</orderedlist>
+
+<para>There are three ways to initiate a verify:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Verify...</guimenuitem> from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>Click on the <guiicon>verify</guiicon> icon in the
+toolbar.</para>
+</listitem>
+<listitem><para>&RMB; click on a file or folder in one of the
+archives, and select <guimenuitem>Verify...</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+
+<para>Once the verify has been initiated, the <guilabel>Verify
+Options</guilabel> dialog will appear. This dialog gives you a chance to
+review the selected files, and change the working folder for the
+verification.</para>
+
+<para>After accepting the verify options, the 
+<guilabel>Verify</guilabel>
+dialog will appear. This dialog shows the progress of the verification
+including throughput and time remaining.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="restoring">
+<title>Restoring files from tape</title>
+
+<para>Before initiating a restore, you must select some files to
+restore. There are two ways to select files for restoring:</para>
+
+<orderedlist>
+<listitem><para>Highlight a file or folder in one of the archives 
+under the
+tape drive tree node. Only the selected file or subfolder will be
+restored.</para>
+</listitem>
+<listitem><para>Checkmark selected files in one of the archives under 
+the tape
+drive tree node. Only the checked files and/or subfolders will be
+restored.</para>
+</listitem>
+</orderedlist>
+
+<para>There are three ways to initiate a restore:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Restore...</guimenuitem> from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>Click on the <guiicon>restore</guiicon> icon in the
+toolbar.</para>
+</listitem>
+<listitem><para>&RMB; click on a file or folder in one of the 
+archives, and select
+<guimenuitem>Restore...</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>Once the restore has been initiated, the <guilabel>Restore
+Options</guilabel> dialog will appear. This dialog gives you a chance to
+review the selected files, and change the working folder for the
+restore.</para>
+
+<para>After accepting the restore options, the 
+<guilabel>Restore</guilabel>
+dialog will appear.  This dialog shows the progress of the restore 
+including
+throughput and time remaining.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="indexing">
+<title>Recreating an index from tape</title>
+
+<para>Sometimes it may be necessary to recreate the tape index file from 
+
+
+
+
+the tape
+contents. <emphasis>This process will overwrite any existing index
+file for the tape</emphasis>. There are two way to recreate an index 
+from
+tape:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Recreate Tape Index</guimenuitem> 
+from the
+<guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>&RMB; click on the tape drive tree node, and select
+<guimenuitem>Recreate Tape Index</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>The <guilabel>Index</guilabel> dialog will appear. This dialog 
+shows
+&kdat;'s progress as it creates the index file.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="profile">
+<title>Creating a backup profile</title>
+
+<para>There are two ways to create a backup profile:</para>
+
+<orderedlist>
+<listitem><para>Select <guimenuitem>Create Backup Profile</guimenuitem> 
+from
+the <guimenu>File</guimenu> menu.</para>
+</listitem>
+<listitem><para>&RMB; click on the <guilabel>Backup Profiles</guilabel>
+tree node, and select <guimenuitem>Create Backup 
+Profile</guimenuitem>.</para>
+</listitem>
+</orderedlist>
+
+<para>This should create a new backup profile using the currently 
+checked files
+and the default backup options. The following options can be set for the 
+
+
+
+
+backup
+profile:</para>
+
+<variablelist>
+
+<varlistentry>
+<term>Archive name</term>
+<listitem><para>The symbolic name for the archive. It can be changed
+later.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>Working folder</term>
+<listitem><para>The current working folder to perform the backup in. 
+The
+list of files to backup is automatically updated to reflect the selected 
+
+
+
+
+working
+folder.</para> </listitem>
+</varlistentry>
+<varlistentry>
+<term>Stay on one filesystem</term>
+<listitem><para>For each folder that is listed under
+<guilabel>Backup files</guilabel>, only the files under that folder 
+that are
+on the same filesystem as the folder will be archived. Folders on 
+
+
+
+
+different
+filesystems can be listed under <guilabel>Backup files</guilabel>, and 
+each will
+be treated independently of the others, by tar.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>GNU listed incremental</term>
+<listitem><para>Perform an incremental backup. A snapshot file is used 
+to
+determine which files have changed since the last incremental backup. 
+Only the
+files that have changed will be archived.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>Snapshot file</term>
+<listitem><para>The name of the file that is used to determine which 
+files have
+changed since the last incremental backup.</para> </listitem>
+</varlistentry>
+<varlistentry>
+<term>Remove snapshot file before backup.</term>
+<listitem><para>Remove the snapshot file before invoking
+<application>tar</application>. This has the effect of backing up all of 
+
+
+
+
+the
+files, and creating the snapshot file for use next time.</para> 
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<note><para>The <guibutton>Files &gt;&gt;</guibutton> and 
+<guibutton>&lt;&lt;
+Files</guibutton> buttons were not fully implemented at the time this 
+documentation was
+written...</para></note>
+
+<para>You must press the <guibutton>Apply</guibutton> button to commit 
+any
+changes made to the backup profile.</para>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="prefs">
+<title>Configuring user preferences</title>
+
+<para>User preferences can be configured by selecting
+<guimenuitem>Preferences...</guimenuitem> from the 
+<guimenu>Edit</guimenu>
+menu. The following preferences can be configured:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Default tape size</guilabel>
+</term>
+<listitem><para>This value will be used as the default tape size when 
+formatting
+a tape.</para> </listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Tape block size</guilabel>
+</term>
+<listitem><para>The hardware block size for the tape drive. For floppy 
+tape
+drives this value should be 10240 bytes.</para> </listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Tape device</guilabel>
+</term>
+<listitem><para>The full path to your tape device (usually 
+<filename>/dev/tape</filename>).
+This path must point to the <emphasis>non-rewind</emphasis> version of 
+your tape device.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Tar command</guilabel>
+</term>
+<listitem><para>The full path to the <command>tar</command> command on 
+your
+system.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Load tape on mount</guilabel>
+</term>
+<listitem><para>If enabled, before trying to mount a tape &kdat; will 
+issue an
+<userinput><command>mt<option>load</option></command></userinput> 
+command to the
+tape drive. Some drives may require this before reading and writing the
+tape.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Lock tape drive on mount</guilabel>
+</term>
+<listitem><para>If enabled, whenever a tape is mounted by &kdat;, the 
+tape drive
+will be asked to disable the eject button. This option may not work with 
+
+
+
+
+all
+tape drives.</para> </listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Eject tape on unmount</guilabel>
+</term>
+<listitem><para>If enabled, whenever a tape is unmounted by &kdat;, the 
+tape
+will automatically be ejected from the drive. Do not use this option 
+with floppy tape
+drives.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Variable block size</guilabel>
+</term>
+<listitem><para>If enabled, &kdat; will attempt to change the hardware 
+block
+size used by the tape drive. Not all drives support variable block size.
+Whether this feature is enabled or not, you must tell &kdat; the block 
+size that
+your tape drive uses (&ie; 10240 for ftape users).</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<!-- //////// -->
+<sect1 id="tapeformat">
+<title>&kdat; tape format</title>
+
+<para>When &kdat; formats a tape it writes a single file at the 
+beginning of the
+tape. This file should only occupy a single tape block. The contents of 
+the
+file are:</para>
+
+<itemizedlist>
+<listitem><para>(9 bytes) The string literal 
+<literal>KDatMAGIC</literal></para>
+</listitem>
+<listitem><para>(4 bytes) The file format version number (currently 
+1).</para>
+</listitem>
+<listitem><para>(4 bytes) The length in bytes of the tape ID 
+string.</para>
+</listitem>
+<listitem><para>(n bytes) The tape ID string. The format of this string 
+is
+<replaceable>hostname</replaceable>:<replaceable>seconds</replaceable>, 
+where
+<replaceable>hostname</replaceable> is the full name of the machine that 
+
+
+
+
+the tape was
+formatted on and <replaceable>seconds</replaceable> is the number of 
+seconds since
+the epoch when the tape was formatted.</para>
+</listitem>
+</itemizedlist>
+
+<para>The tape ID is used to locate a file, with the same name, in the
+<filename>$<envar>HOME</envar>/.kdat</filename> folder.</para>
+
+<para>Each of the remaining files on the tape are plain-old
+<application>tar</application> archives. You should be able to 
+manipulate them
+directly with <acronym>GNU</acronym> <application>tar</application>. 
+Even
+non-<acronym>GNU</acronym> <application>tar</application> should work 
+for
+non-incremental backups.</para>
+
+</sect1>
+</chapter>
+
+<!-- 
+********************************************************************** 
+-->
+<chapter id="menu-reference">
+<title>Menu and Toolbar Reference</title>
+
+<sect1 id="menus">
+<title>&kdat; menus</title>
+
+<para>&kdat; has three menus:
+<link linkend="menu-file"><guimenu>File</guimenu></link>,
+<link linkend="menu-edit"><guimenu>Edit</guimenu></link>, and
+<link linkend="menu-help"><guimenu>Help</guimenu></link>.</para>
+
+<!-- //////// -->
+<sect2 id="menu-file">
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Backup</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Begin a backup.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Restore</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Restore a backup from 
+tape.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Verify</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Verify a backup.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Mount Tape</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Mount a tape.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Recreate Tape Index</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Recreate an index on the currently mounted
+tape.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Create Backup Profile</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens the dialog box that allows you to create a 
+
+
+
+
+Backup
+Profile.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Delete Archive</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Delete an archive from the 
+tape.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Delete Index</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Delete the &kdat; index from a 
+tape.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Delete Backup Profile</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Delete a Backup 
+Profile.</action></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu><guimenuitem>Format Tape</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Format a tape for use with 
+&kdat;.</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>Exit &kdat;.</action></para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- //////// -->
+<sect2 id="menu-edit">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens the <guilabel>Preferences</guilabel> dialog, where
+you can configure &kdat; for your needs.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- //////// -->
+<sect2 id="menu-help">
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+
+<!-- //////// -->
+<sect2 id="icon-reference">
+<title>The &kdat; toolbar</title>
+
+<para>The &kdat; toolbar contains 6 icons, as follows:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guiicon>Mount/unmount Tape</guiicon>
+</term>
+<listitem><para>Mount or unmount a tape.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guiicon>Backup</guiicon>
+</term>
+<listitem><para>Begin a backup. This item is unavailable unless a tape 
+is
+mounted.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guiicon>Restore</guiicon>
+</term>
+<listitem><para>Restore a backup from tape. This item is unavailable 
+unless a
+tape is mounted.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guiicon>Verify</guiicon>
+</term>
+<listitem><para>Verify the contents of a backup tape. This item is 
+unavailable unless
+a tape is mounted.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guiicon>Help</guiicon>
+</term>
+<listitem><para>Opens the &kdat; help files (this 
+document)</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guiicon>Quit</guiicon>
+</term>
+<listitem><para>Quits &kdat;</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<!-- 
+*********************************************************************** 
+-->
+<chapter id="Copyright">
+<title>Copyright</title>
+<para>&kdat;</para>
+
+<para>Program and Documentation copyright 1998-2000 Sean
+Vyain<email>svyain@mail.tds.net</email></para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+
+</chapter>
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
diff --git a/doc/knetworkconf/01.png b/doc/knetworkconf/01.png
new file mode 100644
index 0000000..0e6bd6f
--- /dev/null
+++ b/doc/knetworkconf/01.png
diff --git a/doc/knetworkconf/02.png b/doc/knetworkconf/02.png
new file mode 100644
index 0000000..2d41e65
--- /dev/null
+++ b/doc/knetworkconf/02.png
diff --git a/doc/knetworkconf/03.png b/doc/knetworkconf/03.png
new file mode 100644
index 0000000..89dbf86
--- /dev/null
+++ b/doc/knetworkconf/03.png
diff --git a/doc/knetworkconf/04.png b/doc/knetworkconf/04.png
new file mode 100644
index 0000000..9a80161
--- /dev/null
+++ b/doc/knetworkconf/04.png
diff --git a/doc/knetworkconf/05.png b/doc/knetworkconf/05.png
new file mode 100644
index 0000000..c10457c
--- /dev/null
+++ b/doc/knetworkconf/05.png
diff --git a/doc/knetworkconf/06.png b/doc/knetworkconf/06.png
new file mode 100644
index 0000000..1dc2096
--- /dev/null
+++ b/doc/knetworkconf/06.png
diff --git a/doc/knetworkconf/07.png b/doc/knetworkconf/07.png
new file mode 100644
index 0000000..fee712e
--- /dev/null
+++ b/doc/knetworkconf/07.png
diff --git a/doc/knetworkconf/08.png b/doc/knetworkconf/08.png
new file mode 100644
index 0000000..fc56293
--- /dev/null
+++ b/doc/knetworkconf/08.png
diff --git a/doc/knetworkconf/09.png b/doc/knetworkconf/09.png
new file mode 100644
index 0000000..3c834a8
--- /dev/null
+++ b/doc/knetworkconf/09.png
diff --git a/doc/knetworkconf/11.png b/doc/knetworkconf/11.png
new file mode 100644
index 0000000..3ebffaf
--- /dev/null
+++ b/doc/knetworkconf/11.png
diff --git a/doc/knetworkconf/Makefile.am b/doc/knetworkconf/Makefile.am
new file mode 100644
index 0000000..01c1911
--- /dev/null
+++ b/doc/knetworkconf/Makefile.am
@@ -0,0 +1,4 @@
+KDE_LANG = en
+KDE_DOCS = knetworkconf
+
+
diff --git a/doc/knetworkconf/about1.png b/doc/knetworkconf/about1.png
new file mode 100644
index 0000000..f602d20
--- /dev/null
+++ b/doc/knetworkconf/about1.png
diff --git a/doc/knetworkconf/index.docbook b/doc/knetworkconf/index.docbook
new file mode 100644
index 0000000..929e413
--- /dev/null
+++ b/doc/knetworkconf/index.docbook
@@ -0,0 +1,1117 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY knetworkconf "<application>KNetworkConf</application>">
+  <!ENTITY kappname "&knetworkconf;">
+  <!ENTITY package "kdeadmin">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>&kde; Network Configuration</title>
+
+<authorgroup>
+<author>
+<firstname>Sean</firstname>
+<surname>Wheller</surname>
+<affiliation><orgname>
+<ulink url="http://www.inwords.co.za">In Words Techdoc
+Solutions</ulink>
+</orgname> 
+<address><email>sean@inwords.co.za</email></address>
+</affiliation>
+</author>
+<author>
+<firstname>Christoph</firstname>
+<surname>Eckert</surname>
+<affiliation>
+<address><email>ce.at.christeck.de</email></address>
+</affiliation>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2005</year>
+<holder>
+<ulink url="http://www.inwords.co.za">In Words Techdoc
+Solutions</ulink>
+</holder>
+<holder>Christoph Eckert</holder>
+</copyright>
+<legalnotice>&FDLNotice;</legalnotice>
+<!-- FIXME: Revhistory is not used in KDE docs, we have revision control to -->
+<!-- handle this retaining this for the first commit, to maintain history, -->
+<!-- but it should be removed on the next edit -->
+<!-- <revhistory>
+<revision>
+<revnumber>0.1</revnumber>
+<date>March 18, 2005</date>
+<revremark>Documented using 0.6.1-3ubuntu1 under Kubuntu. At
+time of writing this version was not a release and was
+therefore in &apos;Universe.&apos;</revremark>
+</revision>
+<revision>
+<revnumber>0.2</revnumber>
+<date>March 23, 2005</date>
+<revremark>Merge upstream work by Christoph from r1.16 into
+document.</revremark>
+</revision>
+</revhistory> -->
+
+<date>2005-03-24</date>
+<releaseinfo>1.0</releaseinfo>
+
+<abstract>
+<para>This manual explains how to install and use &knetworkconf;, a module for
+&kcontrolcenter; that enables management of Network Interfaces, Routing and DNS
+properties.</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdeadmin</keyword>
+<keyword>network</keyword>
+<keyword>ethernet</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+<para>The &kcontrolcenter; provides users with a single
+integrated interface from which to manage a wide variety of system and
+desktop settings and preferences. &kcontrolcenter; can be started by selecting
+<menuchoice><guimenu>K Menu</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem></menuchoice>.</para>
+
+<para>The &knetworkconf; package was developed to enable users to manage TCP/IP
+networking settings in the same way they manage other system settings from
+&kcontrolcenter;. Tasks enabled by &knetworkconf; provide users with a simple
+interface from which to perform the following tasks:</para>
+
+<itemizedlist>
+<listitem>
+<para>Apply IP addresses to interfaces </para>
+</listitem>
+<listitem>
+<para>Apply netmasks to interfaces </para>
+</listitem>
+<listitem>
+<para>Start and stop interface activities </para>
+</listitem>
+<listitem>
+<para>Configure Routing </para>
+</listitem>
+<listitem>
+<para>Configure Host- and Domain Name </para>
+</listitem>
+<listitem>
+<para>Configure Resolving </para>
+</listitem>
+<listitem>
+<para>Manage known hosts </para>
+</listitem>
+</itemizedlist>
+
+<para>Once installed a new module called <guimenuitem>Network
+Settings</guimenuitem> is displayed in the &kcontrolcenter;.
+To start the <application>Network Settings</application> (&knetworkconf;) module select <menuchoice>
+<guimenuitem>&kcontrolcenter;</guimenuitem> <guimenuitem>Internet &amp; Network</guimenuitem>
+<guimenuitem>Network Settings</guimenuitem> </menuchoice> in the &kmenu;.</para>
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="11.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>&knetworkconf; in user mode</phrase>
+</textobject>
+</mediaobject>
+
+<para>It is important to understand that &knetworkconf; cannot install
+networking hardware. As such physical devices and their drivers must be
+properly installed and configured in order for &knetworkconf; to display the
+device and enable management of networking properties.</para>
+
+<para>In most cases drivers for networking hardware and other devices are
+installed and configured while installing &Linux;. If you add networking
+hardware after installation, you will have to define the drivers to be
+loaded by editing one of the following files depending on your kernel
+version:</para>
+
+<variablelist>
+<varlistentry>
+<term>&Linux; Kernel 2.4 and lower</term>
+<listitem>
+<para>
+<filename class="devicefile"
+>/etc/modules.conf</filename>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>&Linux; Kernel 2.6 and higher</term>
+<listitem>
+<para>
+<filename class="devicefile"
+>/etc/modprobe.conf</filename>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</chapter>
+
+<chapter id="using-the-module">
+<title>Using the Network Settings Module</title>
+
+<para>The <application>Network Settings</application> module is loaded when
+the <guibutton>Network Settings</guibutton> option is selected in the
+&kcontrolcenter; index. When started the <application>Network
+Settings</application> module attempts to automatically detect the platform
+running on the system.</para>
+
+<screenshot>
+<screeninfo>Detecting the platform</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="02.png"
+format="PNG"/>
+</imageobject>
+</mediaobject>
+</screenshot>
+
+<para>When the platform is not a recognized you will be prompted to manually
+select the platform. Select a platform from the list that most closely
+corresponds to your distro and its release.  Check the <guibutton>Don't ask
+again</guibutton> option to make this choice permanent. Next time
+<guibutton>Network Settings</guibutton> is started the system will
+automatically default to the selected platform option.</para>
+
+<!--FIXME: several screenshots that were linked in this doc are missing-->
+<!--screenshot>
+<screeninfo>Selecting a platform</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="figures/knetwork-conf-select-platform.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Selecting a platform</phrase>
+</textobject>
+</mediaobject>
+</screenshot-->
+
+<para>To manage the system network settings you must enter
+<quote>administrator mode.</quote> Prior to this all options will be
+<quote>grayed,</quote> meaning you can only navigate the interface and view
+properties. Editing is disabled. To enter <quote>administrator mode</quote>
+click the <guibutton>Administrator Mode</guibutton> button located bottom
+left of the module. Enter your password when prompted.</para>
+
+<screenshot>
+<screeninfo>&knetworkconf; in administrator mode</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="01.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>&knetworkconf; in administrator mode</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<para>Once in <quote>administrator mode</quote> all the modules
+functionality is enable. Functionality is organized into three tabs:</para>
+
+<itemizedlist>
+<listitem>
+<para>
+<xref linkend="network-interfaces"/>
+</para>
+</listitem>
+<listitem>
+<para>
+<xref linkend="route"/>
+</para>
+</listitem>
+<listitem>
+<para>
+<xref linkend="dns"/>
+</para>
+</listitem>
+</itemizedlist>
+
+<sect1 id="network-interfaces">
+<title>Managing Network Interfaces</title>
+
+<para>The <guibutton>Network Interfaces</guibutton> tab is used to manage
+the network communications devices installed on the system. All available
+networking devices are listed. From the <guibutton>Network
+Interfaces</guibutton> tab the following tasks can be accomplished:</para>
+
+<itemizedlist>
+<listitem>
+<para>
+<xref linkend="configure-interface"/>
+</para>
+</listitem>
+<listitem>
+<para>
+<xref linkend="enable-interface"/>
+</para>
+</listitem>
+<listitem>
+<para>
+<xref linkend="disable-interface"/>
+</para>
+</listitem>
+</itemizedlist>
+
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="03.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>The &knetworkconf; interface</phrase>
+</textobject>
+</mediaobject>
+
+<para>For each network device the following properties can be
+viewed:</para>
+
+<variablelist>
+<varlistentry>
+<!-- FIXME: Check punctuation of the GUI against the styleguide, and then -->
+<!-- make sure the doc matches precisely, to aid translation -->
+<term><guilabel>Interface</guilabel></term>
+<listitem>
+<para>Shows the name of the network interfaces. For example, eth0, eth1,
+wlan0.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>IP Address</guilabel></term>
+<listitem>
+<para>Shows the currently assigned IP address.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Protocol</guilabel></term>
+<listitem>
+<para>Shows the boot protocol.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>State</guilabel></term>
+<listitem>
+<para>Shows the current state (up or down).</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Comment</guilabel></term>
+<listitem>
+<para>Shows the (freely assignable) comment.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect2 id="configure-interface">
+<title>Configuring a Networking Device</title>
+
+<para>The properties of listed network devices can be configured by
+selecting the required device from the list then <action>clicking</action>
+the <guibutton>Configure Interface...</guibutton> button to display the
+<interface>Configure Device</interface> dialog.</para>
+
+<screenshot>
+<screeninfo>Configuring a networking device</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="04.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Configuring a networking device</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<para>By default only basic TCP/IP settings are available. Click
+the <guibutton>Advanced Settings</guibutton> button to
+expand the dialog to include advanced properties.</para>
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="05.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Advanced device configuration</phrase>
+</textobject>
+</mediaobject>
+
+<para>Complete the dialog values are as follows:</para>
+<variablelist>
+<varlistentry>
+<term>
+<emphasis role="bold">Automatic</emphasis>
+</term>
+<listitem>
+
+<para>Select the <guibutton>Automatic</guibutton> radio button when the
+TCP/IP settings are obtained from a DHCP server or BOOTP server node. In
+automatic mode the TCP/IP settings for the system are configured when the
+system services are started. The DHCP or BOOTP server sends all the required
+TCP/IP information each time the system is started, there is no need to
+configure any other settings. Use the drop-list to select
+<option>DHCP</option> or <option>BOOTP</option> according to your
+system.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Manual</guilabel></term>
+<listitem>
+<para>Select the <guibutton>Manual</guibutton> radio button when you do not
+use DHCP or BOOTP for TCP/IP configuration. In the <guibutton>IP
+address</guibutton> field enter the TCP/IP address of the host. In the
+<guibutton>Netmask</guibutton> field enter the subnetwork address.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Activate when the computer starts</guilabel></term>
+<listitem>
+<para>When checked this option will cause the system to initialize this
+network interface while the system is booting. If you do not want the device
+initialized leave this option unchecked.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<guilabel>Description</guilabel>
+</term>
+<listitem>
+<para>Enter a descriptive name.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<guilabel>Broadcast</guilabel>
+</term>
+<listitem>
+<para>Enter the <quote>broadcast address</quote> used to communicate with
+all hosts on the subnetwork.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>The values entered in this dialog will be displayed as the properties
+of the device in the device list.</para>
+
+<caution>
+<para>Make certain that the IP-address entered is not already in use on the
+network. Entering an IP-address that is already on the network will result
+in a TCP/IP conflict. Use <application>ping</application> from &konsole; to
+check if the address you want to enter is in use or not. If you are not sure
+how to complete this dialog, consult your network administrator.</para>
+</caution>
+
+</sect2>
+
+<sect2 id="enable-interface">
+<title>Enabling a Network Device</title>
+
+<para>Network devices may be enabled or disabled depending on system
+requirements. To enable a disabled network device select the device from the
+list then click <guibutton>Enable Interface</guibutton>.</para>
+
+</sect2>
+
+<sect2 id="disable-interface">
+<title>Disabling Network Devices</title>
+
+<para>Network devices may be enabled or disabled depending on system
+requirements. To disable an enabled network device select the device from
+the list then click <guibutton>Disable Interface</guibutton>.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="route">
+<title>Managing System Routing</title>
+
+<para>The <guibutton>Routes</guibutton> tab enables management of
+the system routing configuration.</para>
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="06.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Advanced device configuration</phrase>
+</textobject>
+</mediaobject>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Default Gateway</guilabel></term>
+<listitem>
+<para>This specifies the IP address of the host on the local subnetwork that
+provides the physical connection to remote networks, and is used by default
+when TCP/IP needs to communicate with computers on other subnetworks.</para>
+<para>Select a device from the drop list to edit the <guibutton>Default
+Gateway</guibutton> value.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<note>
+<para>If your computer offers more than one network interface, select the
+interface connected to network on which the gateway computer resides.</para>
+</note>
+
+</sect1>
+
+<sect1 id="dns">
+<title>Managing DNS Settings</title>
+
+<para>The <guibutton>Domain Name System</guibutton> tab enables management
+of the system DNS configuration.</para>
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="07.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Advanced device configuration</phrase>
+</textobject>
+</mediaobject>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Host name</guilabel></term>
+<listitem>
+<para>The name by which the host will be known on the subnetwork.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Domain name</guilabel></term>
+<listitem>
+<para>The network domain in which the host resides.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Domain Name Servers</guilabel></term>
+<listitem>
+<para>A list of DNS servers in order of preference (see <xref
+linkend="manage-dns"/>).</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Static Hosts</guilabel></term>
+<listitem>
+<para>A list of known hosts on the subnetwork system (see <xref
+linkend="manage-hosts"/>).</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect2 id="manage-dns">
+<title>Managing DNS Servers</title>
+
+<para>A computer running DNS matches up a fully qualified domain with a
+proper IP address. This is necessary because computers only understand the
+IP addresses. When a computer requests http://www.somedomain.com the DNS
+resolves this name to an IP-address such as 123.45.678.90.</para>
+
+<para>The <guilabel>Domain Name Servers</guilabel> part of the
+<guibutton>Domain Name System</guibutton> tab enables easy management of the
+list. Server properties can be added, removed and edited. DNS records can be
+arranged in order of preference by selecting a record and promoting or
+demoting the record in the list using the <guibutton>Move Up</guibutton> or
+<guibutton>Move Down</guibutton> buttons as required.</para>
+
+<procedure>
+<!-- Buggy. cant add alias but alias is required -->
+<title>Adding a DNS server</title>
+<step>
+<para>From the <guilabel>Domain Name Servers</guilabel> group click the
+<guibutton>Add...</guibutton> button.  The <guilabel>Add New DNS Server</guilabel>
+dialog is displayed.</para>
+<!--mediaobject>
+<imageobject>
+<imagedata
+fileref="knetwork-conf-kcontrol-add-dns.png"
+format="PNG"/>
+</imageobject>
+<textobject><phrase>Adding a DNS server</phrase></textobject>
+</mediaobject-->
+</step>
+
+<step>
+<para>Enter the IP-address of the DNS server then click
+<guibutton>Add</guibutton>. The record is added to the DNS list.</para>
+</step>
+</procedure>
+
+<procedure>
+<!-- Buggy. no alias cant edit but alias is required -->
+<title>Editing a DNS server record</title>
+<step>
+<para>From the <guilabel>Domain Name Servers</guilabel> group select a DNS
+record then click the <guibutton>Edit...</guibutton> button. The
+<guilabel>Edit Server</guilabel> dialog is displayed.</para>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="09.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Editing a DNS server record</phrase>
+</textobject>
+</mediaobject>
+</step>
+<step>
+<para>Modify the IP-address then click <guibutton>OK</guibutton>. The record
+is updated to the DNS list.</para>
+</step>
+</procedure>
+</sect2>
+
+<sect2 id="manage-hosts">
+<title>Managing Static (Known) Hosts</title>
+
+<para>The <guilabel>Static Hosts</guilabel> list describes a number of
+hostname-to-address mappings for the TCP/IP subsystem. It is mostly used at
+boot time, when no name servers are running. On small, closed network
+systems, it can be used instead of Domain Name Servers.</para>
+
+<para>By default, the <guilabel>Static Hosts</guilabel> list contains some
+records describing the &apos;localhost&apos; and a handful of special
+records for hosts that support IPv6. This still-experimental version of IP
+is destined to replace version 4.</para>
+
+<procedure>
+<title>Adding Static Hosts</title>
+<step>
+<para>Click the <guibutton>Add...</guibutton> button. The <guilabel>Add New 
+Static Host</guilabel> dialog is displayed.</para>
+<!--mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/knetwork-conf-kcontrol-statichost.png"
+format="PNG"/>
+</imageobject>
+<textobject><phrase>Adding static hosts</phrase></textobject>
+</mediaobject-->
+</step>
+<step>
+<para>Enter the IP-address of the known host then click
+<guibutton>Add...</guibutton>. The <guilabel>Add New Alias</guilabel> dialog is
+displayed.</para>
+<!--mediaobject>
+<imageobject>
+<imagedata
+fileref="knetwork-conf-kcontrol-statichost-add.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Adding a static host</phrase>
+</textobject>
+</mediaobject-->
+</step>
+<step>
+<para>Enter the name of the known host then click the
+<guibutton>Add</guibutton> button. If the known host has multiple aliases
+click the <guibutton>Add</guibutton> button again and enter another
+alias.</para>
+</step>
+<step>
+<para>When finished click <guibutton>OK</guibutton> to update the Static
+Hosts list.</para>
+</step>
+</procedure>
+
+<procedure>
+<title>Editing Static Hosts</title>
+<step>
+<para>Select a static host record from the list, then click the
+<guibutton>Edit...</guibutton> button. The <guilabel>Edit Static
+Host</guilabel> dialog is displayed.</para>
+<!--mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/knetwork-conf-kcontrol-statichost-record-edit.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Editing static hosts</phrase>
+</textobject>
+</mediaobject-->
+</step>
+<step>
+<para>Perform any of the following tasks, then click
+<guibutton>OK</guibutton> to update the Static Hosts list.</para>
+<itemizedlist>
+<listitem>
+<para>To change the IP-address, enter a new IP-address, then click
+<guibutton>OK</guibutton>.</para>
+</listitem>
+<listitem>
+<para>To add a new alias, click the <guibutton>Add...</guibutton>
+button.</para>
+</listitem>
+<listitem>
+<para>To change an alias value, select the alias record, then click
+<guibutton>Edit...</guibutton>.</para>
+</listitem>
+<listitem>
+<para>To remove an alias, select an alias record then click
+<guibutton>Remove</guibutton>.</para>
+</listitem>
+</itemizedlist>
+</step>
+</procedure>
+</sect2>
+</sect1>
+</chapter>
+
+<chapter id="applying-changes">
+<title>Applying Changes</title>
+
+<para>Changes made via the <application>Network Settings</application>
+module are not automatically applied to the system environment. To apply the
+changes made, start &konsole; and execute the
+following command.</para>
+
+<screen>
+<userinput><command>/etc/init.d/networking</command> restart</userinput>
+</screen>
+
+</chapter>
+
+<chapter id="installation">
+<title>Installation</title>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>You need &kde; 3.x and QT 3.x installed to use knetwork-conf. </para>
+<para>knetwork-conf can be used with the following platforms: </para>
+
+<itemizedlist>
+<listitem>
+<para>&kubuntu;</para>
+</listitem>
+<listitem>
+<para>Conectiva</para>
+</listitem>
+<listitem>
+<para>Debian</para>
+</listitem>
+<listitem>
+<para>Fedora Core</para>
+</listitem>
+<listitem>
+<para>FreeBSD</para>
+</listitem>
+<listitem>
+<para>Gentoo</para>
+</listitem>
+<listitem>
+<para>&Mandrake;</para>
+</listitem>
+<listitem>
+<para>PLD</para>
+</listitem>
+<listitem>
+<para>OpenNA</para>
+</listitem>
+<listitem>
+<para>&RedHat;</para>
+</listitem>
+<listitem>
+<para>&SuSE;</para>
+</listitem>
+</itemizedlist>
+</sect1>
+
+<sect1 id="how-to-obtain-knetwork-conf">
+<title>How to obtain knetwork-conf</title>
+
+<para>knetwork-conf's home page is at <ulink
+url="http://knetworkconf.sourceforge.net"
+>http://knetworkconf.sourceforge.net</ulink> where you at least can download
+source packages. </para>
+</sect1>
+
+<sect1 id="installing-binaries">
+<title>Installing binaries</title>
+
+<para>When using the binary distributions (most often rpm packages), it is
+enough to have the &kde; and QT binaries installed. </para> <para>Installing
+binaries is recommended for less experienced users.  Simply download the rpm
+packages. Install them from &konsole; using
+<application>RPM</application> as follows:</para>
+
+<para>
+<command>rpm -i knetwork-conf-versionnumber.rpm</command>
+</para>
+
+<para>Alternatively, use a graphical front end like
+                    <application>kpackage</application> or the installation
+                    tool of your distribution. </para>
+</sect1>
+
+<sect1 id="compilation-and-installation">
+<title>Compilation and Installation</title>
+
+<para>In this case, it is not enough to have the binaries of QT and &kde;
+installed; you also need the development packages which include libraries
+and other stuff. </para>
+
+<para>Recommended for advanced users only. Otherwise, compiling &knetworkconf;
+is not difficult.  The following commands should do it.</para>
+
+<screen>
+./configure --prefix=$(kde-config --prefix)
+make
+make install
+</screen>
+
+<note>
+<para>The command <command>make install</command> must be run as
+root.</para>
+</note>
+<para>That should do it. Should you run into any problems, please
+let us know.</para>
+</sect1>
+</chapter>
+
+<chapter id="system-engineering">
+<title>Technical Information</title> 
+
+<para>In the first section of this chapter, you'll find some valuable
+information about networking basics. In the second, all configuration files
+on your disk which can be changed by &knetworkconf; will be discussed. </para>
+
+<sect1 id="networking-overview">
+<title>IPv4 Networking</title>
+
+<para>This section cannot be a replacement for further lecture of
+IP-Networking. In this appendix, you'll only find the basic informations to
+get you started integrating your machine into a small (home)
+network. </para>
+
+<para>Currently, IP-networking is done using TCP/IP version 4 (IPv4). IPv5
+has never been used much. IPv6 is expected to get spread in the near
+future. So, this manual is based on the currently most spread IPv4. </para>
+
+<para>One of the most important informations for setting up an interface is
+the IP-address which you have to assign to the interface. In foreign
+networks, &eg; your office, you have to ask the network administrator to
+tell you a valid IP-address, or you can use DHCP if this is available. In
+any case, you are not allowed to simply choose any IP-address! </para>
+
+<para>If you want to set up a small (home) network of your own, you should
+use IP-addresses from a range which has especially reserved for this purpose
+to prevent IP-address-conflicts with the global (Internet) network. The
+addresses from the table shown below are not routed in the Internet, so it
+is save to use them as you like. </para>
+
+<para>Of course these machines can later be configured for Internet access
+by using a gateway machine. </para>
+
+<para>You can freely use the following addresses: </para>
+
+<table id="private-ip-addresses">
+<title>IP-Addresses for private networks</title>
+<tgroup cols="2" align="char">
+<thead>
+<row>
+<entry>Class</entry>
+<entry>Range</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>A</entry>
+<entry>10.0.0.0 to 10.255.255.255</entry>
+</row>
+<row>
+<entry>B</entry>
+<entry>172.16.0.0 to 172.31.0.0</entry>
+</row>
+<row>
+<entry>C</entry>
+<entry>192.168.0.0 to 192.168.255.0</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<para>For smaller networks, the most often used addresses are these in the
+range of 192.168.1.1 to 192.168.1.254. This is enough for networks up to
+over 250 computers. </para>
+
+<para>Furthermore, the netmask is most often set to 255.255.255.0, so that
+all of these machines are members of the same subnet. </para>
+
+<para>Some addresses are reserved for special things, &eg; 0.0.0.0 and
+127.0.0.1. The first one is the so called default route, the second the
+loopback address. The default route is needed by IP routing. </para>
+
+<para>The network 127.0.0.1 is reserved for the IP-traffic which works on
+the local machine only. Usually, the address 127.0.0.1 is assigned to a
+special device, the so called loopback interface, which works like a closed
+circle. </para> 
+
+<para>A default gateway is a computer which connects two different
+networks. If you have configured a small network of your own, it is most
+likely that you want all (or some) of your machines to grant Internet
+access. But this is not possible directly, because these machines use local
+private IP-addresses, which are not routed in the Internet. The solution is
+a computer which translates between the two different networks. This
+computer uses at least two interfaces. One of them, maybe an Ethernet card,
+points to the local network, the other one, maybe an ISDN card, points to
+the Internet. In this case, both interfaces use different IP-addresses. This
+computer performs a so called network address translation (NAT, aka
+IP-forwarding). To enable a local machine the Internet access, you have only
+to tell them the default gateway, the local IP-address of the
+gateway-computer. </para>
+
+</sect1>
+
+<sect1 id="list-of-configuration-files">
+<title>Configuration files</title>
+
+<para>In this section you'll find the configuration files which are touched
+by &knetworkconf; and where they reside in the file system of the different
+distributions. </para>
+
+<sect2 id="resolv.conf">
+<title>resolv.conf</title>
+<para>In this file, the list of name servers is stored. </para>
+<table id="resolv.conf-table">
+<title>Where to find resolv.conf</title>
+<tgroup cols="3">
+<thead>
+<row>
+<entry>Platform</entry>
+<entry>Release number</entry>
+<entry>Location</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>Conectiva</entry>
+<entry>9.2</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>Debian</entry>
+<entry>3.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>Fedora Core</entry>
+<entry>1</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>FreeBSD</entry>
+<entry>5</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>Gentoo</entry>
+<entry>2005.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>&Mandrake;</entry>
+<entry>9.2</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>PLD</entry>
+<entry>2.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>OpenNA</entry>
+<entry>1.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>&RedHat;</entry>
+<entry>9.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+<row>
+<entry>&SuSE;</entry>
+<entry>9.0</entry>
+<entry>/etc/resolv.conf</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<para>This file is sometimes dynamically changed by DSL-connections, so do
+not wonder if the file doesn't contain what you have put there when a DSL
+connection is established. </para>
+</sect2>
+
+<sect2 id="hosts">
+<title>hosts</title>
+<para>In this file, the list of known hosts is stored. </para>
+
+<table id="hosts-table">
+<title>Where to find the file hosts</title>
+<tgroup cols="3">
+<thead>
+<row>
+<entry>Distribution</entry>
+<entry>Releasenumber</entry>
+<entry>Location</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>Conectiva</entry>
+<entry>9.0</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>Debian</entry>
+<entry>3.0</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>Fedora Core</entry>
+<entry>1</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>FreeBSD</entry>
+<entry>5</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>Gentoo</entry>
+<entry>&nbsp;</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>&Mandrake;</entry>
+<entry>9.2</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>PLD</entry>
+<entry>2.0</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>OpenNA</entry>
+<entry>1</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>&RedHat;</entry>
+<entry>9.0</entry>
+<entry>/etc/hosts</entry>
+</row>
+<row>
+<entry>&SuSE;</entry>
+<entry>9.0</entry>
+<entry>/etc/hosts</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<para>On &SuSE; it is known that this file gets occasionally resorted by the
+script SuSEconfig. So do not wonder if you do not find in a state you have
+expected. </para>
+</sect2>
+</sect1>
+</chapter>
+
+<chapter id="credits-licence">
+<title>Credits and license</title>
+<sect1 id="credits">
+<title>Credits</title> 
+
+<para>Thanks to all who have worked on &kappname;:</para>
+
+<itemizedlist>
+<title>Developers</title>
+<listitem>
+<para>Juan Luis Baptiste
+<email>juan.baptiste@kdemail.net</email></para>
+</listitem>
+<listitem>
+<para>David Sansome <email>me@davidsansome.com</email></para>
+</listitem>
+<listitem>
+<para>Carlos Garnacho <email>garnacho@tuxerver.net</email></para>
+</listitem>
+<listitem>
+<para>Simon Edwards <email>simon@simonzone.com</email></para>
+</listitem>
+<listitem><para>Pedro Jurado Maquedo
+<email>pjmelenas@biwemail.com</email></para>
+</listitem>
+<listitem>
+<para>Florian Fernandez <email>florian.fernandez2@wanadoo.fr</email></para>
+</listitem>
+<listitem>
+<para>Unai Garro <email>Unai.Garro@ee.ed.ac.uk</email></para>
+</listitem>
+<listitem>
+<para>Christoph Eckert <email>mchristoph.eckert@t-online.de</email></para>
+</listitem>
+<listitem>
+<para>Jaime Torres <email>jtorres@telecorp.net</email></para>
+</listitem>
+<listitem>
+<para>All the others which I have forgotten to list here - you know who
+you are <email>you@foo.tld</email></para>
+</listitem>
+</itemizedlist>
+
+<itemizedlist>
+<title>Authors</title>
+<listitem>
+<para>Christoph Eckert:
+<email>mchristoph.eckert@t-online.de</email></para>
+</listitem>
+<listitem>
+<para>Sean Wheller: <email>sean@inwords.co.za</email></para>
+</listitem>
+</itemizedlist>
+</sect1>
+
+<sect1 id="licence">
+<title>License</title>
+
+<para>The Copyright on &kappname;, at least for the years 2003 and 2004, is
+owned by Juan Luis Baptiste:
+(<email>juan.baptiste@kdemail.net</email>). </para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+</sect1>
+</chapter>
+</book>
diff --git a/doc/kpackage/Makefile.am b/doc/kpackage/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kpackage/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kpackage/bsdloc.png b/doc/kpackage/bsdloc.png
new file mode 100644
index 0000000..b498b7f
--- /dev/null
+++ b/doc/kpackage/bsdloc.png
diff --git a/doc/kpackage/debaptloc.png b/doc/kpackage/debaptloc.png
new file mode 100644
index 0000000..965b2ef
--- /dev/null
+++ b/doc/kpackage/debaptloc.png
diff --git a/doc/kpackage/debloc.png b/doc/kpackage/debloc.png
new file mode 100644
index 0000000..bcc96d0
--- /dev/null
+++ b/doc/kpackage/debloc.png
diff --git a/doc/kpackage/handle.png b/doc/kpackage/handle.png
new file mode 100644
index 0000000..58caf2d
--- /dev/null
+++ b/doc/kpackage/handle.png
diff --git a/doc/kpackage/index.docbook b/doc/kpackage/index.docbook
new file mode 100644
index 0000000..2112411
--- /dev/null
+++ b/doc/kpackage/index.docbook
@@ -0,0 +1,1229 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
+"dtd/kdex.dtd" [
+  <!ENTITY kappname "&kpackage;">
+  <!ENTITY package "kdeadmin">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>The &kpackage; Handbook</title>
+<authorgroup>
+<author>
+<firstname>Toivo</firstname>
+<surname>Pedaste</surname>
+<affiliation>
+<address><email>toivo@ucs.uwa.edu.au</email></address>
+</affiliation>
+</author>
+
+<othercredit role="reviewer">
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+<affiliation>
+<address><email>lauri@kde.org</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2000</year>
+<holder>Toivo Pedaste</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2006-12-04</date>
+<releaseinfo>3.5.5</releaseinfo>
+
+<abstract><para>&kpackage; is a &GUI; interface to the
+<acronym>RPM</acronym>, Debian, Slackware and BSD package
+managers.</para></abstract>
+
+<keywordset>
+<keyword>kpackage</keyword>
+<keyword>package</keyword>
+<keyword>package manager</keyword>
+<keyword>RPM</keyword>
+<keyword>deb</keyword>
+</keywordset>
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>&kpackage; is a &GUI; interface to the <acronym>RPM</acronym>,
+Debian, Slackware and <acronym>BSD</acronym> package managers.  &kpackage; is part of the K Desktop
+Environment and, as a result, it is designed to integrate with the &kde;
+file manager. </para>
+
+</chapter>
+
+<chapter id="onscreen-fundamentals">
+
+<title>Onscreen Fundamentals</title>
+
+<para>&kpackage; has two panels. The left panel displays a tree of the
+installed and available packages, the right panel displays information
+on the packages.</para>
+
+
+<sect1 id="the-main-window-left">
+<title>The Main Window - Package Tree</title>
+
+<para>When &kpackage; is started normally (that is it has not been
+invoked via drag and drop and has not been given any parameters) it
+displays two panels with the package tree on the left, this tree shows
+installed packages and optionally new and updated packages as
+well.</para>
+
+<screenshot>
+<screeninfo>&kpackage; Left Panel</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="left.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Left Panel - Package Tree</phrase>
+</textobject>
+<caption>
+<para>Left Panel - Package Tree</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The left panel displays the list of packages, the tabs along
+the top determines which packages are displayed:</para>
+
+<itemizedlist>
+
+<listitem><para><guilabel>Installed</guilabel> - Show installed packages</para></listitem>
+
+<listitem><para><guilabel>Updated</guilabel> - Show packages for which newer versions are available</para></listitem>
+
+<listitem><para><guilabel>New</guilabel> - Show uninstalled packages</para></listitem>
+
+<listitem><para><guilabel>All</guilabel> - All packages</para></listitem>
+
+</itemizedlist>
+<para>Below the tabs is the <guilabel>Search</guilabel> line, this filters the package tree so that only those packages whose name or summary contains the search string are displayed.</para>
+
+<para>The package tree is based on the sections of the distribution
+and shows summary information about the packages:</para>
+<itemizedlist>
+
+<listitem><para><guilabel>Package</guilabel> - Name of the package</para></listitem>
+<listitem><para><guilabel>Mark</guilabel> - Shows a tick if the package has
+been marked. Marking allows multiple packages to be installed or
+uninstalled at once using the buttons located below the package tree.</para></listitem>
+<listitem><para><guilabel>Summary</guilabel>- A short description of the package.</para></listitem>
+<listitem><para><guilabel>Size</guilabel>- The package size</para></listitem>
+<listitem><para><guilabel>Version</guilabel> - The package version</para></listitem>
+<listitem><para><guilabel>Old Version</guilabel> - If the package updates an installed package, the
+version of the old package</para></listitem>
+
+</itemizedlist>
+
+<para>The packages have graphical labels to indicate their state, an
+image representing the package type means an installed package, a
+<guilabel>N</guilabel> indicates an available package and a <guilabel>U</guilabel>
+means a package that can upgrade an installed package.</para>
+
+<para>A single package is selected by clicking on the name. Clicking on
+the dot in the <guilabel>Mark</guilabel> column marks the package with a
+tick, a second click unmarks it, while <keycombo
+action="simul">&Shift;<mousebutton>left</mousebutton></keycombo> click
+can be used to mark a range of packages and <keycombo
+action="simul">&Ctrl;<mousebutton>left</mousebutton></keycombo> click
+can be used to add and remove marks on packages.</para>
+
+<para>Selecting a package from the tree displays information about it in
+the right panel.</para>
+
+</sect1>
+
+<sect1 id="package-information-panel">
+<title>The Main Window - Package Information Panel</title>
+
+<para>The right panel has tabs for displaying three different types of
+information about selected packages </para>
+
+<itemizedlist>
+<listitem>
+<screenshot>
+<screeninfo>&kpackage; Right Panel - Properties</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="right-prop.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Right Panel - Package Properties</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>Properties</guilabel> tab which displays
+information on the selected package. In the dependency information there are
+hyper-links to the packages listed, installed packages are in standard font,
+uninstalled but available packages are in italic and dependencies that aren't
+available are normal text.</para>
+</caption>
+</mediaobject>
+</screenshot>
+</listitem>
+
+<listitem>
+
+<screenshot>
+<screeninfo>&kpackage; Right Panel - Properties</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="right-files.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Right Panel - The Files in the Package</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>File List</guilabel> tab shows the files in the
+package and for installed packages (provided the information is
+available) shows the state of the
+files. Files that exist are marked with a tick, those that are
+missing are marked with a cross.</para>
+
+</caption>
+</mediaobject>
+</screenshot>
+
+</listitem>
+
+<listitem>
+<screenshot>
+<screeninfo>&kpackage; Right Panel - Properties</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="right-change.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Right Panel - The Files in the Package</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>Change Log</guilabel> tab shows the change log
+for the package.</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+</listitem>
+
+</itemizedlist>
+
+</sect1>
+
+<sect1 id="installing-packages">
+<title>Installing Packages</title>
+
+<para>To install a package you can</para>
+<itemizedlist>
+<listitem>
+<para>locate the package you wish to install in &konqueror;, drag it
+onto a running copy of &kpackage;</para>
+</listitem>
+<listitem>
+<para>click on a package file in &konqueror; and start a new copy of
+&kpackage;</para>
+</listitem>
+<listitem>
+<para>use on the <guimenu>Open</guimenu> menu items in
+&kpackage;</para>
+</listitem>
+<listitem>
+<para>selecting an available package in the package tree</para>
+</listitem>
+</itemizedlist>
+
+<para>For a selected package, use the buttons in the right panel, the
+<guibutton>Fetch</guibutton> button will fetch the package from a remote
+source and display detailed information, the
+<guibutton>Install</guibutton> button pops up the installation
+window. </para>
+
+<para>For marked packages, use the
+<guibutton>Install Marked</guibutton> button on the left panel,
+which pops up the install
+window.</para>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="install.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Install Dialog</phrase>
+</textobject>
+<caption>
+<para>Install Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The install window lists the packages to be selected to
+be installed in a panel in the top left, if Debian <acronym>APT</acronym>
+is being used the packages needed to satisfy any dependencies are
+also shown. Below this there are a set of check boxes which set options for
+the install program. For <acronym>RPM</acronym> packages the options
+are:</para>
+<itemizedlist>
+<listitem>
+<para><guilabel>Upgrade</guilabel> - Will upgrade any already
+installed package.</para>
+</listitem>
+<listitem>
+<para><guilabel>Replace Files</guilabel> - Install  the  packages  even
+if they replace files from other, already installed, packages.</para>
+</listitem>
+<listitem>
+<para><guilabel>Check Dependencies</guilabel> - Verify dependencies.</para>
+</listitem>
+<listitem>
+<para><guilabel>Test (do not install)</guilabel></para>
+</listitem>
+</itemizedlist>
+
+<para>For Debian <acronym>APT</acronym> the options are:</para>
+<itemizedlist>
+<listitem>
+<para><guilabel>Download only</guilabel> - Fetch the packages but
+don't install them.</para>
+</listitem>
+<listitem>
+<para><guilabel>No download</guilabel> - Only use packages that
+are locally available</para>
+</listitem>
+<listitem>
+<para><guilabel>Ignore missing</guilabel> - Do the install even if
+some packages are missing</para>
+</listitem>
+<listitem>
+<para><guilabel>Ignore hold</guilabel> - Ignore holds that have been
+placed on packages</para>
+</listitem>
+<listitem>
+<para><guilabel>Allow Unauthenticated</guilabel> - Ignore any requirements that
+the packages must be signed.</para>
+</listitem>
+<listitem>
+<para><guilabel>Assume yes</guilabel> - Answer yes for any questions
+the install program would ask.</para>
+</listitem>
+<listitem>
+<para><guilabel>Test (do not install)</guilabel></para>
+</listitem>
+</itemizedlist>
+
+<para>The <guibutton>Install</guibutton> button will start the
+actual install. Normally the install window will be deleted after
+a successful install but if the
+<guibutton>Keep this window</guibutton> check box is selected the
+window will stay around.</para>
+
+<para>The panel on the right is an integrated
+terminal window in which the installation programs are run, for
+interactive installation programs the interaction is done in this
+window. </para>
+
+</sect1>
+
+<sect1 id="uninstalling-packages">
+<title>Uninstalling Packages</title>
+
+<para>A selected package can be uninstalled by using the
+<guibutton>Uninstall</guibutton> button in the right panel, the
+<guibutton>Uninstall Marked</guibutton> in the right panel
+can be used to uninstall marked packages. The buttons bring
+up the uninstall window.</para>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="uninstall.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Uninstall Dialog</phrase>
+</textobject>
+<caption>
+<para>Uninstall Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The
+<guibutton>Uninstall</guibutton> button in the window causes the
+packages to be uninstalled, and the right panel provides an integrated
+terminal window for the uninstall program.</para>
+
+<para>For <acronym>RPM</acronym> packages the options
+are:</para>
+<itemizedlist>
+<listitem>
+<para><guilabel>Use scripts</guilabel> - Execute any unistall scripts</para>
+</listitem>
+<listitem>
+<para><guilabel>Check Dependencies</guilabel> - Verify dependencies.</para>
+</listitem>
+<listitem>
+<para><guilabel>Test (do not uninstall)</guilabel></para>
+</listitem>
+</itemizedlist>
+
+<para>For Debian <acronym>APT</acronym> the options are:</para>
+<itemizedlist>
+<listitem>
+<para><guilabel>Purge Config Files</guilabel> - Remove any package
+configuration files.</para>
+</listitem>
+<listitem>
+<para><guilabel>Assume yes</guilabel> - Answer yes for any questions
+the install program would ask.</para>
+</listitem>
+<listitem>
+<para><guilabel>Test (do not uninstall)</guilabel></para>
+</listitem>
+</itemizedlist>
+
+
+</sect1>
+
+<sect1 id="integrating-available-packages-in-the-tree">
+<title>Integrating available packages in the tree</title>
+
+<para>Access to available packages is setup in the menu with <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kpackage;...</guimenuitem></menuchoice>.
+</para>
+
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="handle.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Package Handler Panel</phrase>
+</textobject>
+<caption>
+<para>Package Handler Panel </para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The top part of the panel has the <guilabel>Remote Host</guilabel>
+box which allows &kpackage; to operate on the packages on a remote computer,
+this functionality requires <command>ssh</command> and is only available
+when using Debian apt. The name of the remote
+computer is entered into the combobox and &kpackage; will access
+it when the <guilabel>Use remote host</guilabel> checkbox is
+selected.</para>
+
+<para>The rest of the panel allows the enabling and disabling of
+the various package types that &kpackage; can handle. If a package
+type is enabled the <guibutton>Location of Packages</guibutton> button
+will bring up a dialog for setting the location of available packages.
+If the programs required for handling a package type is not available the package
+type will be automatically disabled.
+</para>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="rpmloc.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>RPM Location Dialog</phrase>
+</textobject>
+<caption>
+<para>RPM Location Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>For <acronym>RPM</acronym> packages &kpackage; can read a
+folder containing packages and add these to the package tree as
+either new or updated packages. It is possible to examine or install
+these packages from the package tree. By default the information about
+the packages is extracted from the standard format of the file names and
+so it is necessary to use the <guibutton>Examine</guibutton> button to
+see the full description, it is possible though to set an option so that
+for local folders each package file is read, this is slower but
+gives a full description.</para>
+
+<para>The <acronym>RPM</acronym> locations dialog allows the specification
+of folders containing <acronym>RPM</acronym> packages, it's divided
+up into a number of tabbed panels for convenience of management. Each
+line in the panel specifies a folder, the <guilabel>Use</guilabel>
+checkbox is selected the folder is used, otherwise it's ignored.
+The text entry field can take either a folder path or an <command>ftp</command>
+URL.  The <guilabel>Subfolders</guilabel> checkbox determines
+whether subfolders are searched for packages. The <guibutton>...</guibutton>
+button will pop up a folder selection dialog.</para>
+
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="debaptloc.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Debian Apt Location Dialog</phrase>
+</textobject>
+<caption>
+<para>Debian Apt Location Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para><guilabel>APT: Debian</guilabel> means that Debian packages
+are handled using the <command>deb-apt</command> command which
+can automatically fetch packages from repositories and
+resolve dependencies.</para>
+
+<para>The location of
+uninstalled package repositories can be set in the "A" panel, this is
+used to write the <filename>/etc/apt/sources.list</filename> file
+which controls where <command>deb-apt</command> searches for packages,
+each entry corresponds to a line in the file, if the
+<guilabel>Use</guilabel> checkbox is not set the line is commented
+out.</para>
+
+<para>The "D" panel allows the specification of folders containing
+Debian packages.</para>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="debloc.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Debian DPKG Location Dialog: L and P panels</phrase>
+</textobject>
+<caption>
+<para>Debian DPKG Location Dialog: L and P panels</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+
+<para>DPKG: Debian means that packages are handled using <command>dpkg</command>
+command, there are three ways of accessing available packages, these can be
+selected in three different types of location setting panels. </para>
+
+<itemizedlist>
+<listitem>
+<para>The "I" panel specifies the location of the Debian package tree
+and selects the
+distribution and architecture. &kpackage; will look in the standard
+places for the Package files describing the available packages and these
+packages are then added to the package tree and can be examined or
+installed</para>
+</listitem> 
+<listitem>
+<para>The "P" panel specifies the location of the Debian distribution along with the
+<filename>Packages</filename> files for the parts of the distribution that are of
+interest. If the <command>dselect</command> program is being
+used then the file <filename>/var/lib/dpkg/available</filename> can be
+used as a <filename>Packages</filename> file that describes the distribution that
+<command>dselect</command> uses.</para>
+</listitem>
+<listitem><para>The "D" panel specifies folders that are handled in the same way as with
+<acronym>RPM</acronym> packages.</para></listitem>
+</itemizedlist>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="slackloc.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Slackware Location Dialog</phrase>
+</textobject>
+<caption>
+<para>Slackware Location Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>For Slackware packages there is very little information stored on
+installed packages, but it is possible to use a
+<filename>PACKAGE.TXT</filename> file as a source of information about
+the installed packages. The <filename>PACKAGES.TXT</filename> file is
+the equivalent of a Debian Packages file and Slackware distributions are
+structured with a folder tree containing the <literal
+role="extension">.tgz</literal> packages and a
+<filename>PACKAGES.TXT</filename> file that describes the
+packages.</para>
+
+<para>As with Debian distributions the packages in a Slackware
+distribution can be integrated into the package tree. Unfortunately the
+Slackware packages don't carry version information so it is not possible
+to tell with available packages are newer than installed ones.</para>
+
+<itemizedlist>
+<listitem><para>The "I" panel is the location of a
+<filename>PACKAGES.TXT</filename> file which is used to provided information on
+the installed packages</para></listitem>
+<listitem><para>The "P" panels can be used to specify the location of
+distributions with the folder tree containing the <literal
+role="extension">.tgz</literal> files and the location of the corresponding
+<filename>PACKAGES.TXT</filename> file</para></listitem>
+<listitem><para>The "D" panels are for folders that do
+<emphasis>not</emphasis> have a corresponding <filename>PACKAGES.TXT</filename>
+fi
+le</para></listitem>
+</itemizedlist>
+
+<screenshot>
+<screeninfo>&kpackage; Install dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="bsdloc.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>BSD Location Dialog</phrase>
+</textobject>
+<caption>
+<para>BSD Location Dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>For <acronym>BSD</acronym> packages &kpackage; will understand a
+packages distribution folder that contains an
+<filename>INDEX</filename> file (which describes all the packages) and
+also contains an <filename>All</filename> folder (with all the
+package files in it). </para>
+
+<para>The "Ports" panel gives the location of the ports tree in
+the file system </para>
+<para>The "Packages" panel allows the specifying the location of packages
+folders &ie; those containing <filename>INDEX</filename>
+files</para>
+
+<para>For remote folders and package files (&ie; those fetched via
+&FTP;) &kpackage; will do caching, the packages are by default cached in
+<filename>~/.kpackage</filename> and the folders in
+<filename>~/.kpackage/dir</filename>.</para>
+
+<note><para>For the handling of remote (&FTP;) folders to work, it
+may be necessary to not have the <guilabel>FTP Proxy</guilabel> set in the
+Browser Settings.</para></note>
+
+</sect1>
+
+<sect1 id="Searching">
+<title>Searching</title>
+<sect2>
+<title>Package Search Line</title>
+
+<screenshot>
+  <screeninfo>&kpackage; Search Line</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="searchl.png" format="PNG"/> </imageobject>
+    <textobject>
+      <phrase>Search Line</phrase>
+    </textobject>
+    <caption>
+      <para>Search Line</para>
+    </caption>
+  </mediaobject>
+</screenshot>
+
+<para>The Search line filters the package tree so that only those packages whose name or summary contains the search string are displayed.</para>
+</sect2>
+
+
+<sect2>
+  <title>Find Package</title>
+  
+  <screenshot>
+    <screeninfo>&kpackage; Find Package</screeninfo>
+    <mediaobject>
+      <imageobject>
+	<imagedata fileref="search.png" format="PNG"/> </imageobject>
+      <textobject>
+	<phrase>Find Package</phrase>
+      </textobject>
+      <caption>
+	<para>Find Package</para>
+	</caption>
+      </mediaobject>
+    </screenshot>
+    
+    <para>The <guilabel>Find Package</guilabel> dialog searches the names 
+    of the packages in the package tree and moves to the next matching package.
+    If <guilabel>Sub string</guilabel> is not set then it will find only exact 
+    matches against packages names. If <guilabel>Wrap search</guilabel> is not
+    set the search doesn't wrap around the end of the package tree.
+  </para>
+</sect2>
+
+<sect2>
+  <title>Find File</title>
+  
+  <screenshot>
+    <screeninfo>&kpackage; Find File</screeninfo>
+    <mediaobject>
+      <imageobject>
+	<imagedata fileref="searchf.png" format="PNG"/> </imageobject>
+      <textobject>
+	<phrase>Find File</phrase>
+      </textobject>
+      <caption>
+	<para>Find File</para>
+      </caption>
+    </mediaobject>
+  </screenshot>
+  
+  <para>The <guilabel>Find File</guilabel> dialog searches for files the names of 
+    which contain the search string. 
+    The columns in the display are:</para>
+    <itemizedlist>
+      <listitem>
+	<para><guilabel>Installed</guilabel> - Ticked if it is an installed package.</para>
+      </listitem>
+      <listitem>
+	<para><guilabel>Type</guilabel> - The type of the package.</para>
+      </listitem>
+      <listitem>
+	<para><guilabel>Package</guilabel> - The name of the package</para>
+      </listitem>
+      <listitem>
+	<para><guilabel>File Name</guilabel> - The name of the matched file</para>
+      </listitem>
+    </itemizedlist>
+    <para>Only the files in installed packages are shown unless <guilabel>Also search uninstalled packages</guilabel> is set, this will only work with Debian APT
+      packages and only if the <command>apt-file</command> command is installed.
+      The database used by the <command>apt-file</command> command is updated
+      by the <guimenuitem>Apt-File Update</guimenuitem> menu item.
+    </para>
+
+</sect2>
+
+
+</sect1>
+
+<sect1 id="Misc">
+  <title>Misc</title>
+  <sect2>
+    <title>Root Access</title>
+
+    <para>&kpackage; requires <systemitem class="username">root</systemitem>
+      access for installing/uninstalling packages, this can be can be done by
+      running &kpackage; as <systemitem class="username">root</systemitem>,
+      say by using &kdesu;.</para>
+
+    <para>Alternatively, if &kpackage; is running as a normal user it will
+      try to run the install/uninstall programs as root by logging in to a
+      pseudo terminal, it will use either <command>su</command>, <command>sudo</command> or
+      <command>ssh</command> to do this and if needed it will pop up a
+      prompt window where the <systemitem class="username">root</systemitem>
+      password or <command>ssh</command> key can be typed. For this to work the root prompt has to end in
+      <prompt># </prompt>. The <guimenuitem>Keep password</guimenuitem> option causes &kpackage; to
+      remember the password that is entered. </para>
+  <screenshot>
+    <screeninfo>&kpackage; Password prompt</screeninfo>
+    <mediaobject>
+      <imageobject>
+	<imagedata fileref="root-prompt.png" format="PNG"/> </imageobject>
+      <textobject>
+	<phrase>Password prompt</phrase>
+      </textobject>
+      <caption>
+	<para>Password prompt</para>
+      </caption>
+    </mediaobject>
+  </screenshot>
+
+  </sect2>
+
+
+  <sect2>
+    <title>Drag and Drop</title>
+
+    <para>&kpackage; makes use of the &kde; Drag and Drop protocol. This
+      means that you can drag and drop packages onto &kpackage; to open
+      them. Dropping a file onto the <guilabel>Find File</guilabel> dialog
+      will find the package that contains the file.</para>
+
+  </sect2>
+</sect1>
+
+</chapter>
+<chapter id="menus">
+
+<title>Menus</title>
+
+<para>This describes the &kpackage; menus. </para>
+
+<sect1 id="file-menu">
+<title><guimenu>File</guimenu> menu</title>
+
+<para>The items in the <guimenu>File</guimenu> menu are:</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>O</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Open...</guimenuitem></menuchoice></term>
+<listitem><para>Brings up file selector for local and &FTP;
+files</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>File</guimenu>
+<guisubmenu>Open Recent</guisubmenu></menuchoice></term>
+<listitem><para>A list of the most recently open package files</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>F</keycap></keycombo></shortcut>
+<guimenu>File</guimenu><guimenuitem>Find
+Package...</guimenuitem></menuchoice></term>
+<listitem><para>Search the installed package list for a package, the name
+of which contains the entered string </para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>File</guimenu>
+<guimenuitem>Find File...</guimenuitem></menuchoice></term>
+<listitem><para>Produces a list of packages that contain the entered
+file name, selecting a line will display the information on that
+package. It behaves slightly differently for <acronym>RPM</acronym>
+(where you have to enter the exact file name) and <abbrev>DEB</abbrev>
+(where you can enter a regular expression).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Reload</guimenuitem></menuchoice></term>
+<listitem><para>Reread the package data and rebuild the package
+tree</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>Quit &kpackage; </para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="packages-menu">
+<title><guimenu>Packages</guimenu> menu</title>
+
+<para>The items in the <guimenu>Packages</guimenu> menu are:</para>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice><shortcut>
+<keycombo action="simul">&Alt;<keycap>Left</keycap>
+</keycombo></shortcut>
+<guimenu>Packages</guimenu>
+<guimenuitem>Back</guimenuitem></menuchoice></term>
+<listitem><para>Back button for navigation using the links in
+<guilabel>Properties</guilabel> entries in the right panel.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Alt;<keycap>Right</keycap>
+</keycombo></shortcut>
+<guimenu>Packages</guimenu>
+<guimenuitem>Forward</guimenuitem></menuchoice></term>
+<listitem><para>Forward button for navigation using the links in
+<guilabel>Properties</guilabel> entries in the right panel.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Packages</guimenu>
+<guimenuitem>Expand Tree</guimenuitem></menuchoice></term>
+<listitem><para>Fully expands the packages tree</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Packages</guimenu>
+<guimenuitem>Collapse Tree</guimenuitem> </menuchoice></term>
+<listitem><para>Collapses the package tree so that only the tree structure is
+shown</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Packages</guimenu>
+<guimenuitem>Clear Marked</guimenuitem> </menuchoice></term>
+<listitem><para>Unmarks all packages</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Packages</guimenu>
+<guimenuitem>Mark All</guimenuitem> </menuchoice></term>
+<listitem><para>Marks all packages that are members of the selected view</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Package</guimenu>
+<guimenuitem>Install</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>Install the currently selected package</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Package</guimenu>
+<guimenuitem>Install Marked</guimenuitem></menuchoice></term>
+<listitem>
+<para>Install all marked packages</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Package</guimenu>
+<guimenuitem>Uninstall</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>Uninstall the currently selected package</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Package</guimenu>
+<guimenuitem>Uninstall Marked</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>Uninstall all marked packages</para>
+</listitem>
+</varlistentry>
+
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="cache-menu">
+<title><guimenu>Cache</guimenu> menu</title>
+
+<para>The items in the <guimenu>Cache</guimenu> menu are: </para>
+<variablelist>
+<varlistentry>
+<term><menuchoice><guimenu>Cache</guimenu> <guimenuitem>Clear
+Package Folder Cache</guimenuitem></menuchoice></term>
+<listitem><para>Delete cached copies of remote package folders and Packages
+files</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Cache</guimenu><guimenuitem>Clear Package
+Cache</guimenuitem>
+</menuchoice></term>
+<listitem><para>Delete cached copies of remote package files that have been
+fetched</para> </listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="special-menu">
+<title><guimenu>Special</guimenu> menu</title>
+
+<para>The <guimenu>Special</guimenu> contains actions
+related to specific package types:</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Special</guimenu><guimenuitem>
+APT: Debian</guimenuitem>
+</menuchoice></term>
+<listitem>
+
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Update</guilabel></term>
+<listitem><para>Update <command>apt</command> indexes from package
+repositories.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Upgrade</guilabel></term>
+<listitem><para>Upgrade the Debian installation to the latest versions
+of all the packages.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Fixup</guilabel></term>
+<listitem><para><command>apt</command> is extremely strict about
+dependencies, attempt to fixup dependency problems</para></listitem>
+</varlistentry>
+
+<varlistentry>
+  <term><guilabel>Apt-File Update</guilabel></term>
+  <listitem><para>Searching for uninstall files uses the <command>apt-file</command> command, this updates the database that <command>apt-file</command> uses.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</listitem>
+
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="settings-menu">
+<title><guimenu>Settings</guimenu> menu</title>
+
+<para>The items in the <guimenu>Settings</guimenu> menu are:</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Show
+Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggle displaying the toolbar</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Save
+Settings</guimenuitem></menuchoice></term>
+<listitem><para>Save options immediately</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Configure
+Shortcuts...</guimenuitem></menuchoice></term>
+<listitem><para>The standard &kde; dialog for setting shortcut
+keys</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu><guimenuitem>Configure
+Toolbars...</guimenuitem></menuchoice></term>
+<listitem><para>The standard &kde; dialog for configuring tool
+bars</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kpackage;...</guimenuitem></menuchoice></term>
+<listitem>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Types</guilabel></term>
+<listitem><para>Which package types to handle, Debian using DPKG and
+Debian using APT are listed separately, it is not a good idea to
+enable both at the same time. It also sets whether to access
+a remote host for Debian apt.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Cache</guilabel></term>
+<listitem><para>Controls caching of remote (&FTP;ed)  folders and Package
+files.</para>
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Cache Remote Package Folders</guilabel></term>
+<listitem><para>Whether to cache remote (&FTP;ed)  folders and Package
+files.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Cache Remote Package Files</guilabel></term>
+<listitem><para>Whether to cache remote package files that have been fetched
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Cache Folder</guilabel></term>
+<listitem><para>Where to cache package files and folders
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>misc</guilabel></term>
+<listitem>
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Execute Privileged Commands Using</guilabel></term>
+<listitem><para>Use <command>su</command>, <command>sudo</command> or
+<command>ssh</command> for running privileged commands. For remote Debian APT <command>ssh</command>
+is always used.</para> </listitem> 
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Verify file list</guilabel></term>
+<listitem><para>If set the list of files in the package is checked to see if
+they are actually installed</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Read information from all local package files</guilabel></term>
+<listitem><para>If set all the files from a (local) package folder are read
+instead of just using the files names, this is slower but shows more
+information.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+
+
+</variablelist>
+</sect1>
+
+<sect1 id="help-menu">
+<title><guimenu>Help</guimenu> menu</title>
+
+<para>The items in the <guimenu>Help</guimenu> menu are: </para>
+
+&help.menu.documentation;
+
+</sect1>
+
+<sect1 id="toolbar">
+<title>Toolbar</title>
+
+<itemizedlist>
+<listitem><para><guiicon>Open</guiicon></para></listitem>
+<listitem><para><guiicon>Back</guiicon></para></listitem>
+<listitem><para><guiicon>Forward</guiicon></para></listitem>
+<listitem><para><guiicon>Expand Tree</guiicon></para></listitem>
+<listitem><para><guiicon>Collapse Tree</guiicon></para></listitem>
+<listitem><para><guiicon>Find Package</guiicon></para></listitem>
+<listitem><para><guiicon>Find File</guiicon></para></listitem>
+<listitem><para><guiicon>Reload</guiicon></para></listitem>
+</itemizedlist>
+</sect1>
+</chapter>
+
+<chapter id="credits-and-licenses">
+<title>Credits and Licenses</title>
+
+<para>
+&kpackage;
+</para>
+
+<para>Documentation copyright 2005 Toivo Pedaste
+<email>toivo@ucs.uwa.edu.au</email></para>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="how-to-obtain-kpackage">
+<title>How to obtain &kpackage;</title>
+
+&install.intro.documentation;
+
+<para>For information on how to obtain and compile it see <ulink
+url="http://www.kde.org/install-source.html">
+http://www.kde.org/install-source.html</ulink></para>
+
+<para>There is more information on compilation at <ulink
+url="http://www.kde.org/compilationfaq.html">
+http://www.kde.org/compilationfaq.html</ulink></para>
+
+<para>There is a web page at <ulink
+url="http://www.general.uwa.edu.au/u/toivo/kpackage">
+http://www.general.uwa.edu.au/u/toivo/kpackage</ulink></para>
+
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>For installing &kpackage; you need:</para>
+
+<itemizedlist>
+<listitem><para>&Qt; 3 and &kde; 3</para></listitem>
+</itemizedlist>
+
+<para>For listing Debian packages no other software is needed but to
+install and uninstall the packages you need:</para>
+
+<itemizedlist>
+<listitem><para>the <command>dpkg</command> package
+manager or</para></listitem>
+
+<listitem><para> <command>apt-get</command> and
+<command>apt-cache</command></para></listitem>
+</itemizedlist>
+
+<para>For <acronym>BSD</acronym> packages you need the package
+management programs: </para>
+
+<itemizedlist>
+<listitem><para><command>pkg_info</command></para></listitem>
+<listitem><para><command>pkg_add</command></para></listitem>
+<listitem><para><command>pkg_delete</command></para></listitem>
+</itemizedlist>
+
+<para>For Slackware packages  you need: </para>
+
+<itemizedlist>
+<listitem><para><command>installpkg</command> </para></listitem>
+<listitem><para><command>removepkg</command></para></listitem>
+</itemizedlist>
+
+<para>For dealing with Redhat packages you need:</para>
+
+<itemizedlist>
+
+<listitem><para><command>rpm</command> </para></listitem>
+</itemizedlist>
+
+<para>For &kpackage; to work correctly with <acronym>RPM</acronym>
+packages the <acronym>RPM</acronym> database must be initialized. If
+typing <userinput><command>rpm</command>
+<option>-qa</option></userinput> gives an error about
+<computeroutput>unable to open....</computeroutput> then try
+<userinput><command>rpm</command>
+<option>--rebuilddb</option></userinput>.</para>
+
+</sect1>
+
+</appendix>
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/doc/kpackage/install.png b/doc/kpackage/install.png
new file mode 100644
index 0000000..958dc44
--- /dev/null
+++ b/doc/kpackage/install.png
diff --git a/doc/kpackage/left.png b/doc/kpackage/left.png
new file mode 100644
index 0000000..ad665c2
--- /dev/null
+++ b/doc/kpackage/left.png
diff --git a/doc/kpackage/right-change.png b/doc/kpackage/right-change.png
new file mode 100644
index 0000000..303dd62
--- /dev/null
+++ b/doc/kpackage/right-change.png
diff --git a/doc/kpackage/right-files.png b/doc/kpackage/right-files.png
new file mode 100644
index 0000000..e986caf
--- /dev/null
+++ b/doc/kpackage/right-files.png
diff --git a/doc/kpackage/right-prop.png b/doc/kpackage/right-prop.png
new file mode 100644
index 0000000..94b01de
--- /dev/null
+++ b/doc/kpackage/right-prop.png
diff --git a/doc/kpackage/root-prompt.png b/doc/kpackage/root-prompt.png
new file mode 100644
index 0000000..b954963
--- /dev/null
+++ b/doc/kpackage/root-prompt.png
diff --git a/doc/kpackage/rpmloc.png b/doc/kpackage/rpmloc.png
new file mode 100644
index 0000000..52b03b1
--- /dev/null
+++ b/doc/kpackage/rpmloc.png
diff --git a/doc/kpackage/search.png b/doc/kpackage/search.png
new file mode 100644
index 0000000..4d77cc1
--- /dev/null
+++ b/doc/kpackage/search.png
diff --git a/doc/kpackage/searchf.png b/doc/kpackage/searchf.png
new file mode 100644
index 0000000..135f89b
--- /dev/null
+++ b/doc/kpackage/searchf.png
diff --git a/doc/kpackage/searchl.png b/doc/kpackage/searchl.png
new file mode 100644
index 0000000..fc47d07
--- /dev/null
+++ b/doc/kpackage/searchl.png
diff --git a/doc/kpackage/slackloc.png b/doc/kpackage/slackloc.png
new file mode 100644
index 0000000..210cf6b
--- /dev/null
+++ b/doc/kpackage/slackloc.png
diff --git a/doc/kpackage/uninstall.png b/doc/kpackage/uninstall.png
new file mode 100644
index 0000000..b30ed5c
--- /dev/null
+++ b/doc/kpackage/uninstall.png
diff --git a/doc/ksysv/Makefile.am b/doc/ksysv/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/ksysv/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/ksysv/index.docbook b/doc/ksysv/index.docbook
new file mode 100644
index 0000000..9dc4f54
--- /dev/null
+++ b/doc/ksysv/index.docbook
@@ -0,0 +1,1117 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
+"dtd/kdex.dtd" [
+  <!ENTITY kappname "&ksysv;">
+  <!ENTITY package "kdeadmin">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>The &ksysv; Handbook</title>
+<authorgroup>
+<author>
+<firstname>Peter</firstname>
+<surname>Putzer</surname>
+<affiliation>
+<address><email>putzer@kde.org</email></address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2001-03-21</date>
+<releaseinfo>1.03.06</releaseinfo>
+
+<copyright>
+<year>1998</year>
+<year>2000</year>
+<year>2001</year>
+<holder>Peter Putzer</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<abstract>
+<para>&ksysv; is a graphical editor for the SysV style init
+configuration.</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KSysV</keyword>
+<keyword>Runlevel</keyword>
+<keyword>Runlevel editor</keyword>
+<keyword>System V init</keyword>
+</keywordset>
+</bookinfo>
+
+<chapter id="Introduction">
+<title>Introduction</title>
+
+<para>
+Welcome to the &kde; System V Init Editor, commonly known (and hereafter
+referenced) as &ksysv;. This section introduces a few concepts and explains what
+you can do with &ksysv;.
+</para>
+
+</chapter>
+
+<chapter id="what-is-sysv-init">
+<title>A Brief Description of System V Init</title>
+
+<para>
+The following explanation is <quote>borrowed</quote> from
+<application>tksysv</application> (an inspiration for &ksysv;):
+</para>
+
+<para>
+System V init is fast becoming the standard in the &Linux; world to
+control the startup of software at boot time. This is because it is
+arguably easier to use and more powerful and flexible than the
+traditional <acronym>BSD</acronym> init.
+</para>
+
+<para>
+I won't go into the history here (mainly because I don't know it :-).
+</para>
+
+<para>
+The init binary is located in <filename class="directory">/sbin</filename> and
+not <filename class="directory">/etc</filename>. This is important as one might
+try and upgrade a machine to System V init without re-installing and
+reformatting. The &Linux; kernel looks in <filename
+class="directory">/etc</filename> for its init first, so you must make sure and
+delete your old init from there if any.
+</para>
+
+<para>SysV init also differs from <acronym>BSD</acronym> init in that
+the config files are in a subfolder of <filename
+class="directory">/etc</filename> instead of residing directly in
+<filename class="directory">/etc</filename>. This folder is called
+<filename class="directory">rc.d</filename>. In there you will find
+<filename>rc.sysinit</filename> and the following folders:
+</para>
+
+<itemizedlist>
+<listitem>
+<para>
+<filename class="directory">init.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc0.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc1.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc2.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc3.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc4.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc5.d/</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+<filename class="directory">rc6.d</filename>
+</para>
+</listitem>
+</itemizedlist>
+
+<para>
+<filename class="directory">init.d</filename> contains a bunch of
+scripts. Basically, you need one script for each service you may need to
+start at boot time or when entering another runlevel. Services include
+things like networking, <acronym>NFS</acronym>, &Sendmail;, httpd,&etc;
+Services do not include things like <command>setserial</command> that
+must only be run once and then exited.  Things like that should go in
+the file <filename>rc.local</filename>.
+</para>
+
+<para>
+<filename>rc.local</filename> should be in <filename
+class="directory">/etc/rc.d</filename> if you want one. Most systems
+include one even though it doesn't do much. You can also include an
+<filename>rc.serial</filename> in <filename
+class="directory">/etc/rc.d</filename> if you need to do serial port
+specific things at boot time.
+</para>
+
+<para>The chain of events is as follows: </para>
+
+<orderedlist>
+<listitem>
+<para>
+The kernel looks in several places for init and runs the first one it
+finds.
+</para> 
+</listitem>
+<listitem>
+<para>
+init runs <filename>/etc/rc.d/rc.sysinit</filename>.
+</para>
+</listitem>
+<listitem>
+<para>
+<filename>rc.sysinit</filename> does a bunch of necessary things and then runs
+<filename>rc.serial</filename> (if it exists)
+</para>
+</listitem>
+<listitem>
+<para>
+init runs <filename>rc.local</filename>
+</para>
+</listitem>
+<listitem>
+<para>
+init runs all the scripts for the default runlevel
+</para>
+</listitem>
+</orderedlist>
+
+
+<para>
+The default runlevel is decided in
+<filename>/etc/inittab</filename>. You should have a line close to the
+top like:
+</para>
+
+<screen>id:3:initdefault:</screen>
+
+<para>
+From this, you'd look in the second column and see that the default
+runlevel is 3, as should be the case for most systems. If you want to
+change it, you can edit <filename>/etc/inittab</filename> by hand and
+change the 3. Be very careful when you are messing with the inittab. If
+you do mess up, you can get in to fix it by rebooting and doing:
+</para>
+
+<screen><computeroutput>LILO boot:</computeroutput> <userinput>linux single</userinput></screen>
+
+<para>
+This <emphasis>should</emphasis> allow you to boot into single user mode
+so you can fix it.  </para>
+
+<para>
+Now, how does it run all the right scripts? If you do an
+<userinput><command>ls</command> <option>-l</option></userinput> on
+<filename class="directory">rc3.d</filename>, you might see something
+like:
+</para>
+
+
+<screen>lrwxrwxrwx 1 root root 13 13:11 S10network -&gt; ../init.d/network 
+lrwxrwxrwx 1 root root 16 13:11 S30syslog -&gt; ../init.d/syslog 
+lrwxrwxrwx 1 root root 14 13:32 S40cron -&gt; ../init.d/cron
+lrwxrwxrwx 1 root root 14 13:11 S50inet -&gt; ../init.d/inet
+lrwxrwxrwx 1 root root 13 13:11 S60nfs -&gt; ../init.d/nfs
+lrwxrwxrwx 1 root root 15 13:11 S70nfsfs -&gt; ../init.d/nfsfs
+lrwxrwxrwx 1 root root 18 13:11 S75keytable -&gt; ../init.d/keytable
+lrwxrwxrwx 1 root root 23 13:11 S80sendmail -&gt; ../init.d/sendmail.init
+lrwxrwxrwx 1 root root 18 13:11 S90lpd -&gt; ../init.d/lpd.init
+lrwxrwxrwx 1 root root 11 13:11 S99local -&gt; ../rc.local</screen>
+
+<para>
+What you'll notice is that there are no real files in the folder.
+Everything there is a link to one of the scripts in the <filename
+class="directory">init.d</filename> folder.
+</para>
+
+<para>
+The links also have an <literal>S</literal> and a number at the
+beginning. The <literal>S</literal> means to start this particular
+script and a <literal>K</literal> would mean to stop it. The number is
+just there for ordering purposes. Init will start all the services based
+on the order they appear. You can duplicate numbers, but it will only
+confuse you somewhat. You just need to use a two digit number only,
+along with an upper case <literal>S</literal> or <literal>K</literal> to
+start or stop the services you need to.
+</para>
+
+<para>
+How does it start and stop services? Simple. Each of the scripts is
+written to accept an argument which can be <option>start</option> and
+<option>stop</option>. You can execute those scripts by hand in fact
+with a command like:
+</para>
+
+<screen><userinput><command>/etc/rc.d/init.d/httpd.init</command> <option>stop</option></userinput></screen>
+
+<para>
+To stop the httpd server. Init just reads the name and if it has a
+<literal>K</literal>, it calls the script with the <option>stop</option>
+argument. If it has an <option>S</option> it calls the script with a
+<option>start</option> argument.  </para>
+
+
+<sect1 id="why-all-the-runlevels">
+<title>Why All These Runlevels ?</title>
+
+<para>
+Some people want an easy way to setup machines to be multi-purpose. I
+could have a <quote>server</quote> runlevel that just runs httpd,
+sendmail, networking, &etc; Then I could have a <quote>user</quote>
+runlevel that runs <application>kdm</application>, networking, &etc;
+</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="onscreen-fundamentals">
+<title>Onscreen Fundamentals</title>
+
+<para>
+Here you learn how to use &ksysv;, which shouldn't be hard since it was
+designed to be as user-friendly as possible.
+</para>
+
+<sect1 id="mouse">
+<title>Mouse</title>
+
+<para>
+Using &ksysv; with a mouse or other pointing device is easy: just drag
+an entry from the <guilabel> Available Services</guilabel> area onto one
+of the six runlevels to start (or resp. stop) it in that runlevel.
+</para>
+
+<para>
+You can also move scripts between runlevels, or change the position in a
+given runlevel, by dragging it around. Doing so removes the entry from
+its original runlevel (or position). This doesn't happen when you drag
+an entry from the <guilabel>Available Services</guilabel> area.
+</para>
+
+<note>
+<para>
+Entries are moved when you drag them to a new area. To copy a service to
+a different runlevel, you have to select <guimenuitem>Copy</guimenuitem>
+from the <guimenu>Edit</guimenu> or context menu and
+<guimenuitem>Paste</guimenuitem> it in the target runlevel.
+</para>
+</note>
+
+<para>
+The <quote>sorting number</quote> of an entry sometimes cannot be
+calculated.  In such a case you have to edit the sorting numbers of
+surrounding entries before re-trying to insert the service.
+</para>
+
+<note>
+<para>
+Sorting numbers can range from 00 to 99, but no higher.
+</para>
+</note>
+
+<para>
+You can delete entries by dragging them onto the <guiicon>Trash
+Can</guiicon> area (symbolized by an icon depicting a garbage bin).
+</para>
+
+<warning>
+<para>
+Currently there is <emphasis>no</emphasis> way to recover items dragged
+onto the <guiicon>Trash Can</guiicon>, so be careful!
+</para>
+</warning>
+
+</sect1>
+
+<sect1 id="keyboard">
+<title>Keyboard</title>
+
+<para>
+You can use the <keycap>Tab</keycap> key to switch focus between
+different panels (<guilabel>Available Services</guilabel>,
+<guilabel>Runlevel 1 Start</guilabel>, <guilabel>Runlevel 1
+Stop</guilabel>, &etc;) and the cursor keys to move the selection up and
+down.
+</para>
+
+<para>
+To move an entry to a different runlevel, <guimenuitem>Cut</guimenuitem>
+it to the clipboard (using <keycombo action="simul">&Ctrl;
+<keycap>X</keycap></keycombo> and <guimenuitem>Paste</guimenuitem> it in
+the target runlevel (with <keycombo action="simul">&Ctrl;
+<keycap>V</keycap></keycombo>).
+</para>
+
+<para>
+To manually change an entries sorting number or name, press
+<keycap>Enter</keycap> to open the properties dialog. Use the
+<keycap>Tab</keycap> key to switch between different fields. Close the
+dialog by pressing <keycap>Enter</keycap> to accept the modifications,
+or press <keycap>Esc</keycap> to cancel any changes.
+</para>
+
+</sect1>
+
+<sect1 id="the-menu-entries">
+<title>The Menu Entries</title>
+
+<para>
+A one by one description of &ksysv;'s menu.
+</para>
+
+<sect2>
+<title>The <guimenu>File</guimenu> menu</title>
+
+<para>
+Because of the danger of data loss, all menu entries under
+<guimenu>File</guimenu> ask for confirmation before doing their work.
+</para>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Revert Configuration...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Forget any changes you have made, and revert to the last saved configuration.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Open...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Open a previously saved configuration.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save Configuration</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Make your changes permanent.</action>  Saving does not generate any
+backup files, so use with care.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save As...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Save a copy of your new configuration.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>L</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save Log...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Save a log</action> <!-- FIXME: find out what the log is of.  Assume -->
+<!-- changes made, but best check -->
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>P</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Print Log...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Print a copy of the log.</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>Quit</action> &ksysv;.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Edit</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Undo</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Undo the last unsaved change made.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>Shift</keycap>
+<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Redo</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Redo the last item undone.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>X</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Cut the currently selected service to the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Copy the selected entry to the clipboard, without removing it from its
+original position.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Paste the content of the clipboard at the current cursor
+position.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Properties</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Open the properties dialog for the selected item.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Tools</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Start Service...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Start the selected service</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Stop Service...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Stop the selected service</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Restart Service...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Restart the selected service.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Edit Service...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Edit the selected service</action><!-- FIXME: Add some more "meat" to 
+-->
+<!-- this one! -->
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Settings</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Toolbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off display of the toolbar.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Statusbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off display of the statusbar.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Log</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off the display of the log window</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Save Settings</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Save your current settings.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Key bindings...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Customize the default keybindings.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Customize the toolbar.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure SysV-Init Editor...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Customize the behavior</action> of &ksysv;
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Help</guimenu> menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<chapter id="Configuration">
+<title>Configuration</title>
+
+<para>
+All options are saved in
+<filename>$<envar>KDEHOME</envar>/share/config/ksysvrc</filename>. Defaults
+are taken from the global file
+(<filename>$<envar>KDEDIR</envar>/share/config/ksysvrc</filename>), if
+available, or else generated within &ksysv;. Changes to the defaults
+are stored in your local <filename>ksysvrc</filename>.
+</para>
+
+<sect1 id="recognized-sections">
+<title>Recognized Sections</title>
+
+<para>
+Recognized sections and keys plus their default values.
+</para>
+
+<sect2>
+<title>&lsqb;Path Settings&rsqb;</title>
+
+<segmentedlist>
+<segtitle>Keyword</segtitle>
+<segtitle>Default</segtitle>
+<segtitle>Description</segtitle>
+<seglistitem>
+<seg>ScriptPath</seg>
+<seg><filename class="directory">/etc/rc.d/init.d</filename></seg>
+<seg>Path to the scripts used for starting and stopping services.</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>RunlevelPath</seg>
+<seg><filename class="directory">/etc/rc.d</filename></seg>
+<seg>Path to the runlevel subfolders.</seg>
+</seglistitem>
+
+</segmentedlist>
+
+</sect2>
+
+<sect2>
+<title>&lsqb;Colors&rsqb;</title>
+
+
+<segmentedlist>
+<segtitle>Keyword</segtitle>
+<segtitle>Default</segtitle>
+<segtitle>Description</segtitle>
+<seglistitem>
+<seg>Changed</seg>
+<seg>red</seg>
+<seg>Color used for changed entries</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>New</seg>
+<seg>blue</seg>
+<seg>Color used for new entries</seg>
+</seglistitem>
+
+</segmentedlist>
+
+</sect2>
+
+<sect2>
+<title>&lsqb;Geometry&rsqb;</title>
+
+<segmentedlist>
+<segtitle>Keyword</segtitle>
+<segtitle>Default</segtitle>
+<segtitle>Description</segtitle>
+<seglistitem>
+<seg>Width</seg>
+<seg></seg>
+<seg>Width of &ksysv;'s window</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>Height</seg>
+<seg></seg>
+<seg>Height of &ksysv;'s</seg>
+</seglistitem>
+</segmentedlist>
+
+</sect2>
+
+<sect2>
+<title>&lsqb;Other Settings&rsqb;</title>
+
+<segmentedlist>
+<segtitle>Keyword</segtitle>
+<segtitle>Default</segtitle>
+<segtitle>Description</segtitle>
+<seglistitem>
+<seg>ToolBar</seg>
+<seg>true</seg>
+<seg>If the toolbar is enabled or not</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>StatusBar</seg>
+<seg>true</seg>
+<seg>If the statusbar is enabled or not</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>ShowLog</seg>
+<seg>true</seg>
+<seg>If the log window is shown or not</seg>
+</seglistitem>
+
+<seglistitem>
+<seg>PanningFactor</seg>
+<seg>80</seg>
+<seg>100 - PanningFactor = percentage of window reserved for the logfile
+display</seg>
+</seglistitem>
+</segmentedlist>
+
+</sect2>
+
+</sect1>
+
+</chapter>
+
+<chapter id="questions-and-answers">
+<title>Questions and Answers</title>
+
+<qandaset>
+<qandaentry>
+<question>
+<para>
+I played around with the default runlevel, and now my machine reboots
+all the time. What can I do?
+</para>
+</question>
+<answer>
+<para>
+Enter <userinput>linux single</userinput> at the
+<acronym>LILO</acronym> prompt, and press <keycap>Enter</keycap> to
+boot into single user mode.  Edit the file
+<filename>/etc/inittab</filename> and change to the default runlevel
+to something sane. <literal>3</literal> should normally be safe.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+My Machine <quote>halts</quote> just after booting
+</para>
+</question>
+<answer>
+<para>
+See Question 1, above.
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>
+I scheduled some services to be run in runlevel X using &ksysv;, so why
+aren't they working?
+</para>
+</question>
+
+<answer>
+<para>
+If you're using SuSE or Delix (DLD) distributions, you also have to edit
+a distribution specific file in <filename
+class="directory">/etc</filename>.  Please have a look at the manual of
+your distribution for details.
+</para>
+<para>
+<note>
+<para>
+The approach to starting services used by the above mentioned
+distributions makes configuration of services easy for the proprietary
+configuration tools these distributions provide, but it is unfortunately
+non-standard.  The &ksysv; authors plan to write a generic extension for
+this approach some time in the future, but don't hold your breath.
+</para>
+</note>
+</para>
+<para>
+If you're using a different distribution, please check you have all the
+config files needed by the service, and whether they are in the correct
+locations.  Some daemons for example <application>Apache</application>,
+(<acronym>aka</acronym> <command>httpd</command>) just die silently if
+their configuration files are missing or misconfigured.
+</para>
+</answer>
+</qandaentry>
+
+</qandaset>
+
+</chapter>
+
+<chapter id="standard-runlevels">
+<title>Standard semantics of Runlevels</title>
+
+<para>
+These vary by distribution, so this is an incomplete list of the most
+common &Linux; distributions.  If you have additional distributions,
+please email the author and have the information added to this manual.
+</para>
+
+<variablelist>
+<varlistentry>
+<term>&RedHat;</term>
+<listitem>
+<variablelist>
+<varlistentry>
+<term>Runlevel 0:</term>
+<listitem>
+<para>
+halt (shuts down the machine)
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 1:</term>
+<listitem>
+<para>
+Single user mode.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 2:</term>
+<listitem>
+<para>
+Multi user text only, without <acronym>NFS</acronym>.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 3:</term>
+<listitem>
+<para>
+Multi user text-only, with full networking.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 4:</term>
+<listitem>
+<para>
+Not used.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 5:</term>
+<listitem>
+<para>
+Multi user X11 with full networking.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runlevel 6:</term>
+<listitem>
+<para>
+Reboot
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</chapter>
+
+<chapter id="credits">
+<title>License and Credits</title>
+<para>&ksysv;  Copyright &copy; 1997-1998 Peter Putzer</para>
+
+<itemizedlist>
+<listitem>
+<para>
+Peter Putzer, <email>putzer@kde.org</email> - Developer
+</para>
+</listitem>
+</itemizedlist>
+
+<para>
+Documentation:
+</para>
+
+<itemizedlist>
+<listitem>
+<para>Peter Putzer, <email>putzer@kde.org</email> - Original content </para>
+</listitem>
+<listitem><para>Eric Bischoff, <email>e.bischoff@noos.fr</email> - Editor
+</para>
+</listitem>
+</itemizedlist>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+ 
+&underFDL;
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+&install.intro.documentation;
+&install.compile.documentation;
+</appendix>
+
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/doc/kuser/Makefile.am b/doc/kuser/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kuser/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kuser/index.docbook b/doc/kuser/index.docbook
new file mode 100644
index 0000000..9b3f006
--- /dev/null
+++ b/doc/kuser/index.docbook
@@ -0,0 +1,273 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
+"dtd/kdex.dtd" [
+  <!ENTITY kappname "&kuser;">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kuser; Handbook</title>
+<authorgroup>
+<author>
+<firstname>Matt</firstname>
+<surname>Johnston</surname>
+<affiliation>
+<address><email>mattj@flashmail.com</email></address>
+</affiliation>
+</author>
+
+<othercredit role="reviewer">
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+<affiliation>
+<address><email>lauri@kde.org</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+<othercredit role="reviewer">
+<firstname>Jonathan</firstname>
+<surname>Singer</surname>
+<affiliation>
+<address><email>jsinger@leeta.net</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2000</year>
+<holder>Matt Johnston</holder>
+</copyright>
+<legalnotice>&FDLNotice;</legalnotice>
+
+
+<date>2002-10-08</date>
+<releaseinfo>1.0</releaseinfo>
+
+<abstract><para>This documentation describes &kuser; version 1.0. This
+program allows you to manage users and groups on your system.</para>
+</abstract>
+
+<keywordset>
+<keyword>kuser</keyword>
+<keyword>user</keyword>
+<keyword>management</keyword>
+<keyword>admin</keyword>
+<keyword>tools</keyword>
+<keyword>group</keyword>
+<keyword>password</keyword>
+</keywordset>
+</bookinfo>
+
+<chapter id="start">
+<title>Getting Started</title>
+
+<para>This is a short introduction to &kuser;. For more detailed
+information, see <link linkend="using">Usage</link>.</para>
+
+<para>Actually, you do not need to do anything to begin using &kuser;
+except <link linkend="customizing">configuration</link>.</para>
+
+<para>When you have made the changes you want, you must
+<guimenuitem>Save</guimenuitem> them for them to take effect. Either
+choose the Toolbar icon, or use the <guimenu>File</guimenu> menu.</para>
+
+</chapter>
+
+<chapter id="using">
+<title>Usage</title>
+
+<sect1 id="sec1mainwindow">
+<title>Main Window</title>
+
+<para>&kuser; is a very simple application. In the main window you can
+see two tabs: the list of users and the list of groups. To edit a user
+or a group, just double click on it. The user or group properties dialog
+will appear.</para>
+<screenshot>
+<screeninfo>&kuser; Main Window</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="kuser.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>&kuser; Main Window</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+</sect1>
+
+<sect1 id="user-properties">
+<title>User Properties Dialog</title>
+
+<para>The user properties dialog has various tabs.</para>
+
+<para>The number of tabs depends on the type of the user storage system
+and whether quotas are being used. Additional tabs will appear if you
+have shadow passwords, or any other similar things such as
+<filename>/etc/master.passwd</filename> in BSD flavor Unices.</para>
+
+<sect2 id="user-info">
+<title><guilabel>User Info</guilabel> Tab</title>
+
+<para>In the <guilabel>User Info</guilabel> tab you can modify:
+</para>
+
+<itemizedlist>
+<listitem><para><guilabel>User Id</guilabel></para></listitem>
+<listitem><para><guilabel>Full Name</guilabel></para></listitem>
+<listitem><para><guilabel>Login Shell</guilabel> (the list of login shells is
+taken from the <filename>/etc/shells</filename> file)</para></listitem>
+<listitem><para><guilabel>Home Folder</guilabel></para></listitem>
+<listitem><para><guilabel>Two office locations</guilabel></para></listitem>
+<listitem><para><guilabel>Address</guilabel></para></listitem>
+<listitem><para><guilabel>Password</guilabel></para></listitem>
+</itemizedlist>
+
+</sect2>
+
+<sect2 id="password-management-info">
+<title><guilabel>Password Management</guilabel> Tab</title>
+
+<para>The <guilabel>Password Management</guilabel> tab will appear if you have
+shadow passwords, or any other similar things such as
+<filename>/etc/master.passwd</filename> in <acronym>BSD</acronym> flavor
+Unices.</para>
+
+<para>In the <guilabel>Extended Info</guilabel> tab you can modify
+parameters related to extended account control: </para>
+
+<itemizedlist>
+<listitem><para>Minimum number of days between password 
+changes</para></listitem>
+<listitem><para>Number of days after which a password expires if it hasn't been 
+changed</para></listitem>
+<listitem><para>Number of days before expiration the user will be 
+warned</para></listitem>
+<listitem><para>Whether and when an account will be disabled if the password 
+expires</para></listitem>
+<listitem><para>A set date when the account expires</para></listitem>
+<listitem><para><guilabel>Class</guilabel> (on <acronym>BSD</acronym> 
+systems)</para></listitem>
+</itemizedlist>
+<para>The date of the last password change is displayed near the top of the 
+dialog.</para>
+
+
+</sect2>
+
+<sect2 id="quota">
+<title><guilabel>Quota</guilabel> Tab</title>
+
+<para>You will probably see the <guilabel>Quota</guilabel> tab only if you
+have at least one mounted volume with quota enabled and a quota file
+present. There you may modify all quota related parameters: </para>
+
+<itemizedlist>
+<listitem><para><guilabel>File Soft Quota</guilabel></para></listitem>
+<listitem><para><guilabel>File Hard Quota</guilabel></para></listitem>
+<listitem><para><guilabel>File Time Limit (Grace 
+Period)</guilabel></para></listitem>
+<listitem><para><guilabel>iNode Soft Quota</guilabel></para></listitem>
+<listitem><para><guilabel>iNode Hard Quota</guilabel></para></listitem>
+<listitem><para><guilabel>iNode Time Limit (Grace 
+Period)</guilabel></para></listitem>
+</itemizedlist>
+
+<para> All these parameters can be changed for each filesystem that has user
+quota enabled. Filesystems can be changed using the <guilabel>Quota
+Filesystem</guilabel> box.</para>
+
+</sect2>
+
+<sect2 id="group">
+<title><guilabel>Groups</guilabel> Tab</title>
+
+<para>The <guilabel>Groups</guilabel> tab contains all the information about the
+selected user's participation in groups. The primary group to which the user 
+belongs
+is set in the <guilabel>Primary Group</guilabel> box. The user can be assigned
+to additional groups by checking them in the large box.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="group-properties">
+<title><guilabel>Group Properties</guilabel></title>
+
+<para>The <guilabel>Group Properties</guilabel> dialog contains a list of all 
+users. Check
+the boxes for each user to be assigned to the selected group.</para>
+
+</sect1>
+
+<sect1 id="add-user">
+<title>Adding, Editing and Deleting Users or Groups</title>
+
+<para>To add a user or group to the system, either choose
+<guimenuitem>Add</guimenuitem> from the <guimenu>User</guimenu> or
+<guimenu>Group</guimenu> menu, or click the relevant <guiicon>Add</guiicon> 
+button on
+the toolbar. The selected user or group can also be edited or deleted in the 
+same way.</para>
+</sect1>
+</chapter>
+
+<chapter id="customizing">
+<title>Customizing &kuser;</title>
+
+<sect1 id="defaults">
+<title>Edit user creation defaults</title>
+
+<para>To edit the user creation defaults you can use the <guilabel>Edit
+defaults</guilabel> dialog, which is accessible via the menu
+<menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kuser;</guimenuitem></menuchoice>. There you may
+change the defaults that are used when creating a new user: Shell and
+Home Folder (or home folders volume). You can choose whether to
+make a home folder on <quote>create</quote> or not,and to copy a
+skeleton (standard configuration files) to the home folder or not. You can 
+also enable
+<guilabel>User Private Group</guilabel> mechanism, which creates a new
+personal group with the creation of a new user, and removes the personal
+group when the user is removed.</para>
+<para>The skeleton files for new users can be specified in the <guilabel>Sources
+</guilabel> tab.</para>
+
+</sect1>
+</chapter>
+
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>&kuser;</para>
+
+<para>Program copyright 1997-2000 Denis Pershin
+<email>dyp@inetlab.com</email></para>
+
+<para>Documentation copyright 1997-2000 Denis Pershin
+<email>dyp@inetlab.com</email></para>
+<para>Documentation copyright 2000 Matt Johnston
+<email>mattj@flashmail.com</email></para>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+
+</chapter>
+&documentation.index; 
+
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/doc/kuser/kuser.png b/doc/kuser/kuser.png
new file mode 100644
index 0000000..e68ac2d
--- /dev/null
+++ b/doc/kuser/kuser.png
diff --git a/doc/lilo-config/Makefile.am b/doc/lilo-config/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/lilo-config/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/lilo-config/index.docbook b/doc/lilo-config/index.docbook
new file mode 100644
index 0000000..a0cf803
--- /dev/null
+++ b/doc/lilo-config/index.docbook
@@ -0,0 +1,177 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY package "kdebase">
+<!ENTITY liloconfig "LILO Configuration">
+<!ENTITY lilo "LILO">
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+
+<!ENTITY Virgil.J.Nisly "<personname><firstname>Virgil</firstname><othername>J.</othername><surname>Nisly</surname></personname>">
+<!ENTITY Virgil.J.Nisly.mail "<email>virgil@vigilite.com</email>">
+]>
+
+<article lang="&language;">
+<articleinfo>
+<title>The &liloconfig; Handbook</title>
+
+<authorgroup>
+<author>&Virgil.J.Nisly; &Virgil.J.Nisly.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2005</year>
+<holder>&Virgil.J.Nisly;</holder>
+</copyright>
+<legalnotice>&FDLNotice;&underFDL;&GPLNotice;&underGPL;</legalnotice>
+
+<date>2005-01-18</date>
+<releaseinfo>1.00.00</releaseinfo>
+<abstract><para>&liloconfig; is an application specificly designed to configure &lilo; the boot manager.</para></abstract>
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>lilo</keyword>
+<keyword>boot configuration</keyword>
+<keyword>booting</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="login-manager">
+<title>&liloconfig;</title>
+
+<para>Using this module, you can install lilo boot manager, add/remove/change boot password, change time till booting default OS, add/remove/change default OS, add/remove/change OS's, and more!</para>
+
+<para>In order to organize all of these options, this module is
+divided into three sections: <link
+linkend="lilo-general"><guilabel>General Options</guilabel></link>,
+<link linkend="lilo-OS"><guilabel>Operating Systems</guilabel></link>, and <link
+linkend="lilo-expert"><guilabel>Expert</guilabel></link></para>
+
+<para>You can switch between the sections using the tabs at the top of
+the window.</para>
+
+<note><para>If you are not currently logged in as a superuser, you
+will need to click the <guibutton>Administrator Mode</guibutton>
+Button. You will then be asked for a superuser password.  Entering a
+correct password will allow you to modify the settings of this
+module.</para></note>
+</sect1>
+
+<sect1 id="lilo-general">
+<title>General Options</title>
+
+<para>From this page you can add/remove/change boot password, time till booting default OS, and more!</para>
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Install boot record to drive/partition:</guilabel></term>
+<listitem><para> Select the drive or partition where you would like to install the Lilo boot loader.  Unless you intend to use other boot managers in addition to LILO, this should be the MBR (master boot record) of your boot drive. In this case, you should probably select /dev/hda if your drive is IDE, and /dev/sda if your boot drive is SCSI.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Boot the default kernel/OS after:</guilabel></term>
+<listitem><para>Lilo will wait the specified time before booting default kernel/OS.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Use linear mode</guilabel></term>
+<listitem><para>Linear mode tells the boot loader the location of the kernels in linear addressing rather than sector/head/cylinder. Linear mode is required by some SCSI drives, and shouldn't hurt unless you are planning to create a boot disk to be used with other computers. See lilo man file for more details.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Use compact mode</guilabel></term>
+<listitem><para>The compact mode trys to merge read requests for adjacent sectors in to single read request. This reduces load time and keeps boot map smaller, but will not work on all systems.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Record boot command lines for defaults</guilabel></term>
+<listitem><para>Automatic recording of boot command lines as defaults for following boots. This way, lilo "locks" on a choice until manually overridden.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Restrict parameters</guilabel></term>
+<listitem><para>A password is required only if any parameters changed (i.e. the user can boot linux, but not linux single or linux init=/bin/sh). This sets a default for all Linux kernels you want to boot. If you need a per-kernel setting, go to Operating Systems tab, and select details.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Require password:</guilabel></term>
+<listitem><para>Enter the password for bootup (if any) here. If restricted (above) is checked, the password is required for additional parameters only. <warning><para>The password is stored in clear text in /etc/lilo.conf. You'll want to make sure nobody untrusted can read this file. Also, you probably don't want to use your normal/root password here.</para></warning></para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Default graphics mode on text console:</guilabel></term>
+<listitem><para>You can select the default graphics mode here. If you intend to use a VGA graphics mode, you must compile the kernel with support for frame buffer devices. The ask setting brings up a prompt at boot time. This sets a default for all Linux kernels you want to boot. If you need a per-kernel setting, go to Operating Systems tab, and select details.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Enter LILO prompt automatically</guilabel></term>
+<listitem><para>If this box is checked, lilo goes to the lilo prompt whether or not a key is pressed. If it is turned off, lilo boots the default operating system unless shift is pushed (in that case, it goes to the lilo prompt).</para></listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="lilo-OS">
+<title>Operating Systems</title>
+
+<para>Some of the things that can be done here are: settings like <guilabel>General Options</guilabel> for specific kernels/OSes, set default OS to boot, probe for available kernels, you can also edit root file system, ramdisk settings, extra parameters, etc...</para>
+
+<variablelist>
+<varlistentry>
+<term>Boot menu listbox</term>
+<listitem><para>To the far left is a list of the kernels and operating systems you can currently boot. Choose the one you would like to edit.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Kernel:</guilabel></term>
+<listitem><para>Enter the filename of the kernel you would like to boot. Pushing the <guibutton>Select...</guibutton> will bring up &kde; standard fileselector to help you find the kernel.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Label:</guilabel></term>
+<listitem><para>Enter the label (name) of the kernel you want to boot here.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Root filesystem:</guilabel></term>
+<listitem><para>Enter the root filesystem for the kernel you would like to boot. Pushing the <guibutton>Select...</guibutton> will bring up &kde; standard fileselector to help you find the root filesystem.</para>
+<note><title>Root filesystem</title><para>In this case, the root filesystem means the partition that will be mounted as / at boot time.</para></note>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Initial ramdisk:</guilabel></term>
+<listitem><para>If you want to use an initial ramdisk (initrd) for this kernel, enter its filename here. Leave this field blank if you do not intend to use an initial ramdisk for this kernel.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Extra parameters:</guilabel></term>
+<listitem><para>Enter an extra parameters you wish to pass kernel. Usually this can be left blank. This can the append option in lilo.conf.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Set Default</guibutton></term>
+<listitem><para>Boot this kernel if the user doesn't make a different choice.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Details</guibutton></term>
+<listitem><para>This brings up a dialog box with further, less commonly used, options.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Probe</guibutton></term>
+<listitem><para>Automaticly generate a (hopefully) reasonable lilo.conf for your system.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Check Configuration</guibutton></term>
+<listitem><para>Run LILO in test mode to see if the configuration is ok.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Add Kernel...</guibutton></term>
+<listitem><para>Add a new Linux kernel to the boot menu.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Add Other OS...</guibutton></term>
+<listitem><para>Add non-Linux OS to boot menu.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guibutton>Remove Entry</guibutton></term>
+<listitem><para>Remove entry from boot menu.</para></listitem>
+</varlistentry>
+
+</variablelist>
+</sect1>
+
+<sect1 id="lilo-expert">
+<title>Expert</title>
+<para>In this page you can edit the /etc/lilo.conf file.</para>
+<warning><para>Do <emphasis>not</emphasis> edit this file so unless you know what you are doing!</para></warning>
+</sect1>
+
+</article>