From 1b6c123de102f0152d296fba8771d348329ba95c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= <slavek.banko@axis.cz>
Date: Tue, 17 Nov 2020 19:52:37 +0100
Subject: Move the khelpcenter guides to the directory level in which they are
 installed.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Slávek Banko <slavek.banko@axis.cz>
---
 doc/khelpcenter/faq/sound.docbook | 53 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 doc/khelpcenter/faq/sound.docbook

(limited to 'doc/khelpcenter/faq/sound.docbook')

diff --git a/doc/khelpcenter/faq/sound.docbook b/doc/khelpcenter/faq/sound.docbook
new file mode 100644
index 000000000..feaaf6651
--- /dev/null
+++ b/doc/khelpcenter/faq/sound.docbook
@@ -0,0 +1,53 @@
+<chapter id="sound">
+<title>Troubleshooting sound problems</title>
+
+<para>&tde; uses the &arts; sound system which is complex and powerful,
+making it difficult for some users to troubleshoot when things go
+wrong. Here are some tips to help you diagnose what it's doing when your
+sound misbehaves :</para>
+
+<qandaset>
+<qandaentry>
+<question>
+<para>How can I troubleshoot sound related problems in &tde;?</para>
+</question>
+
+<answer><para> To check that sound is working independently of &arts;, make
+sure that <command>artsd</command> isn't running and then try playing sound
+through <application>XMMS</application> or another multimedia application
+that isn't a part of &tde;. If that application doesn't play sound, then
+your general sound setup is probably broken and it's not a &tde;
+problem.</para>
+
+<para>Try playing sound with
+<userinput><command>artsplay</command><option><replaceable>
+/path/to/some/soundfile</replaceable></option></userinput>. Try various
+formats, ogg, mp3 and wav. Any error messages there might be useful in
+pointing you in the right direction.</para>
+
+<para>Try setting the &arts; output method to <acronym>OSS</acronym>. In the
+&kcontrolcenter; go to <menuchoice><guimenu>Sound &amp; Multimedia</guimenu>
+<guimenuitem>Sound System</guimenuitem></menuchoice>. On the
+<guilabel>Hardware</guilabel> tab, under <guilabel>Select the audio
+device</guilabel> choose <guilabel>Open Sound System</guilabel>. If you are
+running <acronym>alsa</acronym> this will use the <acronym>OSS</acronym>
+emulation, which may give better or worse results.</para>
+
+<para>Running <userinput><command>artsd</command><option> -l
+0</option></userinput> from a terminal will give you a lot of debug output,
+some of which might help you to diagnose the problem. Trying this in
+conjunction with using <command>artsplay</command> in a second terminal can give a wealth of information. If an <application>artsd</application> instance is already running, exit it with <userinput><command>artsshell
+</command><parameter>terminate</parameter></userinput></para>
+</answer>
+</qandaentry>
+<qandaentry>
+<question><para>
+I've updated to the latest version of &tde; keeping my previous configuration and my system sounds don't work anymore!</para></question>
+<answer><para>
+Assuming you've installed &arts; correctly and you still have the codecs installed your previous &tde; installation needed, possibly there is a problem with your <filename>knotifyrc</filename>. To confirm this, try temporarily
+renaming the file. A new one will be created when starting &tde;.
+</para></answer>
+</qandaentry>
+
+</qandaset>
+</chapter>
-- 
cgit v1.2.1