From 5f5f9417afacfae6896c870721b5a91d87c289eb Mon Sep 17 00:00:00 2001
From: =?utf8?q?Tim-Philipp=20M=C3=BCller?= <tim@centricular.net>
Date: Sun, 11 Dec 2005 11:53:56 +0000
Subject: [PATCH] docs/faq/using.xml: Spider no longer exists, and neither does
 gst-launch-ext.

Original commit message from CVS:
* docs/faq/using.xml:
Spider no longer exists, and neither does gst-launch-ext.
Update examples to use decodebin and playbin and put
converters in front of sinks (fixes #323726).
---
 ChangeLog          |  7 +++++++
 docs/faq/using.xml | 28 ++++++++++++++++++++--------
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 17eef29..c69db48 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2005-12-11  Tim-Philipp Müller  <tim at centricular dot net>
+
+	* docs/faq/using.xml:
+	  Spider no longer exists, and neither does gst-launch-ext.
+	  Update examples to use decodebin and playbin and put
+	  converters in front of sinks (fixes #323726).
+
 2005-12-09  Michael Smith  <msmith@fluendo.com>
 
 	* plugins/elements/gsttypefindelement.c: (find_peek),
diff --git a/docs/faq/using.xml b/docs/faq/using.xml
index f0e7ea4..41d2820 100644
--- a/docs/faq/using.xml
+++ b/docs/faq/using.xml
@@ -182,25 +182,37 @@ provide us with the necessary gdb output.  See
 You access the GStreamer command line interface using the command gst-launch.
 To decode an mp3 and play it through OSS, you could use
 <programlisting>
-gst-launch filesrc location=thesong.mp3 ! mad ! osssink
+gst-launch filesrc location=thesong.mp3 ! mad ! audioconvert !
+audioresample ! osssink
 </programlisting>.
 More examples can be found in the gst-launch man page.
         </para>
         <para>
 To automatically detect the right codec in a pipeline, try 
 <programlisting>
-gst-launch filesrc location=my-random-media-file.mpeg ! spider ! osssink
+gst-launch filesrc location=my-random-media-file.mpeg ! decodebin !
+ audioconvert ! audioresample ! osssink
 </programlisting>.
-Try replacing osssink with sdlvideosink and see what happens.
+or
+<programlisting>
+gst-launch filesrc location=my-random-media-file.mpeg ! decodebin !
+ ffmpegcolorspace ! xvimagesink
+</programlisting>
+Something more complicated:
+<programlisting>
+gst-launch filesrc location=my-random-media-file.mpeg ! decodebin name=decoder
+   decoder. ! ffmpegcolorspace ! xvimagesink
+   decoder. ! audioconvert ! audioresample ! osssink
+</programlisting>
         </para>
         <para>
-We also have a simple tool called gst-launch-ext used for debugging,
-which has predefined pipelines for you. This means you can just write
+We also have a basic media playing plugin that will take care of most things
+for you. This plugin is called playbin. Try this:
 <programlisting>
-gst-launch-ext (filename)
+gst-launch playbin uri=file:///home/joe/my-random-media-file.mpeg
 </programlisting>
-and it will play the file if the extension is supported.  Note that no effort
-has been made for uninterrupted synchronized playback using this tool.
+This should play the file if the format is supported, ie. you have all the
+necessary demuxing and decoding and some output plugins installed.
         </para>
       </answer>
     </qandaentry>
-- 
2.7.4