From cdbc5ea65ce29482bc76610d31419c352924fd16 Mon Sep 17 00:00:00 2001
From: Thomas Vander Stichele <thomas@apestaart.org>
Date: Sun, 3 Nov 2002 13:50:21 +0000
Subject: updates

Original commit message from CVS:
updates
---
 tools/gst-launch-ext   |  7 +++++--
 tools/gst-launch-ext.1 | 24 +++++++++++++++++++++++-
 2 files changed, 28 insertions(+), 3 deletions(-)

(limited to 'tools')

diff --git a/tools/gst-launch-ext b/tools/gst-launch-ext
index 3515accb..aab72f87 100755
--- a/tools/gst-launch-ext
+++ b/tools/gst-launch-ext
@@ -51,6 +51,7 @@ sub read_config
   else
   {
     print "No configuration file $config_file found.  You might want to create one.\n";
+    print "This is not an error, just a friendly reminder... Check the man page.\n\n";
   }
   if (!defined $cfg{AUDIOSINK})  { $cfg{AUDIOSINK} = "osssink"; }
   if (!defined $cfg{VIDEOSINK})  { $cfg{VIDEOSINK} = "colorspace ! xvideosink"; }
@@ -60,9 +61,11 @@ sub read_config
 sub playfile($$)
 {
     my ($file, $ext) = @_;
+    my $command;
+    my $pipe;
+
     $ext = lc $ext;
 
-    my $pipe;
     if ($cfg{VISUALIZER} && ($pipe = $pipes{"vis." . $ext}))
     {
 	$command = "gst-launch filesrc location=\"$file\" ! $pipe";
@@ -123,7 +126,7 @@ while ($file = shift @ARGV) {
     my $ext = extension ($file);
     if (!$ext) { 
       print "file $file doesn't have an extension !\n";
-      return -1;
+      exit;
     }
     if ($ext eq 'm3u')
     {
diff --git a/tools/gst-launch-ext.1 b/tools/gst-launch-ext.1
index 6918f856..f8345205 100644
--- a/tools/gst-launch-ext.1
+++ b/tools/gst-launch-ext.1
@@ -5,12 +5,34 @@ gst\-launch\-ext \- Run a predefined GStreamer pipeline
 \fBgst\-launch\-ext\fR \fIfilename [filename...]\fR
 .SH "DESCRIPTION"
 .LP 
-\fIgst\-launch\-ext\fP is a tool that is used to run a basic predefined \fIGStreamer\fP pipeline.
+\fIgst\-launch\-ext\fP is a tool that is used to run a basic predefined 
+\fIGStreamer\fP pipeline.  This application is only used as a quick test to 
+ensure proper working of codecs and GStreamer.  It doesn't handle more advanced
+features like synchronisation.
 
 All supported formats in GStreamer should be playable by simply typing:
 
  gst\-launch\-ext filename
 
+It will also print out the pipeline it uses, so you can customize it using
+cut and paste.
+
+.SH "CONFIGURATION"
+.LP 
+\fIgst\-launch\-ext\fP can be configured by creating a .gst file in your
+home directory.  This is a perl-style configuration file and can override
+the defaults for audio and video output sinks.
+
+Here is an example .gst file that implements the same defaults as hard-coded
+in the script :
+
+$cfg{AUDIOSINK} = "osssink";
+$cfg{VIDEOSINK} = "colorspace ! xvideosink";
+
+You can change osssink to any of esdsink, alsasink, jacksink (if you have
+the plug-in), and you can change xvideosink to aasink or sdlvideosink.
+
+Other plug-ins might be used as well if GStreamer has them.
 
 .SH "SEE ALSO"
 .BR gst\-guilaunch (1),
-- 
cgit