From: Tim-Philipp Müller <tim@centricular.com>
Date: Fri, 16 Oct 2015 14:59:49 +0000 (+0100)
Subject: docs: mention xdot utility to view .dot files directly
X-Git-Tag: 1.12.0~924
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=bc5c199bc507222a62d1d6ba0584b8b8d5c05b23;p=platform%2Fupstream%2Fgstreamer.git

docs: mention xdot utility to view .dot files directly
---

diff --git a/docs/gst/running.xml b/docs/gst/running.xml
index 103aebb897..b034e6abbd 100644
--- a/docs/gst/running.xml
+++ b/docs/gst/running.xml
@@ -361,6 +361,11 @@ from the graphviz set of tools, like this:
   <command>dot foo.dot -Tpng -o foo.png</command> or
   <command>dot foo.dot -Tjpg -o foo.jpg</command>.
   </para>
+  <para>
+There is also a utility called <command>xdot</command> which allows you to
+view the dot file directly without converting it first.
+  </para>
+
 
 </formalpara>
 
diff --git a/gst/gstdebugutils.h b/gst/gstdebugutils.h
index 06618f9d9b..8363e2dc9f 100644
--- a/gst/gstdebugutils.h
+++ b/gst/gstdebugutils.h
@@ -73,10 +73,12 @@ void gst_debug_bin_to_dot_file_with_ts (GstBin *bin, GstDebugGraphDetails detail
  *
  * To aid debugging applications one can use this method to write out the whole
  * network of gstreamer elements that form the pipeline into an dot file.
- * This file can be processed with graphviz to get an image.
+ * This file can be processed with graphviz to get an image, like this:
  * <informalexample><programlisting>
  *  dot -Tpng -oimage.png graph_lowlevel.dot
  * </programlisting></informalexample>
+ * There is also a utility called xdot which allows you to view the dot file
+ * directly without converting it first.
  *
  * The macro is only active if gstreamer is configured with
  * &quot;--gst-enable-gst-debug&quot; and the environment variable
diff --git a/tools/gst-launch.1.in b/tools/gst-launch.1.in
index c04ddc6719..409727ffa3 100644
--- a/tools/gst-launch.1.in
+++ b/tools/gst-launch.1.in
@@ -429,7 +429,8 @@ When this environment variable is set, coloured debug output is disabled.
 When set to a filesystem path, store 'dot' files of pipeline graphs there.
 These can then later be converted into an image using the 'dot' utility from
 the graphviz set of tools, like this: dot foo.dot -Tsvg -o foo.svg (png or jpg
-are also possible as output format)
+are also possible as output format). There is also a utility called 'xdot'
+which allows you to view the .dot file directly without converting it first.
 .TP
 \fBGST_REGISTRY\fR
 Path of the plugin registry file. Default is