help: Add general troubleshooting page: How to debug, where to report

1 files changed, 32 insertions, 0 deletions

diff --git a/help/C/troubleshooting-debug.page b/help/C/troubleshooting-debug.page
new file mode 100644
index 000000000..614f71b6a
--- /dev/null
+++ b/help/C/troubleshooting-debug.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      xmlns:its="http://www.w3.org/2005/11/its"
+      type="guide"
+      id="troubleshooting-debug">
+
+  <info>
+    <link type="guide" xref="index#troubleshooting"/>
+    <revision pkgversion="3.30" version="0.1" date="2019-01-11" status="draft"/>
+    <desc>How to get debug information for a bug report.</desc>
+    <credit type="author">
+      <name its:translate="no">Andre Klapper</name>
+      <email its:translate="no">ak-47@gmx.net</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+<title>Track down other video problems</title>
+
+<p>If you have already followed <link xref="supported-formats"/> and
+<link xref="troubleshooting-DVD"/> and a video still cannot be played, open a
+terminal window and enter the command <cmd>totem --help-gst</cmd>. This will
+show a list of available options you can use to get debug output. Often the
+problem is in an underlying plugin, for example in <sys>GStreamer</sys> and not
+in <app>Videos</app> itself.</p>
+
+<note style="info"><p>Software bugs in GStreamer can be reported in the
+<link href="https://gitlab.freedesktop.org/gstreamer">GStreamer issue tracker</link>.</p></note>
+
+</page>
+