summaryrefslogtreecommitdiffstats
path: root/doc/kinfocenter
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit4aed2c8219774f5d797760606b8489a92ddc5163 (patch)
tree3f8c130f7d269626bf6a9447407ef6c35954426a /doc/kinfocenter
downloadtdebase-4aed2c8219774f5d797760606b8489a92ddc5163.tar.gz
tdebase-4aed2c8219774f5d797760606b8489a92ddc5163.zip
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/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc/kinfocenter')
-rw-r--r--doc/kinfocenter/Makefile.am6
-rw-r--r--doc/kinfocenter/cdinfo/Makefile.am3
-rw-r--r--doc/kinfocenter/cdinfo/index.docbook51
-rw-r--r--doc/kinfocenter/devices/Makefile.am3
-rw-r--r--doc/kinfocenter/devices/index.docbook60
-rw-r--r--doc/kinfocenter/dma/Makefile.am3
-rw-r--r--doc/kinfocenter/dma/index.docbook64
-rw-r--r--doc/kinfocenter/index.docbook341
-rw-r--r--doc/kinfocenter/interrupts/Makefile.am3
-rw-r--r--doc/kinfocenter/interrupts/index.docbook70
-rw-r--r--doc/kinfocenter/ioports/Makefile.am3
-rw-r--r--doc/kinfocenter/ioports/index.docbook64
-rw-r--r--doc/kinfocenter/memory/Makefile.am3
-rw-r--r--doc/kinfocenter/memory/index.docbook108
-rw-r--r--doc/kinfocenter/nics/Makefile.am3
-rw-r--r--doc/kinfocenter/nics/index.docbook45
-rw-r--r--doc/kinfocenter/opengl/Makefile.am2
-rw-r--r--doc/kinfocenter/opengl/index.docbook47
-rw-r--r--doc/kinfocenter/partitions/Makefile.am3
-rw-r--r--doc/kinfocenter/partitions/index.docbook56
-rw-r--r--doc/kinfocenter/pci/Makefile.am3
-rw-r--r--doc/kinfocenter/pci/index.docbook57
-rw-r--r--doc/kinfocenter/pcmcia/Makefile.am3
-rw-r--r--doc/kinfocenter/pcmcia/index.docbook38
-rw-r--r--doc/kinfocenter/processor/Makefile.am3
-rw-r--r--doc/kinfocenter/processor/index.docbook56
-rw-r--r--doc/kinfocenter/protocols/Makefile.am3
-rw-r--r--doc/kinfocenter/protocols/index.docbook39
-rw-r--r--doc/kinfocenter/samba/Makefile.am4
-rw-r--r--doc/kinfocenter/samba/index.docbook207
-rw-r--r--doc/kinfocenter/scsi/Makefile.am3
-rw-r--r--doc/kinfocenter/scsi/index.docbook56
-rw-r--r--doc/kinfocenter/sound/Makefile.am3
-rw-r--r--doc/kinfocenter/sound/index.docbook51
-rw-r--r--doc/kinfocenter/usb/Makefile.am3
-rw-r--r--doc/kinfocenter/usb/index.docbook43
-rw-r--r--doc/kinfocenter/xserver/Makefile.am3
-rw-r--r--doc/kinfocenter/xserver/index.docbook56
38 files changed, 1569 insertions, 0 deletions
diff --git a/doc/kinfocenter/Makefile.am b/doc/kinfocenter/Makefile.am
new file mode 100644
index 000000000..251280f85
--- /dev/null
+++ b/doc/kinfocenter/Makefile.am
@@ -0,0 +1,6 @@
+
+SUBDIRS = $(AUTODIRS)
+
+KDE_LANG= en
+KDE_DOCS = AUTO
+
diff --git a/doc/kinfocenter/cdinfo/Makefile.am b/doc/kinfocenter/cdinfo/Makefile.am
new file mode 100644
index 000000000..e4070c171
--- /dev/null
+++ b/doc/kinfocenter/cdinfo/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/cdinfo
diff --git a/doc/kinfocenter/cdinfo/index.docbook b/doc/kinfocenter/cdinfo/index.docbook
new file mode 100644
index 000000000..6048e5873
--- /dev/null
+++ b/doc/kinfocenter/cdinfo/index.docbook
@@ -0,0 +1,51 @@
+<?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;">
+<title>CD-ROM Information/Capabilities</title>
+<articleinfo>
+
+<authorgroup>
+<author>
+<firstname>Jahshan</firstname>
+<surname>Bhatti</surname>
+<affiliation><address><email>jabhatti91@gmail.com</email></address></affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2006-06-13</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>cd-rom</keyword>
+<keyword>capabilities information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>CD-ROM Information/Capabilities</title>
+
+<para>
+This page displays information about the attached CD-ROM drives and their capabilites,
+</para>
+
+<para>
+On &Linux;, this information is read from <filename
+class="devicefile">/proc/sys/dev/cdrom/info</filename>, which are only available if
+the <filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel.
+</para>
+
+<para>
+The user cannot modify any settings on this page.
+</para>
+
+</sect1>
+</article>
diff --git a/doc/kinfocenter/devices/Makefile.am b/doc/kinfocenter/devices/Makefile.am
new file mode 100644
index 000000000..dc255fa48
--- /dev/null
+++ b/doc/kinfocenter/devices/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/devices
diff --git a/doc/kinfocenter/devices/index.docbook b/doc/kinfocenter/devices/index.docbook
new file mode 100644
index 000000000..43eac4de9
--- /dev/null
+++ b/doc/kinfocenter/devices/index.docbook
@@ -0,0 +1,60 @@
+<?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;">
+<title>Device Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>device</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>Device Information</title>
+
+<para>
+This page displays information about the available devices,
+</para>
+
+<note>
+<para>
+The exact information displayed is system-dependent. On some systems,
+device information cannot be displayed yet.
+</para>
+</note>
+
+<para>
+On &Linux;, this information is read from <filename
+class="devicefile">/proc/devices</filename> and <filename
+class="devicefile">/proc/misc</filename>, which are only available if
+the <filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel. Devices are listed by group (Character, Block,
+or Miscellaneous). The device major number is listed, followed by an
+identifying label.
+</para>
+
+<para>
+The user cannot modify any settings on this page.
+</para>
+
+</sect1>
+</article>
diff --git a/doc/kinfocenter/dma/Makefile.am b/doc/kinfocenter/dma/Makefile.am
new file mode 100644
index 000000000..0e2aa88e7
--- /dev/null
+++ b/doc/kinfocenter/dma/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/dma
diff --git a/doc/kinfocenter/dma/index.docbook b/doc/kinfocenter/dma/index.docbook
new file mode 100644
index 000000000..75fb55c75
--- /dev/null
+++ b/doc/kinfocenter/dma/index.docbook
@@ -0,0 +1,64 @@
+<?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;">
+<title><acronym>DMA</acronym> Channel Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>DMA</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title><acronym>DMA</acronym> Channel Information</title>
+
+<para> This page displays information about the <acronym>DMA</acronym>
+(Direct Memory Access) Channels. A <acronym>DMA</acronym> channel is a
+direct connection that allows devices to transfer data to and from
+memory without going through the processor. Typically, i386-architecture
+systems (<acronym>PC</acronym>'s) have eight <acronym>DMA</acronym>
+channels (0-7). </para>
+
+<note> <para> The exact information displayed is system-dependent. On
+some systems, <acronym>DMA</acronym> Channel information cannot be
+displayed yet. </para> </note>
+
+<para> On &Linux;, this information is read from <filename
+class="devicefile">/proc/dma</filename>, which is only available if the
+<filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel. </para>
+
+<para> A list of all currently-registered (<acronym>ISA</acronym> bus)
+<acronym>DMA</acronym> channels that are in use is shown. The first
+column shows the <acronym>DMA</acronym> channel, and the second column
+shows the device which uses that channel. </para>
+
+<para>
+Unused <acronym>DMA</acronym> channels are not listed.
+</para>
+
+<para>
+The user cannot modify any settings on this page.
+</para>
+
+</sect1>
+</article>
diff --git a/doc/kinfocenter/index.docbook b/doc/kinfocenter/index.docbook
new file mode 100644
index 000000000..a62ca655d
--- /dev/null
+++ b/doc/kinfocenter/index.docbook
@@ -0,0 +1,341 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY kappname "&kinfocenter;">
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>The &infocenter;</title>
+
+<authorgroup>
+<author>
+<firstname>Michael</firstname>
+<surname>McBride</surname>
+<affiliation><address><email>mpmcbride7@yahoo.com</email></address></affiliation>
+</author>
+</authorgroup>
+
+<date>2002-07-03</date>
+<releaseinfo>3.10.00</releaseinfo>
+
+<abstract>
+<para>This documentation describes &kde;'s information center.</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kinfocenter</keyword>
+<keyword>system</keyword>
+<keyword>information</keyword>
+<keyword>module</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>The &infocenter;</title>
+
+<para>
+The &infocenter; (from now on referred to simply as <quote>the
+information center</quote>) provides you with a centralized and convenient
+overview of your &kde; and system settings.
+</para>
+
+<para>
+The information center is made up of multiple modules. Each module is a
+separate application, but the information center organizes all of these
+programs into a convenient location.
+</para>
+
+</chapter>
+
+<chapter id="info-center">
+<title>Using The &infocenter;</title>
+
+<para>
+This next section details the use of the information center itself. For
+information on individual modules, please see <link linkend="module">Info
+Center Modules</link>
+</para>
+
+<sect1 id="information-center-starting">
+<title>Starting the &infocenter;</title>
+
+<para>
+The &infocenter; can be started 3 ways:
+</para>
+
+<orderedlist>
+<listitem>
+<para>
+By selecting <menuchoice><guimenu>K
+Button</guimenu><guisubmenu>System</guisubmenu><guimenuitem>Info
+Center</guimenuitem></menuchoice> from the &kde; Panel.
+
+</para>
+</listitem>
+<listitem>
+<para>
+By pressing <keycombo
+action="simul">&Alt;<keycap>F2</keycap></keycombo>.
+</para>
+
+<para>
+This will bring up a dialog box. Type
+<userinput><command>kinfocenter</command></userinput>, and click
+<guibutton>Run</guibutton> or press <keycap>Enter</keycap>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+You can type <command>kinfocenter &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="information-center-screen">
+<title>The &infocenter; Screen</title>
+
+<para>
+When you start the information center, you are presented with a window,
+which can be divided into 3 functional parts.
+</para>
+
+<para>
+Across the top is a menubar. The menubar will provide you with quick
+access to most of &infocenter;'s features. The menus are detailed in
+<link linkend="info-center-menus">The &kde; Info Center
+Menus</link>.
+</para>
+
+<para>
+Along the left hand side, is a column. This is a where you choose which
+module to investigate. You can learn how to navigate through the modules
+in the section called <link linkend="module-intro">Navigating
+Modules</link>.
+</para>
+
+<para>
+The main panel shows you some system information.
+</para>
+
+<!--
+<para>
+In this example, we are running &kde; 2.99, we started &infocenter;
+as user <systemitem class="username">adridg</systemitem>, the computer is
+named <systemitem class="systemname">aramis</systemitem>, it is a
+FreeBSD system, Version 4.4-RELEASE, on a Pentium.
+</para> -->
+
+</sect1>
+
+<sect1 id="info-center-menus">
+<title>The &infocenter; Menus</title>
+
+<para>
+This next section gives you a brief description of what each menu item
+does.
+</para>
+
+<sect2 id="info-center-menu-file">
+<title><guimenu>File</guimenu> Menu</title>
+
+<para>
+The <guimenu>File</guimenu> menu has a single entry.
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>
+<action>Closes the info center.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="info-center-menu-help">
+<title><guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+
+</sect1>
+
+<sect1 id="info-center-exiting">
+<title>Exiting The &kde; Information Center</title>
+
+<para>
+You can exit the info 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 action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+on the keyboard.
+</para>
+</listitem>
+
+<listitem>
+<para>
+Click on the <guiicon>Close</guiicon> button on the frame surrounding
+the info center.
+</para>
+</listitem>
+</itemizedlist>
+
+</sect1>
+
+</chapter>
+
+<!--*****************************************************************-->
+
+<chapter id="module">
+<title>The &infocenter; Modules</title>
+
+<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 have installed additional
+software.
+</para>
+
+<itemizedlist>
+<listitem>
+<para><ulink url="help:/kinfocenter/devices/index.html">Devices</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/dma/index.html">DMA-Channels</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/interrupts/index.html">Interrupts</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/ioports/index.html">IO-Ports</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/memory/index.html">Memory</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/nics/index.html">Network Interfaces</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/opengl/index.html">OpenGL</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/partitions/index.html">Partitions</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/pci/index.html">PCI</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/pcmcia/index.html">PCMCIA</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/processor/index.html">Processor</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/protocols/index.html">Protocols</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/samba/index.html">Samba Status Information</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/scsi/index.html">SCSI</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/sound/index.html">Sound</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/usb/index.html">USB Devices</ulink></para>
+</listitem>
+<listitem>
+<para><ulink url="help:/kinfocenter/xserver/index.html">X-Server</ulink></para>
+</listitem>
+</itemizedlist>
+
+</sect1>
+
+<!--****************************************-->
+
+</chapter>
+
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>&infocenter;</para>
+<para>Program copyright 1997-2001 The &infocenter; 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>deller@kde.org</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 Hoelzer-Kluepfel <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>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+</chapter>
+
+</book>
+<!--
+Local Variables:
+mode: sgml
+End:
+-->
diff --git a/doc/kinfocenter/interrupts/Makefile.am b/doc/kinfocenter/interrupts/Makefile.am
new file mode 100644
index 000000000..46be8b9ce
--- /dev/null
+++ b/doc/kinfocenter/interrupts/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/interrupts
diff --git a/doc/kinfocenter/interrupts/index.docbook b/doc/kinfocenter/interrupts/index.docbook
new file mode 100644
index 000000000..b29611202
--- /dev/null
+++ b/doc/kinfocenter/interrupts/index.docbook
@@ -0,0 +1,70 @@
+<?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;">
+<title>Interrupt Request (<abbrev>IRQ</abbrev>) Lines</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>IRQ</keyword>
+<keyword>interrupts</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>Interrupt Request (<abbrev>IRQ</abbrev>) Lines in Use</title>
+
+<para>This page displays information about the Interrupt Request
+Lines in use, and the devices that use them.</para>
+
+<para>An <acronym>IRQ</acronym> is a hardware line used in a
+<acronym>PC</acronym> by (<acronym>ISA</acronym> bus) devices like
+keyboards, modems, sound cards, &etc;, to send interrupt signals to the
+processor to tell it that the device is ready to send or accept data.
+Unfortunately, there are only sixteen <acronym>IRQ</acronym>'s (0-15)
+available in the i386 (<acronym>PC</acronym>) architecture for sharing among
+the various <acronym>ISA</acronym> devices.</para>
+
+<para>Many hardware problems are the result of <acronym>IRQ</acronym>
+conflicts, when two devices try to use the same <acronym>IRQ</acronym>, or
+software is misconfigured to use a different <acronym>IRQ</acronym> from the
+one a device is actually configured for.</para>
+
+<note><para>The exact information displayed is system-dependent. On some
+systems, <acronym>IRQ</acronym> information cannot be displayed
+ yet.</para></note>
+
+<para>On &Linux;, this information is read from
+<filename class="directory">/proc/interrupts</filename>, which is only
+available if the <filename class="directory">/proc</filename>
+pseudo-filesystem is compiled into the kernel.</para>
+
+<para>The first column, is the <acronym>IRQ</acronym> number. The second
+column, is the number of interrupts that have been received since the last
+reboot. The third column shows the type of interrupt. The fourth,
+identifies the device assigned to that interrupt.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
+
diff --git a/doc/kinfocenter/ioports/Makefile.am b/doc/kinfocenter/ioports/Makefile.am
new file mode 100644
index 000000000..56e830b08
--- /dev/null
+++ b/doc/kinfocenter/ioports/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/ioports
diff --git a/doc/kinfocenter/ioports/index.docbook b/doc/kinfocenter/ioports/index.docbook
new file mode 100644
index 000000000..fa662feba
--- /dev/null
+++ b/doc/kinfocenter/ioports/index.docbook
@@ -0,0 +1,64 @@
+<?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;">
+<title>I/O Port</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>ioports</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>Input/Output Port Information</title>
+
+<para>This page displays information about the I/O ports.</para>
+
+<para>I/O Ports are memory addresses used by the processor for direct
+communication with a device that has sent an
+interrupt signal to the processor.</para>
+
+<para>The exchange of commands or data between the processor and the device
+takes place through the I/O port address of the device, which is a
+ hexadecimal
+number. No two devices can share the same I/O port. Many devices use
+ multiple
+I/O port addresses, which are expressed as a range of hexadecimal
+numbers. </para>
+
+<note><para>The exact information displayed is system-dependent. On some
+systems, I/O port information can not yet be displayed.</para></note>
+
+<para>On &Linux;, this information is read from <filename
+class="devicefile">/proc/ioports</filename> which is only available if
+the <filename class="devicefile">/proc</filename> pseudo-filesystem is
+compiled into the kernel. A list of all currently-registered I/O port
+regions that are in use is shown.</para>
+
+<para>The first column is the I/O port (or the range of I/O ports), the
+second column identifies the device that uses these I/O ports.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+</article>
diff --git a/doc/kinfocenter/memory/Makefile.am b/doc/kinfocenter/memory/Makefile.am
new file mode 100644
index 000000000..e9a9e23ef
--- /dev/null
+++ b/doc/kinfocenter/memory/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/memory
diff --git a/doc/kinfocenter/memory/index.docbook b/doc/kinfocenter/memory/index.docbook
new file mode 100644
index 000000000..19d10fc57
--- /dev/null
+++ b/doc/kinfocenter/memory/index.docbook
@@ -0,0 +1,108 @@
+<?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;">
+<title>Memory Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Mike.McBride;</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<date>2002-02-13</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>memory</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>Memory Information</title>
+
+<para>This module displays the current memory usage. It is updated
+constantly, and can be very useful for pinpointing bottlenecks when certain
+applications are executed.</para>
+
+<sect2 id="memory-intro">
+<title>Memory Types</title>
+
+<para>The first thing you must understand, is there are two types of
+<quote>memory</quote>, available to the operating system and the programs
+that run within it.</para>
+
+<para>The first type, is called physical memory. This is the memory located
+within the memory chips, within your computer. This is the
+<acronym>RAM</acronym> (for Random Access Memory) you bought when you
+purchased your computer.</para>
+
+<para>The second type of memory, is called virtual or swap memory. This
+block of memory, is actually space on the hard drive. The operating
+system reserves a space on the hard drive for <quote>swap space</quote>.
+The operating system can use this virtual memory (or swap space), if it
+runs out of physical memory. The reason this is called
+<quote>swap</quote> memory, is the operating system takes some data that
+it doesn't think you will want for a while, and saves that to disk in
+this reserved space. The operating system then loads the new data you
+need right now. It has <quote>swapped</quote> the not needed data, for
+the data you need right now. Virtual or swap memory is not as fast as
+physical memory, so operating systems try to keep data (especially often
+used data), in the physical memory.</para>
+
+<para>The total memory, is the combined total of physical memory and
+virtual memory.</para>
+
+</sect2>
+
+<sect2 id="memory-use">
+<title>Memory Information Module</title>
+
+<para>This window is divided into a top and bottom section</para>
+
+<para>The top section shows you the total physical memory, total free
+ physical memory, shared memory, and buffered memory.</para>
+
+<para>All four values are represented as the total number of bytes, and
+ as the number of megabytes (1 megabyte = slightly more than 1,000,000
+ bytes)</para>
+
+<para>The bottom section shows you three graphs: </para>
+
+<itemizedlist>
+<listitem><para><guilabel>Total Memory</guilabel> (this is the combination of physical and virtual memory).</para></listitem>
+<listitem><para><guilabel>Physical Memory</guilabel></para></listitem>
+<listitem><para>Virtual memory, or <guilabel>Swap Space</guilabel>.</para></listitem>
+</itemizedlist>
+
+<para>The green areas are free, and the red areas are used.</para>
+
+<tip><para>The exact values of each type of memory are not critical, and
+ they change regularly. When you evaluate this page, look at
+ trends.</para>
+
+<para>Does your computer have plenty of free space (green areas)? If
+ not, you can increase the swap size or increase the physical
+ memory.</para>
+
+<para>Also, if your computer seems sluggish: is your physical memory
+ full, and does the hard drive always seem to be running? This suggests
+ that you do not have enough physical memory, and your computer is
+ relying on the slower virtual memory for commonly used data. Increasing
+ your physical memory will improve the responsiveness of your
+ computer.</para></tip>
+
+</sect2>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/nics/Makefile.am b/doc/kinfocenter/nics/Makefile.am
new file mode 100644
index 000000000..73ab1b332
--- /dev/null
+++ b/doc/kinfocenter/nics/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/nics
diff --git a/doc/kinfocenter/nics/index.docbook b/doc/kinfocenter/nics/index.docbook
new file mode 100644
index 000000000..f82552c28
--- /dev/null
+++ b/doc/kinfocenter/nics/index.docbook
@@ -0,0 +1,45 @@
+<?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;">
+<title>Network Interfaces</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Lauri.Watts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-11</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>Network</keyword>
+<keyword>Interfaces</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+
+<title>Network Interfaces</title>
+
+<para>
+This page displays information about the network interfaces
+installed in your computer.
+</para>
+
+<note><para>The exact information displayed is system-dependent. On
+some systems, this information can not yet be displayed.</para></note>
+
+<para>The user cannot modify any settings on this page.</para>
+
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/opengl/Makefile.am b/doc/kinfocenter/opengl/Makefile.am
new file mode 100644
index 000000000..cc8923bc3
--- /dev/null
+++ b/doc/kinfocenter/opengl/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG= en
+KDE_DOCS = kinfocenter/opengl
diff --git a/doc/kinfocenter/opengl/index.docbook b/doc/kinfocenter/opengl/index.docbook
new file mode 100644
index 000000000..62af34008
--- /dev/null
+++ b/doc/kinfocenter/opengl/index.docbook
@@ -0,0 +1,47 @@
+<?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;">
+<title><acronym>OpenGL</acronym></title>
+<articleinfo>
+
+<authorgroup>
+<author><personname><firstname>Ilya</firstname><surname>Korniyko</surname></personname><email>k_ilya@ukr.net</email></author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<date></date>
+<releaseinfo></releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>OpenGL</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="opengl">
+
+<title>OpenGL</title>
+
+<para>This page displays information about installed <acronym>OpenGL</acronym> implementation.
+OpenGL (for "Open Graphics Library") is a cross-platform,
+hardware independent interface for 3D graphics. </para>
+
+<para><acronym>GLX</acronym> is the binding for OpenGL to X Window system.</para>
+
+<para> <acronym>DRI</acronym> (Direct Rendering Infrastucture) provides hardware acceleration for OpenGL.
+You must have a videocard with 3D accelerator and properly installed driver for this.</para>
+<para> </para>
+
+<para>Read more at the official OpenGL site <ulink url="http://www.opengl.org">http://www.opengl.org</ulink> </para>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/partitions/Makefile.am b/doc/kinfocenter/partitions/Makefile.am
new file mode 100644
index 000000000..7eab338b4
--- /dev/null
+++ b/doc/kinfocenter/partitions/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/partitions
diff --git a/doc/kinfocenter/partitions/index.docbook b/doc/kinfocenter/partitions/index.docbook
new file mode 100644
index 000000000..f3655a8cf
--- /dev/null
+++ b/doc/kinfocenter/partitions/index.docbook
@@ -0,0 +1,56 @@
+<?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;">
+<title>Partition Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>drive partition</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>Partition Information</title>
+
+<para>This page displays information about partitions on your hard
+drives.</para>
+
+<note><para>The exact information displayed is system-dependent. On
+some systems, partition information cannot be displayed
+yet.</para></note>
+
+<para>On &Linux;, this information is read from <filename
+class="devicefile">/proc/partitions</filename>, which is only available
+if the <filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the (2.1.x or later) kernel.</para>
+
+<para>The first two columns are the major and minor numbers
+respectively. The third column is the number of blocks (usually 1
+block = 1024 bytes). The fourth column is a label for the
+device.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
+
diff --git a/doc/kinfocenter/pci/Makefile.am b/doc/kinfocenter/pci/Makefile.am
new file mode 100644
index 000000000..b6702265a
--- /dev/null
+++ b/doc/kinfocenter/pci/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/pci
diff --git a/doc/kinfocenter/pci/index.docbook b/doc/kinfocenter/pci/index.docbook
new file mode 100644
index 000000000..1d4d8b3f9
--- /dev/null
+++ b/doc/kinfocenter/pci/index.docbook
@@ -0,0 +1,57 @@
+<?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;">
+<title><acronym>PCI</acronym>-bus and Installed <acronym>PCI</acronym> Cards</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>PCI</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="pci">
+
+<title><acronym>PCI</acronym>-bus and Installed <acronym>PCI</acronym>
+Cards</title>
+
+<para>This page displays information about the
+<acronym>PCI</acronym>-bus and installed <acronym>PCI</acronym> cards,
+and other devices that use the Peripheral Component Interconnect
+(<acronym>PCI</acronym>) bus.</para>
+
+<note><para>The exact information displayed is system-dependent. On some
+systems, <acronym>PCI</acronym>-information can not yet be
+displayed.</para> </note>
+
+<para>On &Linux;, this information is read from <filename
+class="devicefile">/proc/pci</filename> which is only available if the
+<filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel. A listing of all <acronym>PCI</acronym>
+devices found during kernel initialization, and their configuration, is
+shown.</para>
+
+<para>Each entry begins with a bus, device and function number.</para>
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/pcmcia/Makefile.am b/doc/kinfocenter/pcmcia/Makefile.am
new file mode 100644
index 000000000..23040b3c9
--- /dev/null
+++ b/doc/kinfocenter/pcmcia/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/pcmcia
diff --git a/doc/kinfocenter/pcmcia/index.docbook b/doc/kinfocenter/pcmcia/index.docbook
new file mode 100644
index 000000000..901fdf2e5
--- /dev/null
+++ b/doc/kinfocenter/pcmcia/index.docbook
@@ -0,0 +1,38 @@
+<?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;">
+<title><acronym>PCMCIA</acronym></title>
+<articleinfo>
+
+<authorgroup>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>Laptop</keyword>
+<keyword>PCMCIA</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="pcmcia">
+<title><acronym>PCMCIA</acronym></title>
+
+<para>This module displays information about <acronym>PCMCIA</acronym>
+Cards</para>
+
+<para>The exact information is system dependent. On most systems no
+information is displayed at all.</para>
+
+</sect1>
+</article>
diff --git a/doc/kinfocenter/processor/Makefile.am b/doc/kinfocenter/processor/Makefile.am
new file mode 100644
index 000000000..7cdf67a93
--- /dev/null
+++ b/doc/kinfocenter/processor/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/processor
diff --git a/doc/kinfocenter/processor/index.docbook b/doc/kinfocenter/processor/index.docbook
new file mode 100644
index 000000000..3794aca67
--- /dev/null
+++ b/doc/kinfocenter/processor/index.docbook
@@ -0,0 +1,56 @@
+<?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;">
+<title>Processor Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>CPU</keyword>
+<keyword>processor</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="processor">
+<title>Processor Information</title>
+
+<para>This page displays information about the system
+Central Processing Unit (<acronym>CPU</acronym>).</para>
+
+<note><para>The exact information displayed is system-dependent. On
+some systems, processor information cannot be displayed
+yet.</para></note>
+
+<para>On &Linux;, this information is read from <filename
+class="devicefile">/proc/cpuinfo</filename>, which is only available if
+the <filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel.</para>
+
+<para>The exact contents of the window will depend on the
+<acronym>CPU</acronym>(s) in your machine, but the window is organized
+into two columns. The first column is the parameter, and the second
+column is the value of that parameter.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/protocols/Makefile.am b/doc/kinfocenter/protocols/Makefile.am
new file mode 100644
index 000000000..afc73fa8a
--- /dev/null
+++ b/doc/kinfocenter/protocols/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/protocols
diff --git a/doc/kinfocenter/protocols/index.docbook b/doc/kinfocenter/protocols/index.docbook
new file mode 100644
index 000000000..a5a37658b
--- /dev/null
+++ b/doc/kinfocenter/protocols/index.docbook
@@ -0,0 +1,39 @@
+<?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;">
+<title>Protocols</title>
+
+<articleinfo>
+<authorgroup>
+<author>&Lauri.Watts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Protocols</keyword>
+<keyword>IOSlaves</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="protocols">
+<title>Protocols</title>
+
+<para>On the left of the panel you will see a list of the IOSlaves that
+are installed on your system. IOSlaves are how &kde; applications
+<quote>talk</quote> to other computers, other applications, or act on
+files.</para>
+
+<para>Clicking on an IOSlave name will display some help information
+about that IOSlave, such as how to use it, and what it does.</para>
+
+<para>The protocols module is purely informational, you cannot change
+any settings here.</para>
+
+</sect1>
+</article> \ No newline at end of file
diff --git a/doc/kinfocenter/samba/Makefile.am b/doc/kinfocenter/samba/Makefile.am
new file mode 100644
index 000000000..91de8fa54
--- /dev/null
+++ b/doc/kinfocenter/samba/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/samba
+
diff --git a/doc/kinfocenter/samba/index.docbook b/doc/kinfocenter/samba/index.docbook
new file mode 100644
index 000000000..37b14c48c
--- /dev/null
+++ b/doc/kinfocenter/samba/index.docbook
@@ -0,0 +1,207 @@
+<?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;">
+<title>Samba Status Information</title>
+<articleinfo>
+<authorgroup>
+<author>&Alexander.Neundorf;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>Samba</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="sambastatus">
+
+
+<title>Samba Status Information</title>
+
+<para>The Samba and <acronym>NFS</acronym> Status Monitor is a front end
+to the programs <command>smbstatus</command> and
+<command>showmount</command>. Smbstatus reports on current Samba
+connections, and is part of the suite of Samba tools, which implements
+the <acronym>SMB</acronym> (Session Message Block) protocol, also called
+the NetBIOS or LanManager protocol.</para>
+
+<para>This protocol can be used to provide printer sharing or drive
+sharing services on a network including machines running the various
+flavors of &Microsoft; &Windows;.</para>
+
+<para><command>showmount</command> is part of the <acronym>NFS</acronym>
+software package. <acronym>NFS</acronym> stands for Network File System
+and is the traditional &UNIX; way to share folders over the
+network. In this case the output of <command>showmount</command>
+<option>-a localhost</option> is parsed. On some systems showmount is in
+<filename class="directory">/usr/sbin</filename>, check if you have
+showmount in your <envar>PATH</envar>.</para>
+
+<sect2 id="smb-exports">
+<title>Exports</title>
+
+<para>On this page you can see a big list which shows the currently
+active connections to Samba shares and <acronym>NFS</acronym> exports of
+your machine. The first column shows you whether the resource is a Samba
+(<acronym>SMB</acronym>) share or a <acronym>NFS</acronym> export. The
+second column contains the name of the share, the third the name of the
+remote host, which accesses this share. The remaining columns have only
+a meaning for Samba-shares.</para>
+
+<para>The fourth column contains the User <abbrev>ID</abbrev> of the
+user, who accesses this share. Note that this does not have to be equal
+to the &UNIX; user <abbrev>ID</abbrev> of this user. The same applies
+for the next column, which displays the group <abbrev>ID</abbrev> of the
+user.</para>
+
+<para>Each connection to one of your shares is handled by a single
+process (<command>smbd</command>), the next column shows the process
+<abbrev>ID</abbrev> (<acronym>pid</acronym>) of this
+<command>smbd</command>. If you kill this process the connected user
+will be disconnected. If the remote user works from &Windows;, as soon
+as this process is killed a new one will be created, so he will almost
+not notice it.</para>
+
+<para>The last column shows how many files this user has currently open.
+Here you see only, how many files he has <emphasis>open</emphasis> just
+now, you don't see how many he copied or formerly opened &etc;</para>
+
+</sect2>
+
+<sect2 id="smb-imports">
+<title>Imports</title>
+
+<para> Here you see which Samba- and <acronym>NFS</acronym>-shares from
+other hosts are mounted on your local system. The first column shows
+wether it is a Samba- or <acronym>NFS</acronym>-share, the second column
+displays the name of the share, and the third shows where it is
+mounted.</para>
+
+<para>The mounted <acronym>NFS</acronym>-shares you should see on
+&Linux; (this has been tested), and it should also work on &Solaris;
+(this has not been tested).</para>
+
+</sect2>
+
+<sect2 id="smb-log">
+<title>Log</title>
+
+<para>This page presents the contents of your local samba log file in a
+nice way. If you open this page, the list will be empty. You have to
+press the <guibutton>Update</guibutton> button, then the samba log file
+will be read and the results displayed. Check whether the samba log file
+on your system is really at the location as specified in the input
+line. If it is somewhere else or if it has another name, correct
+it. After changing the file name you have to press
+<guibutton>Update</guibutton> again.</para>
+
+<para>Samba logs its actions according to the log level (see
+<filename>smb.conf</filename>). If loglevel = 1, samba logs only when
+somebody connects to your machine and when this connection is closed
+again. If log level = 2, it logs also if somebody opens a file and if he
+closes the file again. If the log level is higher than 2, yet more
+stuff is logged.</para>
+
+<para>If you are interested in who accesses your machine, and which
+files are accessed, you should set the log level to 2 and regularly
+create a new samba log file (&eg; set up a <command>cron</command> task
+which once a week moves your current samba log file into another
+folder or something like that). Otherwise your samba log file may
+become very big.</para>
+
+<para>With the four checkboxes below the big list you can decide, which
+events are displayed in the list. You have to press
+<guibutton>Update</guibutton> to see the results. If the log level of
+your samba is too low, you won't see everything.</para>
+
+<para>By clicking on the header of one column you can sort the list by
+this column.</para>
+
+</sect2>
+
+
+<sect2 id="smb-statistics">
+<title>Statistics</title>
+
+<para>On this page you can filter the contents of the third page for
+certain contents.</para>
+
+<para>Let's say the <guilabel>Event</guilabel> field (not the one in the
+list) is set to <userinput>Connection</userinput>,
+<guilabel>Service/File</guilabel> is set to <userinput>*</userinput>,
+<guilabel>Host/User</guilabel> is set to <userinput>*</userinput>,
+<guilabel>Show expanded service info</guilabel> is disabled and
+<guilabel>Show expanded host info</guilabel> is disabled.</para>
+
+<para>If you press <guibutton>Update</guibutton> now, you will see how
+often a connection was opened to share <literal>*</literal> (&ie; to any
+share) from host <literal>*</literal> (&ie; from any host). Now enable
+<guilabel>Show expanded host info</guilabel> and press
+<guibutton>Update</guibutton> again. Now you will see for every host
+which matches the wildcard <literal>*</literal>, how many connections
+were opened by him.</para>
+
+<para>Now press <guibutton>clear</guibutton>.</para>
+
+<para>Now set the <guilabel>Event</guilabel> field to File Access and
+enable <guilabel>Show expanded service info</guilabel> and press
+<guibutton>Update</guibutton> again.</para>
+
+<para>Now you will see how often every single file was accessed. If you
+enable <guilabel>Show expanded host info</guilabel> too, you will see
+how often every single user opened each file.</para>
+
+<para>In the input lines <guilabel>Service/File</guilabel> and
+<guilabel>Host/User</guilabel> you can use the wildcards
+<literal>*</literal> and <literal>?</literal> in the same way you use
+them at the command line. Regular expressions are not
+recognized.</para>
+
+<para>By clicking on the header of a column you can sort the list by
+this column. This way you can check out which file was opened most
+often, or which user opened the most files or whatever.</para>
+
+</sect2>
+
+
+<sect2 id="smb-stat-author">
+<title>Section Author</title>
+
+<para>Module copyright 2000: Michael Glauche and &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
+
+<para>Originally written by: Michael Glauche</para>
+
+<para>Currently maintained by: &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
+
+<itemizedlist>
+<title>Contributors</title>
+<listitem><para>Conversion to kcontrol applet:</para>
+<para>&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para></listitem>
+<listitem><para>Use of <classname>KProcess</classname> instead of popen, and more error checking:</para>
+<para>&David.Faure; &David.Faure.mail;</para></listitem>
+<listitem><para>Conversion to kcmodule, added tab pages 2,3,4, bug
+fixed:</para>
+<para>&Alexander.Neundorf; &Alexander.Neundorf.mail;</para></listitem>
+</itemizedlist>
+
+<para>Documentation copyright 2000 &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
+
+<para>Documentation translated to docbook by &Mike.McBride; &Mike.McBride.mail;</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+</sect2>
+</sect1>
+
+</article> \ No newline at end of file
diff --git a/doc/kinfocenter/scsi/Makefile.am b/doc/kinfocenter/scsi/Makefile.am
new file mode 100644
index 000000000..09cdb4e25
--- /dev/null
+++ b/doc/kinfocenter/scsi/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG = en
+KDE_DOCS = kinfocenter/scsi
diff --git a/doc/kinfocenter/scsi/index.docbook b/doc/kinfocenter/scsi/index.docbook
new file mode 100644
index 000000000..87ec0934f
--- /dev/null
+++ b/doc/kinfocenter/scsi/index.docbook
@@ -0,0 +1,56 @@
+<?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;">
+<title><acronym>SCSI</acronym> Interface Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>SCSI</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="scsi">
+
+<title><acronym>SCSI</acronym> Interface Information</title>
+
+<para>This page displays information about Small Computer Systems
+Interface (<acronym>SCSI</acronym>) Interfaces and the attached
+<acronym>SCSI</acronym> devices.</para>
+
+<note><para>The exact information displayed is system-dependent. On
+some systems <acronym>SCSI</acronym> information cannot be displayed
+yet.</para></note>
+
+<para>On &Linux;, this information is read from <filename
+class="devicefile">/proc/scsi/scsi</filename>, which is only available
+if the <filename class="directory">/proc</filename> pseudo-filesystem is
+compiled into the kernel. A listing of all <acronym>SCSI</acronym>
+devices known to the kernel is shown.</para>
+
+<para>The devices are sorted numerically by their host, channel, and
+<acronym>ID</acronym> numbers.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/sound/Makefile.am b/doc/kinfocenter/sound/Makefile.am
new file mode 100644
index 000000000..611f571ca
--- /dev/null
+++ b/doc/kinfocenter/sound/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/sound
diff --git a/doc/kinfocenter/sound/index.docbook b/doc/kinfocenter/sound/index.docbook
new file mode 100644
index 000000000..de1fd601d
--- /dev/null
+++ b/doc/kinfocenter/sound/index.docbook
@@ -0,0 +1,51 @@
+<?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;">
+<title>Soundcard Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Matthias.Hoelzer-Kluepfel;</author>
+<author>&Helge.Deller;</author>
+<author>&Duncan.Haldane;</author>
+<author>&Mike.McBride;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>soundcard</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="soundinfo">
+
+<title>Soundcard Information</title>
+
+<para>This page displays information about any soundcards installed in the
+system.</para>
+
+<note><para>The exact information displayed is system-dependent. On some
+systems, soundcard information cannot be displayed yet.</para></note>
+
+<para>On &Linux;, this information is read either from <filename
+class="devicefile">/dev/sndstat</filename>, if present, or from
+<filename class="devicefile">/proc/sound</filename>, which is only
+available if the <filename class="directory">/proc</filename>
+pseudo-filesystem is compiled into the (2.1.x or later) kernel.</para>
+
+<para>The user cannot modify any settings on this page.</para>
+
+</sect1>
+
+</article>
diff --git a/doc/kinfocenter/usb/Makefile.am b/doc/kinfocenter/usb/Makefile.am
new file mode 100644
index 000000000..80cc84914
--- /dev/null
+++ b/doc/kinfocenter/usb/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/usb
diff --git a/doc/kinfocenter/usb/index.docbook b/doc/kinfocenter/usb/index.docbook
new file mode 100644
index 000000000..8936fa796
--- /dev/null
+++ b/doc/kinfocenter/usb/index.docbook
@@ -0,0 +1,43 @@
+<?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;">
+<title><acronym>USB</acronym></title>
+<articleinfo>
+
+<authorgroup>
+<author>
+<firstname></firstname>
+<surname></surname>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KControl</keyword>
+<keyword>USB</keyword>
+<keyword>System Information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="usb">
+
+<title><acronym>USB</acronym></title>
+
+<para>This module allows you to see the devices attached to your
+<acronym>USB</acronym> bus(es).</para>
+
+<para>This module is for information only, you cannot edit any
+information you see here.</para>
+</sect1>
+
+</article> \ No newline at end of file
diff --git a/doc/kinfocenter/xserver/Makefile.am b/doc/kinfocenter/xserver/Makefile.am
new file mode 100644
index 000000000..f72dcdbbf
--- /dev/null
+++ b/doc/kinfocenter/xserver/Makefile.am
@@ -0,0 +1,3 @@
+
+KDE_LANG= en
+KDE_DOCS = kinfocenter/xserver
diff --git a/doc/kinfocenter/xserver/index.docbook b/doc/kinfocenter/xserver/index.docbook
new file mode 100644
index 000000000..a56e47fb3
--- /dev/null
+++ b/doc/kinfocenter/xserver/index.docbook
@@ -0,0 +1,56 @@
+<?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;" id="xserver">
+<title>X Server Information</title>
+<articleinfo>
+
+<authorgroup>
+<author>&Mike.McBride;</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<date>2002-02-12</date>
+<releaseinfo>3.00.00</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>X server</keyword>
+<keyword>system information</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1>
+<title>X Server Information</title>
+
+<para>This screen is useful for getting specific information about your
+X server and the current session of X.</para>
+
+<para>When you open this module, you are presented with some
+information. The left hand side of the window is organized into a
+tree. Some of the elements have a plus sign in front of the label.
+Clicking this sign opens a <quote>submenu</quote> related to the
+label. Clicking on a minus sign in front of a label hides the
+submenu.</para>
+
+<para>The right hand side of the window contains the individual
+values for each of the parameters on the left.</para>
+
+<para>The information presented will vary depending on your
+setup.</para>
+
+<note><para>Some setups may not be able to determine some or all of the
+parameters.</para></note>
+
+<para>You can not change any values from this menu. It is for
+information only.</para>
+
+</sect1>
+</article>