Disabled kcontrol/helpindex.html that was part of the old htmlsearch kcontrol module,

deleted doc/kcontrol/tdm handbook that was a duplicate of doc/tdm handbook,
nominal update of khelpcenter handbook.

6 files changed, 78 insertions, 565 deletions

diff --git a/doc/kcontrol/helpindex/CMakeLists.txt b/doc/kcontrol/helpindex/CMakeLists.txt
index 09158264f..f2c0c72b3 100644
--- a/doc/kcontrol/helpindex/CMakeLists.txt
+++ b/doc/kcontrol/helpindex/CMakeLists.txt
@@ -9,4 +9,4 @@
 #
 #################################################
 
-tde_create_handbook( DESTINATION kcontrol/helpindex.html )
+# tde_create_handbook( DESTINATION kcontrol/helpindex )
diff --git a/doc/kcontrol/helpindex/Makefile.am b/doc/kcontrol/helpindex/Makefile.am
index 0529b36f5..130eaca75 100644
--- a/doc/kcontrol/helpindex/Makefile.am
+++ b/doc/kcontrol/helpindex/Makefile.am
@@ -1,2 +1,2 @@
-KDE_LANG = en
-KDE_DOCS = kcontrol/helpindex.html
+# KDE_LANG = en
+# KDE_DOCS = kcontrol/helpindex.html
diff --git a/doc/kcontrol/tdm/CMakeLists.txt b/doc/kcontrol/tdm/CMakeLists.txt
deleted file mode 100644
index 4bdd0a66d..000000000
--- a/doc/kcontrol/tdm/CMakeLists.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-#################################################
-#
-#  (C) 2010-2011 Serghei Amelian
-#  serghei (DOT) amelian (AT) gmail.com
-#
-#  Improvements and feedback are welcome
-#
-#  This file is released under GPL >= 2
-#
-#################################################
-
-tde_create_handbook( DESTINATION kcontrol/tdm )
diff --git a/doc/kcontrol/tdm/Makefile.am b/doc/kcontrol/tdm/Makefile.am
deleted file mode 100644
index c81f42bd9..000000000
--- a/doc/kcontrol/tdm/Makefile.am
+++ /dev/null
@@ -1,2 +0,0 @@
-KDE_LANG = en
-KDE_DOCS = kcontrol/tdm
diff --git a/doc/kcontrol/tdm/index.docbook b/doc/kcontrol/tdm/index.docbook
deleted file mode 100644
index e4b70de80..000000000
--- a/doc/kcontrol/tdm/index.docbook
+++ /dev/null
@@ -1,518 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
-<!ENTITY % addindex "IGNORE">
-<!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-<articleinfo>
-
-<authorgroup>
-<author>&Thomas.Tanghus; &Thomas.Tanghus.mail;</author>
-<author>&Steffen.Hansen; &Steffen.Hansen.mail;</author>
-<author>&Mike.McBride; &Mike.McBride.mail;</author>
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2002-02-13</date>
-<releaseinfo>3.00.00</releaseinfo>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>KControl</keyword>
-<keyword>TDM configuration</keyword>
-<keyword>login manager</keyword>
-<keyword>login</keyword>
-</keywordset>
-</articleinfo>
-
-<sect1 id="login-manager">
-<title>Login Manager</title>
-
-<para>Using this module, you can configure the &tde; graphical login
-manager, &tdm;.  You can change how the login screen looks, who has
-access using the login manager and who can shutdown the
-computer.</para>
-
-<para>In order to organize all of these options, this module is
-divided into six sections: <link
-linkend="tdmconfig-appearance"><guilabel>Appearance</guilabel></link>,
-<link linkend="tdmconfig-font"><guilabel>Font</guilabel></link>, <link
-linkend="tdmconfig-background"><guilabel>Background</guilabel></link>,
-<link
-linkend="tdmconfig-sessions"><guilabel>Sessions</guilabel></link>,
-<link linkend="tdmconfig-users"><guilabel>Users</guilabel></link> and
-<link
-linkend="tdmconfig-convenience"><guilabel>Convenience</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>
-
-<sect2 id="tdmconfig-appearance">
-<title>Appearance</title>
-
-<para>From this page you can change the visual appearance of &tdm;,
-&tde;'s graphical login manager.</para>
-
-<para>The greeting string is the title of the login screen. If the
-string contains the word <computeroutput>HOSTNAME</computeroutput> it
-will be translated to the domainless name of the machine &tdm; is
-installed on.</para>
-
-<para>You can then choose to show either the current system time, a logo
-or nothing special in the login box.  Make your choice in the radio
-buttons labeled <guilabel>Logo area</guilabel>. Using the
-<guilabel>Positions</guilabel> setting, you can choose to either center
-the content of the logo area or to position it using fixed
-coordinates.</para>
-
-<para>If you chose <guilabel>Show logo</guilabel> you can now choose a
-logo:</para>
-
-<itemizedlist>
-<listitem>
-<para>Drop an image file on the image button.</para>
-</listitem>
-<listitem>
-<para>Click on the image button and select a new image from the image chooser
-dialog.</para>
-</listitem>
-</itemizedlist>
-
-<para>If you do not specify a logo the default
-<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/kdelogo.png</filename>
-will be displayed.</para>
-
-<para>While &tde;'s style depends on the settings of the user logged in,
-the style used by &tdm; can be configured using the <guilabel>GUI
-Style</guilabel> option.</para>
-
-<para>Below that, you have two dropdown boxes to choose the language and the
-country for your login box.</para>
-
-</sect2>
-
-<sect2 id="tdmconfig-font">
-<title>Font</title>
-
-<para>From this section of the module you can change the fonts used in
-the login window.</para>
-
-<para>You can select three different font styles from the drop down box
-(<guilabel>Greeting</guilabel>, <guilabel>Fail</guilabel>,
-<guilabel>Standard</guilabel>).  When you click on the <guibutton>Change
-font</guibutton> button a dialog appears from which you can select the
-new characteristics for the font style.</para>
-
-<itemizedlist>
-<listitem>
-<para>The <guilabel>Greeting</guilabel> font is the font used for the title
-(Greeting String).</para>
-</listitem>
-<listitem>
-<para>The <guilabel>Fail</guilabel> font is used when a login fails.</para>
-</listitem>
-<listitem>
-<para>The <guilabel>Standard</guilabel> font is used in all other places in the
-login window.</para>
-</listitem>
-</itemizedlist>
-
-<para>An example of each font can be seen in the
-<guilabel>Example</guilabel> Box.</para>
-
-</sect2>
-
-<sect2 id="tdmconfig-background">
-<title>Background</title>
-
-<para>Here you can change the desktop background which will be displayed
-when a user logs in. You can have a single color or an image as a
-background. If you have an image as the background and select center, the
-selected background color will be used around the image if it isn't
-large enough to cover the entire desktop.</para>
-
-<para>The background colors and effects are controlled by the options on
-the tab labeled <guilabel>Background</guilabel> and you select a
-background image and its placement from the options on the tab labeled
-<guilabel>Wallpaper</guilabel>.</para>
-
-<para>To change the default background color(s) simply click either of
-the color buttons and select a new color.</para>
-
-<para>The dropdown box above the color buttons provides you with several
-different blend effects.  Choose one from the list, and it will be
-previewed on the small monitor at the top of the window.  Your choices
-are:</para>
-
-<variablelist>
-<varlistentry>
-<term>Flat</term>
-<listitem><para>By choosing this mode, you select one color (using the color
-button labeled <guibutton>Color 1</guibutton>), and the entire background is
-covered with this one color.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Pattern</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).</para> <para>You then select a pattern by clicking
-<guilabel>Setup</guilabel>.  This opens a new dialog window, which gives you
-the opportunity to select a pattern.  Simply click once on the pattern of your
-choice, then click on <guilabel>OK</guilabel>, and &tde; will render the pattern
-you selected using the two colors you selected.  For more on patterns, see the
-section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns">Background: Adding, Removing and Modifying
-Patterns</ulink>.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Background Program</term>
-<listitem><para>By selecting this option, you can have &tde; use an external
-program to determine the background.  This can be any program of your choosing.
-For more information on this option, see the section entitled <ulink
-url="help:/kcontrol/background/index.html#bkgnd-programs">Background: Using an external program</ulink>.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Horizontal Gradient</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).  &tde; will then start with the color selected by <guilabel>Color
-1</guilabel> on the left edge of the screen, and slowly transform into the
-color selected by <guilabel>Color 2</guilabel> by the time it gets to the
-right edge of the screen.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Vertical Gradient</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).  &tde; will then start with the color selected by <guilabel>Color
-1</guilabel> on the top edge of the screen, and slowly transform into the color
-selected by <guilabel>Color 2</guilabel> as it moves to the bottom of the
-screen.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Pyramid Gradient</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).  &tde; will then start with the color selected by <guilabel>Color
-1</guilabel> in each corner of the screen, and slowly transform into the color
-selected by <guilabel>Color 2</guilabel> as it moves to the center of the
-screen.</para></listitem> 
-</varlistentry>
-<varlistentry>
-<term>Pipecross Gradient</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).  &tde; will then start with the color selected by <guilabel>Color
-1</guilabel> in each corner of the screen, and slowly transform into the color
-selected by <guilabel>Color 2</guilabel> as it moves to the center of the
-screen. The <quote>shape</quote> of this gradient is  different then the pyramid
-gradient.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term>Elliptic Gradient</term>
-<listitem><para>By choosing this mode, you select two colors (using both color
-buttons).  &tde; will then start with the color selected by <guilabel>Color
-2</guilabel> in the center of the screen, and slowly transform into the color
-selected by <guilabel>Color 1</guilabel> as it moves to the edges, in an
-elliptical pattern.</para></listitem> 
-</varlistentry>
-</variablelist>
-
-<para>The setup button is only needed for if you select <guilabel>Background
-program</guilabel> or <guilabel>Patterns</guilabel>.  In these instances,
-another window will appear to configure the specifics.</para>
-<para><emphasis>Wallpaper</emphasis></para>
-<para>To select a new background image first, click on the
-<guilabel>Wallpapers</guilabel> tab, then  you can either select an image from the
-drop-down list labeled <guilabel>Wallpaper</guilabel> or select
-<guibutton>Browse...</guibutton> and select an image file from a file
-selector.</para>
-
-<para>The image can be displayed in six different ways:</para>
-<variablelist>
-<varlistentry>
-<term>No wallpaper</term> 
-<listitem><para>No image is displayed.  Just the background colors.</para>
-</listitem></varlistentry>
-<varlistentry>
-<term>Centered</term> 
-<listitem><para>The image will be centered on the screen.  The background colors
-will be present anywhere the image does not cover.</para> </listitem>
-</varlistentry>
-<varlistentry>
-<term>Tiled</term>
-<listitem><para>The image will be duplicated until it fills the entire
-desktop. The first image will be placed in the upper left corner of the screen,
-and duplicated downward and to the right.</para> </listitem>
-</varlistentry>
-<varlistentry>
-<term>Center Tiled</term>
-<listitem><para>The image will be duplicated until it fills the entire
-desktop. The first image will be placed in the center of the screen, and
-duplicated upward, downward to the right, and to the left.</para> </listitem>
-</varlistentry>
-<varlistentry>
-<term>Centered Maxpect</term>
-<listitem><para>The image will be placed in the center of the screen.  It will
-be scaled to fit the desktop, but it will not change the aspect ratio of the
-original image.  This will provide you with an image that is not distorted.
-</para> </listitem>
-</varlistentry>
-<varlistentry>
-<term>Scaled</term>
-<listitem><para>The image will be scaled to fit the desktop.  It will be
-stretched to fit all four corners.</para> </listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-<sect2 id="tdmconfig-sessions">
-<title>Sessions</title>
-
-<para><guilabel>Allow to shutdown</guilabel></para>
-<para>Use this dropdown box to choose who is allowed to shut down:</para>
-<itemizedlist>
-<listitem>
-<para><guilabel>None</guilabel>: No one can shutdown the computer using &tdm;.
-You must be logged in, and execute a command.</para>
-</listitem>
-<listitem>
-<para><guilabel>All</guilabel>:  Everyone can shutdown the computer using
-&tdm;.</para>
-</listitem>
-<listitem><para><guilabel>Root only</guilabel>: &tdm; requires that the
-<systemitem>root</systemitem> password be entered before shutting down the
-computer.</para></listitem> 
-<listitem><para><guilabel>Console only</guilabel>: The user must be at this
-console, to shut down the computer.</para></listitem>
-</itemizedlist>
-
-<para><emphasis>Commands</emphasis></para>
-<para>Use these 3 blanks to define the exact shutdown command.</para>
-<para>The shutdown command defaults to:</para>
-
-<para><command>/sbin/shutdown</command></para>
-
-<para>The restart command defaults to:</para>
-
-<para><command>/sbin/reboot</command></para>
-
-<para>The Console mode (which restarts the computer as a console only terminal)
-defaults to:</para>
-
-<para><command>/sbin/init <option>3</option></command></para>
-
-<para>When <guilabel>Show boot options</guilabel> is enabled, &tdm; will on reboot
-offer you options for the lilo boot manager. For this feature to work, you will
-need to supply the correct paths to your <command>lilo</command> command and to
-lilo's map file.</para>
-
-
-<sect3 id="tdmconfig-sess">
-<title>Session types</title>
-
-<para>Define which session types should be accessible from the login
-window.</para>
-
-<para> For more information on this subject, look at <filename
-class="directory">/etc/X11/xdm/Xsession</filename> to find your
-<application>xdm</application> setup files.  Also review the <ulink
-url="man:xdm">xdm man pages</ulink>, especially under the SESSION
-PROGRAM section.</para>
-
-<para>To add a session, type its name in the
-blank entitled <guilabel>New types</guilabel>, and click
-<guibutton>Add new</guibutton>.</para>
-
-<para>To remove a session, select the session from the list and click
-<guibutton>Remove</guibutton>.</para>
-
-</sect3>
-
-</sect2>
-
-
-<sect2 id="tdmconfig-users">
-<title>Users</title>
-
-<para>From here you can change the way users are represented in the
-login window.</para>
-
-<para>As you look on this window, you will see three lists (All users,
-selected users, and no-show users).  You also see an image box, and a
-set of options along the right side of the window.</para>
-
-<para>The first thing you must decide, is if you are going to show users
-or not.</para>
-
-
-<para>If you choose to show users, then the login window will show
-images (which you select), of a list of users.  When someone is ready to
-login, they select their user name/image, enter their password, and they
-are granted access.</para>
-
-<para>If you choose not to show users, then the login window will be
-more traditional.  Users will need to type their username, and password
-to gain entrance.  This is the preferred way if you have many users on
-this terminal.</para>
-
-<sect3 id="tdmconfig-showusers">
-<title>To show (and sort) or not to show users</title>
-
-<para>Along the right edge of the window are two check boxes:</para>
-
-<para>If <guilabel>Show users</guilabel> is selected, you have chosen to
-show images of users, instead of making them type their login
-name.</para>
-
-<para>If <guilabel>Sort users</guilabel> is selected, then the list of
-users will be sorted alphabetically in the login window.  If unchecked,
-users will be listed in the same order as they are on this page.  If
-<guilabel>Show users</guilabel> is not checked, this has no
-effect.</para>
-
-</sect3>
-
-<sect3 id="tdmconfig-whichusers">
-<title>How to determine which users to show and which users to hide</title>
-
-<para>Below the user image box, and above the <guilabel>Show
-users</guilabel> check box, is a set of two radio buttions:</para>
-
-<itemizedlist>
-<listitem><para>Show only selected users: If this option is selected, only the
-users contained in the list labelled <guilabel>Selected Users</guilabel>, will
-be displayed in the login window. If <guilabel>Show users</guilabel> is not
-checked, this has no effect.</para></listitem>
-<listitem><para>Show all users but no-show users: If this option is selected,
-all users will be listed, <emphasis>except</emphasis> those users contained in
-the list entitled <guilabel>No show users</guilabel>.  If <guilabel>Show
-users</guilabel> is not checked, this has no effect.</para></listitem>
-</itemizedlist>
-
-</sect3>
-
-<sect3 id="tdmconfig-select">
-<title>Select users</title>
-
-<para>This page contains three listboxes. The large listbox on the left
-shows all the users on the system which might be a genuine user.</para>
-
-<para>The top right-most listbox shows the selected users and the bottom
-right-most listbox shows the users we don't want displayed in the login
-window.</para>
-
-<para>To move a user from one listbox to another you click on the
-username in the listbox and click <guibutton>&gt;&gt;</guibutton> to
-move the user from the left-most box the the right-most box or
-<guibutton>&lt;&lt;</guibutton> to move the user from the right-most box
-to the left-most box.</para>
-
-</sect3>
-
-<sect3 id="tdmconfig-image">
-<title>Images</title>
-
-<note><para>This section of the manual only applies if <guilabel>Show
-users</guilabel> is selected.  If it is not, this image box has no
-effect.</para></note>
-
-<para>Every user on the system can be represented by a image. The image
-for the user is kept in a file called
-<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/$<envar>USER</envar>.xpm.</filename>
-If the user doesn't have such a file the file
-<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/default.xpm</filename>
-will be used instead.</para>
-
-<para>To assign a new image to a user just select the user in one of the
-listboxes and either drop an imagefile on the image button to the right
-or click on the image button and select a new image from the image
-selector.</para>
-
-<para>If no user is currently selected you will be asked if you want to change
-the default image.</para>
-
-<para>The replacement is performed by a &konqueror; process so if the
-image file already exists you will be prompted by &konqueror; if you
-want to replace it. If you confirm the image will be replaced - you will
-<emphasis>not</emphasis> have to press the <guibutton>Apply</guibutton>
-button.</para>
-
-</sect3>
-</sect2>
-
-
-<sect2 id="tdmconfig-convenience">
-<title>Convenience</title>
-
-<para>In the <guilabel>convenience</guilabel> tab you can configure some
-options that make life easier for lazy people, like auto login or
-disabling passwords.</para>
-
-<important><para>Please think more than twice before using these
-options. Every option in the <guilabel>convenience</guilabel> tab is
-well-suited to seriously compromise your system security. Practically,
-these options are only to be used in a completely non-critical
-environment, &eg; a private computer at home.</para></important>
-
-<sect3 id="loginmanager-convenience-autologin">
-<title>Automatic Login</title>
-
-<para>Automatic login will give anyone access to a certain account on
-your system without doing any authentication.  You can enable it using
-the option <guilabel>Enable auto-login</guilabel>.</para>
-
-<para>Automatic login comes in two flavors: <guilabel>truly automatic
-login</guilabel> acts like you would expect automatic login to, &ie;
-&tdm; will automatically login without expecting any input from the
-user. Enable this using the <guilabel>Truly automatic login</guilabel>
-option. If this option is not enabled, &tdm; will start normally,
-enabling you to login as any user, and will only perform automatic login
-if you kill the X server, &eg; by pressing <keycombo
-action="simul">&Ctrl;&Alt;<keycap>Backspace</keycap></keycombo>.</para>
-
-<para>You can choose the account to be used for automatic login in the
-list below.</para>
-
-</sect3>
-
-<sect3 id="loginmanager-convenience-nopasswd">
-<title>Password-less Login</title>
-
-<para>Using this feature, you can allow certain users to login without
-having to provide their password. Enable this feature using the
-<guilabel>Enable password-less logins</guilabel> option.</para>
-
-<para>Below this option you will see a list of users for which a password
-is required, as well as a (by default, empty) list of users that do not
-need to provide a password.  When <guilabel>Enable password-less
-logins</guilabel> is enabled, you can move users from one list into the
-other, by selecting them and then clicking the
-<guibutton>&gt;&gt;</guibutton> and <guibutton>&lt;&lt;</guibutton>
-buttons.</para>
-
-<important><para>Again, this option should only be used in a safe
-environment. If you enable it on a rather public system you should take
-care that only users with heavy access restrictions are granted
-password-less login, &eg;
-<systemitem>guest</systemitem>.</para></important>
-
-<para>The <guilabel>Automatically login after X server crash</guilabel>
-option allows you to skip the authentication procedure when your X
-server accidentally crashed.  <guilabel>Show previous user</guilabel>
-will show the name of the last login already entered into the login
-field in &tdm;. Some site administrators would consider even this a
-possible security weakness, because potential attackers then know at
-least one valid login.</para>
-
-
-</sect3>
-
-</sect2>
-
-</sect1>
-
-</article>
diff --git a/doc/khelpcenter/help.docbook b/doc/khelpcenter/help.docbook
index a2ab707e3..fd6e68d34 100644
--- a/doc/khelpcenter/help.docbook
+++ b/doc/khelpcenter/help.docbook
@@ -189,11 +189,11 @@ contents of either pane.
 </para>
 
 <para>
-The <guilabel>Contents</guilabel> pane is further divided into two
-tabs, one containing a <link linkend="contents-menu">menu</link>
-showing all the help information &khelpcenter; is aware of, and the
-other contains the &tde; <link linkend="kde-glossary">glossary</link>
-of terms.
+The <guilabel>Contents</guilabel> pane includes three tabs, the
+<guilabel>Contents</guilabel> tab selects the <guilabel>Contents</guilabel> pane,
+the <guilabel>Glossary</guilabel> tab opens the &tde;
+<link linkend="tde-glossary">glossary</link> of terms, and the <guilabel>Search Options</guilabel>
+tab allows searching all help handbooks.
 </para>
 
 <sect3 id="contents-menu">
@@ -234,7 +234,16 @@ installation, configuration and customization, and use.
 </varlistentry>
 
 <varlistentry>
-<term><guilabel>Application manuals</guilabel></term>
+<term><guilabel>&tde; Administrator Guide</guilabel></term>
+<listitem><para>A reference guide to &tde; features, structure, framework
+and configurations useful to administrators. The information also is useful
+to single-user systems.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Application Manuals</guilabel></term>
 <listitem>
 <para>
 Native &tde; application documentation. &tde; applications have
@@ -252,6 +261,15 @@ application you are looking for.
 </varlistentry>
 
 <varlistentry>
+<term><guilabel>Applet Manuals</guilabel></term>
+<listitem>
+<para>
+Similar to Application Manuals but for applets that run in the &tde; panel.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
 <term><guilabel>Unix manual pages</guilabel></term>
 <listitem>
 <para>
@@ -422,6 +440,57 @@ some time.</para></listitem>
 
 </sect2>
 
+<sect2 id="tde-glossary">
+<title>The Glossary</title>
+
+<para>
+The glossary provides a quick reference point, where you can look up
+the definitions of words that may be unfamiliar to you. These range
+from &tde; specific applications and technologies, through to general
+&UNIX; computing terms.
+</para>
+
+<para>
+In the left hand pane you will see a tree view, with two choices:
+<guilabel>Alphabetically</guilabel> or <guilabel>By topic</guilabel>.
+Both contain the same entries, sorted differently, to allow you to
+quickly find the item of interest.
+</para>
+
+<para>
+Navigate down the tree views to the left, and items you select will be
+displayed on the right.
+</para>
+
+</sect2>
+
+<sect2 id="tde-search-options">
+<title>Search Options</title>
+
+<para>&tde; comes with a lot of documentation for applications and
+components. While possible to just browse the manuals until you
+find that piece of information you're looking for, this may be a very
+time-consuming task. To make this easier for you, &tde; offers
+full text search using a program called
+<application>ht://dig</application>. It works quite similar to search
+engines on the web and some search engines might even use
+<application>ht://dig</application>.</para>
+
+<para>To use <application>ht://dig</application>, select the <guilabel>Search
+Options</guilabel> tab in the &khelpcenter; <guilabel>Contents</guilabel> pane,
+enter the word you are looking for, then select the <guibutton>Search</guibutton>.</para>
+
+<para>However, to use this feature, <application>ht://dig</application>
+must be installed on your system. If you haven't installed
+<application>ht://dig</application> and the package wasn't shipped with your
+operating system you have to get ht://dig yourself. Use your package manager
+to search for the package.</para>
+
+<para>To build the search index, at the bottom of the <guilabel>Contents</guilabel> pane,
+select the <guilabel>Build Search Index button</guilabel>.</para>
+
+</sect2>
+
 <sect2 id="man-and-info">
 <title>The <application>Man</application> and <application>Info</application>
 sections</title>
@@ -478,30 +547,6 @@ one page long.</para>
 </sect3>
 </sect2>
 
-<sect2 id="kde-glossary">
-<title>The &tde; glossary</title>
-
-<para>
-The glossary provides a quick reference point, where you can look up
-the definitions of words that may be unfamiliar to you. These range
-from &tde; specific applications and technologies, through to general
-&UNIX; computing terms.
-</para>
-
-<para>
-In the left hand pane you will see a tree view, with two choices:
-<guilabel>Alphabetically</guilabel> or <guilabel>By topic</guilabel>.
-Both contain the same entries, sorted differently, to allow you to
-quickly find the item of interest.
-</para>
-
-<para>
-Navigate down the tree views to the left, and items you select will be
-displayed on the right.
-</para>
-
-</sect2>
-
 <sect2 id="menu-and-toolbar-ref">
 <title>The menus and toolbar</title>