From cb80127c21904c5fa13d98c440c23f5b4beb7d06 Mon Sep 17 00:00:00 2001
From: "Ronald S. Bultje" <rbultje@ronald.bitfreak.net>
Date: Sun, 18 Apr 2004 18:37:15 +0000
Subject: [PATCH] docs/faq/troubleshooting.xml: Mention gst-register in the FAQ
 (fixes 139045).

Original commit message from CVS:
* docs/faq/troubleshooting.xml:
Mention gst-register in the FAQ (fixes 139045).
---
 ChangeLog                    |  5 +++++
 docs/faq/troubleshooting.xml | 41 ++++++++++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index ca55e0ed66..a144163b88 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-04-18  Ronald Bultje  <rbultje@ronald.bitfreak.net>
+
+	* docs/faq/troubleshooting.xml:
+	  Mention gst-register in the FAQ (fixes 139045).
+
 2004-04-17  Thomas Vander Stichele  <thomas at apestaart dot org>
 
 	* docs/gst/gstreamer-sections.txt:
diff --git a/docs/faq/troubleshooting.xml b/docs/faq/troubleshooting.xml
index d23df84e53..ec0c72df05 100644
--- a/docs/faq/troubleshooting.xml
+++ b/docs/faq/troubleshooting.xml
@@ -2,6 +2,31 @@
   <title id="title-troubleshooting">Troubleshooting GStreamer</title>
   <qandaset>
 
+    <qandaentry>
+      <question id="troubleshooting-undefined-behaviour">
+        <para>
+My GStreamer-based application crashes on startup with errors about unfound
+schedulers on the command-line. I get undefined behaviour as soon as any
+GStreamer element is being initialized.
+        </para>
+      </question>
+
+      <answer>
+        <para>
+Your registry is probably missing, or it is outdated (i.e. not updated after
+a recent upgrade). Fix this by running gst-register yourself:
+          <programlisting>
+gst-register
+          </programlisting>
+In the worst case, you might have to run it both as user and as root.
+        </para>
+        <para>
+Note that package managers are suggested to run this automatically during the
+post-installation. Our RPMs and Debian packages do just that.
+        </para>
+      </answer>
+    </qandaentry>
+
     <qandaentry>
       <question id="troubleshooting-missing-plug-in">
         <para>
@@ -62,6 +87,22 @@ What's  wrong ?
       </question>
 
       <answer>
+        <para>
+If you run GStreamer CVS uninstalled, it means that something changed in
+the core that requires a recompilation in the plugins. Recompile the
+plugins by doing "make clean &amp;&amp; make".
+        </para>
+        <para>
+If you run GStreamer installed, it probably means that you run the plugins
+against a different (incompatible) version than they were compiled against,
+which ususally means that you run multiple installations of GStreamer.
+Remove the old ones and - if needed - recompile again to ensure that it is
+using the right version.
+        </para>
+        <para>
+Note that we strongly recommend using Debian or RPM packages, since you will
+not get such issues if you use provided packages.
+        </para>
       </answer>
     </qandaentry>