<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY fileassoc SYSTEM "kcmfile.docbook">
 <!ENTITY filemanage SYSTEM "kcmfileman.docbook">
 <!ENTITY winshares SYSTEM "kcmwinshare.docbook">
 <!ENTITY cookie SYSTEM "kcmcookie.docbook">
 <!ENTITY enhbrowse SYSTEM "kcmebrowse.docbook">
 <!ENTITY konqbrowse SYSTEM "kcmkbrowse.docbook">
 <!ENTITY proxie SYSTEM "kcmproxie.docbook">
 <!ENTITY useragent SYSTEM "kcmuseragent.docbook">
 <!ENTITY colors SYSTEM "kcmcolor.docbook">
<!-- <!ENTITY numbername SYSTEM "kcmnumbername.docbook"> -->
 <!ENTITY background SYSTEM "kcmbackgnd.docbook">
 <!ENTITY borders SYSTEM "kcmborders.docbook">
 <!ENTITY desktop SYSTEM "kcmdesktop.docbook">
 <!ENTITY icon SYSTEM "kcmicon.docbook">
 <!ENTITY fonts SYSTEM "kcmfonts.docbook">
 <!ENTITY keybind SYSTEM "kcmkeybind.docbook">
 <!ENTITY panel SYSTEM "kcmpanel.docbook">
 <!ENTITY screensaver SYSTEM "kcmscnsave.docbook">
 <!ENTITY sysnotify SYSTEM "kcmsysnotify.docbook">
 <!ENTITY style SYSTEM "kcmstyle.docbook">
 <!ENTITY action SYSTEM "kcmaction.docbook">
 <!ENTITY mousebehav SYSTEM "kcmmousebeh.docbook">
<!-- <!ENTITY talk SYSTEM "kcmtalk.docbook"> -->
 <!ENTITY kbd SYSTEM "kcmkbd.docbook">
 <!ENTITY mouse SYSTEM "kcmmouse.docbook">
 <!ENTITY locale SYSTEM "kcmlocate.docbook">
 <!ENTITY email SYSTEM "kcmemail.docbook">
 <!ENTITY password SYSTEM "kcmpasswd.docbook">
 <!ENTITY energy SYSTEM "kcmenergy.docbook">
 <!ENTITY sndserver SYSTEM "kcmsndsrv.docbook">
 <!ENTITY loginmanager SYSTEM "kcmloginmanage.docbook">
 <!ENTITY helpindex SYSTEM "kcmhelpindex.docbook">
 <!ENTITY dma SYSTEM "kcmdmainfo.docbook">
 <!ENTITY devices SYSTEM "kcmdeviceinfo.docbook">
 <!ENTITY ioports SYSTEM "kcmioportinfo.docbook">
 <!ENTITY interrupts SYSTEM "kcmintinfo.docbook">
 <!ENTITY memory SYSTEM "kcmmemoryinfo.docbook">
 <!ENTITY pci SYSTEM "kcmpciinfo.docbook">
 <!ENTITY partitions SYSTEM "kcmpartitioninfo.docbook">
 <!ENTITY processor SYSTEM "kcmprocinfo.docbook">
 <!ENTITY scsi SYSTEM "kcmscsiinfo.docbook">
 <!ENTITY sambastatus SYSTEM "kcmsmbstat.docbook">
 <!ENTITY soundinfo SYSTEM "kcmsndinfo.docbook">
 <!ENTITY xserver SYSTEM "kcmxservinfo.docbook">
 <!ENTITY taskbar SYSTEM "kcmtaskbar.docbook">
 <!ENTITY datetime SYSTEM "kcmdatetime.docbook">
 <!ENTITY blockdev SYSTEM "kcmblockdev.docbook">
 <!ENTITY batmon SYSTEM "kcmbatmon.docbook">
 <!ENTITY lowbatcrit SYSTEM "kcmlowbatcrit.docbook">
 <!ENTITY lowbatwarn SYSTEM "kcmlowbatwarn.docbook">
 <!ENTITY pcmcia SYSTEM "kcmpcmcia.docbook">
 <!ENTITY powerctrl SYSTEM "kcmpowerctrl.docbook">
 <!ENTITY bell SYSTEM "kcmbell.docbook">
<!-- <!ENTITY iconstyle SYSTEM  "kcmiconstyle.docbook"> -->
 <!ENTITY kblayout SYSTEM "kcmkblayout.docbook">
 <!ENTITY access SYSTEM "kcmaccess.docbook">
 <!ENTITY mixer SYSTEM "kcmmixer.docbook">
 <!ENTITY crypto SYSTEM "kcmcrypto.docbook">
 <!ENTITY midi SYSTEM "kcmmidi.docbook">
 <!ENTITY nsplugins SYSTEM "kcmnetscapeplugins.docbook">
 <!ENTITY sessionman SYSTEM "kcmsessionman.docbook">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE" -- change language only here -->
 <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
 <![ %addindex; [ <!ENTITY kdedocindex SYSTEM "docindex.docbook"> ]]>
 %ents;
]>

<book lang="&language;">
<bookinfo>
<title>The &kcontrol;</title>

<authorgroup>
<author>
<firstname>Michael</firstname>
<surname>McBride</surname>
<affiliation><address><email>mpmcbride7@yahoo.com</email></address></affiliation>
</author>
</authorgroup>

<date>04/02/2001</date>
<releaseinfo>2.00.00</releaseinfo>

<abstract>
<para>This documentation describes &kde;'s control center.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kcontrol</keyword>
<keyword>configuration</keyword>
<keyword>settings</keyword>
<keyword>module</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>The &kcontrol;</title>

<para>The &kcontrol; (from now on referred to simply as <quote>the control
center</quote>) provides you with a centralized and convenient way to configure
all of your &kde; settings.</para>

<para>The control center is made up of multiple modules.  Each module is a
separate application, but the control center organizes all of these programs
into a convenient location. </para>

<tip><para>Each control center module can be executed individually</para>

<para>See section entitled <link linkend="control-center-run-indiv">Running
individual control center modules</link> for more information.</para></tip>

<para>The &kcontrol; groups the configuration modules into categories, so they
are easy to locate.  Within each category, the control center shows all the
modules in a list, so it is easier to find the right configuration
module.</para> </chapter>

<chapter id="control-center">
<title>Using The Control Center</title>

<para>This next section details the use of the control center itself.  For
information on individual modules, please see <link linkend="module">Control
Center Modules</link></para>

<sect1 id="control-center-starting">
<title>Starting the &kcontrol;</title>

<para>The &kcontrol; can be started 3 ways:</para>

<orderedlist> 
<listitem><para>By selecting <menuchoice><guimenu>K
Button</guimenu><guimenuitem>Control Center</guimenuitem></menuchoice> from the &kde; Panel.</para></listitem>
<listitem><para>By pressing
<keycombo>&Alt;<keycap>F2</keycap></keycombo>.</para>
<para>This will bring up a dialog box.  Type <command>kcontrol</command>, and
click <guibutton>Run</guibutton>.</para></listitem>
<listitem><para>You can type <command>kcontrol &amp;</command> at any command
prompt.</para></listitem> 
</orderedlist> 

<para>All three of these methods are equivalent, and produce the same
result.</para> 

</sect1>

<sect1 id="control-center-screen"> 
<title>The &kcontrol; Screen</title>

<para>When you start the control center, you are presented with a window, which
can be divided into 3 functional parts.</para>

<screenshot>
  <screeninfo>Screenshot</screeninfo>
  <mediaobject>
  <imageobject> <imagedata fileref="screenshot.png" format="PNG"> </imageobject>
  <textobject> <phrase>Screenshot</phrase> </textobject>
  <caption>
  <para>The KDE Control Center Screen</para>
  </caption>
  </mediaobject>
</screenshot> 

<para>Across the top is a menubar.  The menubar will provide you with quick
access to most of Kcontrol's features.  The menus are detailed in <link
linkend="control-center-menus">The KDE Control Center Menus</link>.</para>

<para>Along the left hand side, is a column.  This is a where you choose which
module to configure.  You can learn how to navigate through the modules in the
section called <link linkend="module-intro">Navigating Modules</link>.</para>

<para>The grey box on the lower right side (with the wizard), shows you some
useful system information. </para>

<para>In this example, we are running KDE 2.0, we started kcontrol as user
<literal>mmcbride</literal>, the computer is named
<literal>btnrg1</literal>, it is a Linux system, kernel version 2.2.16-storm, on a
Pentium II.</para>

</sect1>

<sect1 id="control-center-menus">
<title>The &kcontrol; Menus</title>

<para>This next section gives you a brief description of what each menu item
does.</para>

<sect2 id="control-center-menu-file">
<title>File Menu</title>

<para>The file menu has a single entry.</para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes the control center.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="control-center-menu-view">
<title>View Menu</title>

<para>These options determine how the module selection looks and acts.</para>

<variablelist> 
<varlistentry> 
<term><menuchoice><guimenu>View</guimenu> <guimenuitem>Mode</guimenuitem>
</menuchoice></term>

<listitem><para><action>Determines whether to use tree view, or list view for
your modules.</action></para>
<para>With tree view, each submenu appearing as an indented list.</para>
<para>With list view, when you click on a category, the categories disappear and
are replaced with the module list.  You then use an up button to return to your
categories.</para> 
</listitem>
</varlistentry>

<varlistentry> 
<term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Icon
Size</guimenuitem> </menuchoice></term> 
<listitem><para><action>Using this option, you can choose small, medium, or
large icons to select your modules.</action></para><note><para>This menu item
only controls the icon size if you are in <guilabel>Icon View</guilabel>.  Users
who use the <guilabel>Tree View</guilabel>, will not observe any effects with
this option.</para></note></listitem> 
</varlistentry> 
</variablelist> 
</sect2>

<sect2 id="control-center-menu-mod">
<title>Modules Menu</title>

<para>The modules menu, is a shortcut to take you directly to any module in the
control center.</para>

</sect2>

<sect2 id="control-center-menu-help">
<title>Help Menu</title>

<para></para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>Contents</guimenuitem>
</menuchoice></term>
<listitem><para><action>Clicking on this, will take you to the top of this
document.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>What's This?</guimenuitem>
</menuchoice></term>
<listitem><para><action>Selecting this option, changes the cursor to an arrow
with a question mark.  Now if you click on any component of the control panel
pane, you get short context sensitive help about that
item.</action></para><tip><para>This is the fastest way to get helpful advice
on what any of the controls will do.</para></tip></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Report Bug...</guimenuitem>
</menuchoice></term>
<listitem><para><action>If you discover a bug, you can select this option to
automatically collect bug information and submit it to the KDE
developers.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About Kcontrol...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Selecting this option displays a dialog box containing
copyright, author and license information.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About KDE...</guimenuitem>
</menuchoice></term>
<listitem><para><action>This will display a dialog box with contact information
reguarding the KDE project.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

<sect1 id="control-center-exiting">
<title>Exiting The KDE Control Center</title>

<para>You can exit the control center one of three ways:</para>
<itemizedlist>
<listitem><para>Select <menuchoice><guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice> from the menu bar.</para></listitem>
<listitem><para>Type 
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo> on the keyboard.</para></listitem>
<listitem><para>Click on the <emphasis>Close</emphasis> button on the frame
surrounding the control center.</para></listitem> </itemizedlist> </sect1>

<sect1 id="control-center-run-indiv">
<title>Running Individual Modules</title>

<para>You can run individual modules without running kcontrol by selecting
<menuchoice><guimenu>K Button</guimenu> <guimenuitem>Preferences</guimenuitem>
</menuchoice> from the &kde; panel.  You can then select the module you want to
run in the submenus.</para>

</sect1>

</chapter>
<!--*****************************************************************-->
<chapter id="module">
<title>The &kcontrol; Modules</title>

<para>In order to make it as easy as possible, the &kcontrol; has organized
similar options into groups.  Each group is called a module.  When you click on
the name of a module in the left window, you will be presented with the options
of the module on the right.</para> 

<para>Each module will have some or all of the following buttons:</para>

<variablelist>
<varlistentry><term>Apply</term>
<listitem><para>Clicking this button will save all changes to &kde;.  If you have changed anything, clicking <guibutton>Apply</> will take the changes in effect.</para></listitem></varlistentry>
<varlistentry><term>Reset</term>
<listitem><para>This button will <quote>Reset</quote>  the module.  The exact
effect will depend on the module.</para></listitem></varlistentry> 
<varlistentry><term>Help</term>
<listitem><para>This button will give you help specific to the current module.  The button will show you a short summary help page in the left window.  At the bottom of that window, you can click on a link to get more detailed help.</para></listitem></varlistentry>
<varlistentry><term>Default</term>
<listitem><para>This button will restore this module to its default values.  You must click "OK" to save the options.</para></listitem></varlistentry>
</variablelist>
<note><para>You must save the options of one module using <guibutton>Apply</> before you can change to a different module.</para>
<para>If you try to change without saving your options, you will be asked if you want to save your changes, or discard them.</para></note>

<sect1 id="module-intro">
<title>Navigating Modules</title>

<para>This is a list of the <emphasis>standard</emphasis> configuration modules (sorted by category)
provided by the <application role="package">KDE base</application>
package. Please note that there may be many more modules on your system if you
install additional software. </para>

<variablelist>
<varlistentry><term>File Browsing</term><listitem>
<para>
<link linkend="file-assoc">File Associations</link>,
<link linkend="file-manager">File Manager</link>,
</para>
</listitem></varlistentry>
<varlistentry><term>Help</term><listitem>
<para>
<link linkend="help-index">Help Index</link>,
</para>
</listitem></varlistentry>
<varlistentry><term>Information</term><listitem>
<para>
<!--<link linkend="blockdev">Block Device Information</link>, -->
<link linkend="dma">DMA Information</link>,
<link linkend="devices">Device Information</link>,
<link linkend="ioports">IO Port Information</link>,
<link linkend="interrupts">Interupt Information</link>,
<link linkend="memory">Memory Information</link>,
<link linkend="pci">PCI Information</link>,
<link linkend="pcmcia">PCMCIA</link>,
<link linkend="partitions">Partition Information</link>,
<link linkend="processor">Processor Information</link>,
<link linkend="scsi">SCSI Information</link>,
<link linkend="sambastatus">Samba Information</link>,
<link linkend="soundinfo">Sound Information</link>,
<link linkend="xserver">X Windows Server Information</link>
</para>
</listitem></varlistentry>
<varlistentry><term>Look and Feel</term><listitem>
<para>
<link linkend="background">Background</link>,
<!-- <link linkend="borders">Borders</link>,-->
<link linkend="color">Colors</link>,
<link linkend="desktop">Desktop</link>,
<link linkend="fonts">Fonts</link>,
<link linkend="icons">Icons</link>,
<!-- <link linkend="iconstyle">Icon Style</link>, -->
<link linkend="key-bindings">Key Bindings</link>,
<link linkend="panel">Panel</link>,
<link linkend="screensaver">Screensaver</link>,
<link linkend="sessions">Session Manager</link>,
<link linkend="style">Style</link>,
<link linkend="sys-notify">System Notifications</link>,
<link linkend="taskbar">Taskbar</link>,
<!-- <link linkend="numbername">Virtual Desktops</link>,-->
<link linkend="action">Window Behavior</link>,
<link linkend="mouse-behav">Mouse Behavior</link>
</para>
</listitem></varlistentry>

<varlistentry><term>Network</term><listitem>
<para>
<!-- <link linkend="talk">Talk Configuration</link> -->
<link linkend="windows-shares">Windows Shares</link>
</para>
</listitem></varlistentry>

<varlistentry><term>Peripherals</term><listitem>
<para>
<link linkend="kbd">Keyboard</link>,
<link linkend="mouse">Mouse</link>
</para>
</listitem></varlistentry>
<varlistentry><term>Personalization</term><listitem>
<para>
<link linkend="access">Accesability</link>,
<link linkend="locale">Country and Language</link>,
<link linkend="crypto">Crypto</link>,
<link linkend="email">E-mail</link>,
<link linkend="kblayout">Keyboard Layout</link>,
<link linkend="passwords">Passwords</link>

</para>
</listitem></varlistentry>

<varlistentry><term>Power Control</term><listitem><para>
<link linkend="batmon">Battery Monitor</link>,
<link linkend="energy">Energy</link>,
<link linkend="powerctrl">Laptop Power Control</link>,
<link linkend="lowbatcrit">Low Battery Critical</link>,
<link linkend="lowbatwarn">Low Battery Warning</link>

</para>
</listitem></varlistentry>

<varlistentry><term>Sound</term><listitem>
<para>
<link linkend="midi">Midi</link>,
<link linkend="mixer">Mixer</link>,
<link linkend="sndserver">Soundserver</link>,
<link linkend="bell">System Bell</link>
</para>
</listitem></varlistentry>

<varlistentry><term>System</term><listitem>
<para>
<link linkend="datetime">System Date and Time</link>,
<link linkend="login-manager">Login Manager</link>
<link linkend="sessions">Session Manager</link>,
</para>
</listitem></varlistentry>

<varlistentry><term>Web Browsing</term><listitem>
<para>
<link linkend="cookie">Cookies</link>,
<link linkend="ebrowse">Enhanced Browsing</link>,
<link linkend="konq-browsing">Konqueror Browser</link>,
<link linkend="nsplugins">Netscape Plugins</link>,
<link linkend="proxies">Proxies</link>,
<link linkend="user-agent">User Agent</link>,
<link linkend="windows-shares">Windows Shares</link>
</para>
</listitem></varlistentry>

</variablelist>
</sect1>

<!--****************************************-->

</chapter>


<chapter id="laptop">
<title>Laptop Modules Notes</title>

<para>In order to use the laptop modules, you must have the kernel
<acronym>APM</acronym> package installed in your kernel.  Useful information on
how to do this can be found at
<ulink url="http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html">
http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html</ulink> and in the
Battery Powered Linux mini-HOWTO at <ulink
url="http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html">
http://metalab.unc.edu/LDP/HOWTO/mini/Battery-Powered.html</ulink>.</para>

<para>If you want the <guimenuitem>suspend</guimenuitem> and
<guimenuitem>standby</guimenuitem> menu commands to work then you should install
the &Linux; <application>apmd</application> package (version 2.4 or later). If
you want to use them from non-root accounts you must mark the
<application>apm</application>  command <quote>set uid root</quote>.</para> 

<para>To do this log on as <systemitem>root</systemitem> and enter:</para>
<para>
<screen>
<prompt>%</prompt><userinput><command>chown</command> <option>root /usr/bin/apm</option>;<command>chmod</command> <option>+s /usr/bin/apm</option></userinput>
</screen></para>
<warning><para>By doing this you allow any user of your system to put it into
the suspend states - if you are the only user this should not be a
problem.</para>

<para>Also note that any program which has root access, can be a potential
security problem.  You should carefully determine if there is are any security
concerns <emphasis>before</emphasis> giving any program root
permissions.</para></warning>

</chapter>

<chapter id="modules">
<title>Modules</title>
&access;
&background;
&batmon;
<!--&blockdev;-->
&borders;
&konqbrowse;
&colors;
&cookie;
&locale;
&datetime;
&desktop;
&devices;
&dma;
&email;
&crypto;
&energy;
&enhbrowse;
&fileassoc;
&filemanage;
&fonts;
&helpindex;
&icon;
<!-- &iconstyle; -->
&ioports;
&interrupts;
&kbd;
&kblayout;
&keybind;
&powerctrl;
&loginmanager;
&lowbatcrit;
&lowbatwarn;
&memory;
&midi;
&mixer;
&mouse;
&mousebehav;
&nsplugins;

&panel;
&partitions;
&password;
&pci;
&pcmcia;
&processor;
&proxie;
&sambastatus;
&screensaver;
&scsi;
&sessionman;
&soundinfo;
&sndserver;
&style;
&bell;
&sysnotify;
<!-- &talk; -->
&taskbar;
&useragent;
<!-- &numbername; -->
&action;
&winshares;
&xserver;

</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para><application>Kcontrol</application></para>
<para>Program copyright 1997 The KDE Control Center Developers</para>
<para>Contributors:</para>

<itemizedlist>
<listitem><para>Matthias Hoelzer-Kluepfel <email>hoelzer@kde.org</email></para></listitem>
<listitem><para>Matthias Elter <email>elter@kde.org</email></para></listitem>
</itemizedlist>

<para>Documentation <trademark class="copyright">copyright 2000 Michael
McBride</trademark> <email>mpmcbride7@yahoo.com</email></para>

<para>Contributors:</para>

<itemizedlist>
<listitem><para>Paul Campbell <email>paul@taniwha.com</email></para></listitem>
<listitem><para>Helge Deller <email>helge.deller@ruhruni-bochum.de</email></para></listitem>
<listitem><para>Mark Donohoe </para></listitem>
<listitem><para>Pat Dowler</para></listitem>
<listitem><para>Duncan Haldane <email>duncan@kde.org</email></para></listitem>
<listitem><para>Steffen Hansen <email>stefh@mip.ou.dk</email>.</para></listitem>
<listitem><para>Matthias Hölzer <email>hoelzer@kde.org</email></para></listitem>
<listitem><para>Martin Jones <email>mjones@kde.org</email></para></listitem>
<listitem><para>Jost Schenck <email>jost@schenck.de</email></para></listitem>
<listitem><para>Jonathan Singer <email>jsinger@leeta.net</email></para></listitem>
<listitem><para>Thomas Tanghus<email>tanghus@earthling.net</email></para></listitem>
<listitem><para>Krishna Tateneni <email>tateneni@pluto.njcc.com></email></para></listitem>
<listitem><para>Ellis Whitehead <email>ewhitehe@uni-freiburg.de</email></para></listitem>

</itemizedlist>

&underFDL;
&underGPL;
</chapter>

<![ %addindex; [ &kdedocindex; ]]>

</book>
