summaryrefslogtreecommitdiffstats
path: root/doc/kcontrol/bell
diff options
context:
space:
mode:
Diffstat (limited to 'doc/kcontrol/bell')
-rw-r--r--doc/kcontrol/bell/Makefile.am2
-rw-r--r--doc/kcontrol/bell/index.docbook74
2 files changed, 76 insertions, 0 deletions
diff --git a/doc/kcontrol/bell/Makefile.am b/doc/kcontrol/bell/Makefile.am
new file mode 100644
index 000000000..dbbc3935c
--- /dev/null
+++ b/doc/kcontrol/bell/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = kcontrol/bell
diff --git a/doc/kcontrol/bell/index.docbook b/doc/kcontrol/bell/index.docbook
new file mode 100644
index 000000000..2974c0707
--- /dev/null
+++ b/doc/kcontrol/bell/index.docbook
@@ -0,0 +1,74 @@
+<?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>
+<firstname>Pat</firstname>
+<surname>Dowler</surname>
+</author>
+
+<author>
+<firstname>Matthias</firstname>
+<surname>Hoelzer</surname>
+</author>
+
+<author>
+<firstname>Mike</firstname>
+<surname>McBride</surname>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+<date>2003-10-16</date>
+<releaseinfo>3.2</releaseinfo>
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>Bell</keyword>
+<keyword>Settings</keyword>
+</keywordset>
+</articleinfo>
+
+<sect1 id="bell">
+<title>System bell</title>
+
+<para>The system bell or beep is a feature of the X server, which
+attempts to make good use of the available hardware. </para>
+
+<para>&kde; normally doesn't use the system bell; instead using its
+own system notifications, which could include log entries, message
+popups, or its own beep. You can configure these in the
+<guilabel>System Notifications</guilabel> &kcontrol; module.</para>
+
+<note><para>It isn't always possible for the X server to actually make
+a beep sound with exactly the parameters selected due to hardware
+limitations. For example, on most PCs, volume control is not very good
+so the X server seems to fake low volume with a reduced duration of
+the sound. Thus, if the settings don't seem to do anything, this is
+because the X server and/or the hardware don't support anything
+better.</para></note>
+
+<para>Users are able to set the following parameters for the bell:</para>
+
+<itemizedlist>
+<listitem> <para>volume (percentage of <quote>maximum</quote> volume)</para> </listitem>
+<listitem> <para>pitch (in Hz)</para> </listitem>
+<listitem> <para>duration (in milliseconds)</para> </listitem>
+</itemizedlist>
+
+<para>You can use the <guibutton>test</guibutton> button to hear how
+the current settings will sound.</para>
+
+<sect2 id="bell-author"><title>Section Authors</title>
+<para>Pat Dowler, Matthias Hoelzer <email>mhk@kde.org</email></para>
+<para>Converted to KDE 2.0 by Mike McBride <email>mpmcbride7@yahoo.com</email></para>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+</sect2>
+</sect1>
+
+</article>