From 1d41a8002b347627e1fdcc10105187c34a3922a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Olivier=20Cr=C3=AAte?= <olivier.crete@collabora.com>
Date: Tue, 6 Nov 2012 18:29:28 +0100
Subject: [PATCH] Document GST_DEBUG_FILE

---
 docs/gst/running.xml  | 11 +++++++++++
 tools/gst-launch.1.in |  5 +++++
 2 files changed, 16 insertions(+)

diff --git a/docs/gst/running.xml b/docs/gst/running.xml
index b6bf59a676..3aca009929 100644
--- a/docs/gst/running.xml
+++ b/docs/gst/running.xml
@@ -314,6 +314,17 @@ The variable takes a comma-separated list of tracing options to enable.
   </para>
 </formalpara>
 
+<formalpara id="GST_DEBUG_FILE">
+  <title><envar>GST_DEBUG_FILE</envar></title>
+
+  <para>
+  Set this variable to a file path to redirect all GStreamer debug
+  messages to this file. If left unset, debug messages with be output
+  unto the standard error.
+  </para>
+
+</formalpara>
+
 <formalpara id="ORC_CODE">
   <title><envar>ORC_CODE</envar></title>
 
diff --git a/tools/gst-launch.1.in b/tools/gst-launch.1.in
index 6f0a208a46..829faf149f 100644
--- a/tools/gst-launch.1.in
+++ b/tools/gst-launch.1.in
@@ -429,6 +429,11 @@ Specifies a list of plugins that are always loaded by default.  If not set,
 this defaults to the system-installed path, and the plugins installed in the
 user's home directory
 .TP
+\fBGST_DEBUG_FILE\fR
+Set this variable to a file path to redirect all GStreamer debug
+messages to this file. If left unset, debug messages with be output
+unto the standard error.
+.TP
 \fBORC_CODE\fR
 Useful Orc environment variable. Set ORC_CODE=debug to enable debuggers
 such as gdb to create useful backtraces from Orc-generated code.  Set