After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 323882 - gst-launch manpage needs updates
gst-launch manpage needs updates
Product: GStreamer
Classification: Platform
Component: gstreamer (core)
git master
Other Linux
: Normal normal
: 0.10.1
Assigned To: GStreamer Maintainers
GStreamer Maintainers
Depends on:
Reported: 2005-12-12 15:00 UTC by Benjamin Pineau
Modified: 2005-12-17 14:21 UTC
See Also:
GNOME target: ---
GNOME version: 2.13/2.14

Description Benjamin Pineau 2005-12-12 15:00:00 UTC
This list is incomplete (I need to test all examples 
on "PIPELINE EXAMPLES"). Also the patch included don't
fix the "PIPELINE EXAMPLES" errors noted there.

  - "-m, --messages                Output messages" is missing
  - "-t, --trace" => -t should be replaced with -T
  - -t, --tags                    Output tags (also known as metadata)
    is missing 
  - "-i, --iterations=N" : this option isn't valid anymore
  this section refers to inexistant gst-register(1) and
  gst-complete(1). By the way, it could refers to 
  but not gst-feedback(1)
  gst-md5sum(1), gst-typefind(1), gst-visualise(1), gst-xmllaunch(1)
  or gst-xmlinspect(1)
  (question: should it refers to gst-launch-ext(1), that is not in
  gstreamer module but gst-plugins-base ?)
  --gst-disable-cpu-opt : should be removed
  --gst-disable-debug (man) should be --gst-debug-disable
  --gst-registry : should be removed  

  Attention ! those errors aren't adressed on the patch, since I've 
  not enough time just now (and knowledge) to test/fix them all. A 
  patch to come later. So this list of bad examples is incomplete:

  - gst-launch filesrc location=music.mp3 ! mad ! vorbisenc ! \
      filesink location=music.ogg
    doesn't work. should be:
    gst-launch filesrc location=music.mp3 ! mad ! audioconvert ! \
      vorbisenc ! oggmux ! filesink location=music.ogg
  - gst-launch  filesrc  location=music.wav  !  wavparse  ! \
      vorbisenc  ! filesink location=music.ogg
    gst-launch filesrc location=music.wav ! wavparse ! audioconvert ! \
      vorbisenc  ! oggmux ! filesink location=music.ogg
  - gst-launch osssrc ! vorbisenc ! filesink location=input.ogg
    gst-launch osssrc ! audioconvert ! vorbisenc ! oggmux ! filesink \
  - gst-launch videotestsrc ! xvideosink
    should be (I'm not shure about this one)
    gst-launch videotestsrc ! xvimagesink

Then :

Index: tools/
RCS file: /cvs/gstreamer/gstreamer/tools/,v
retrieving revision 1.10
diff -u -r1.10
--- tools/       23 Nov 2005 15:49:06 -0000      1.10
+++ tools/       12 Dec 2005 14:53:57 -0000
@@ -35,12 +35,15 @@
 .B  \-f, \-\-no_fault
 Do not install a fault handler
 .TP 8
-.B  \-t, \-\-trace
+.B  \-T, \-\-trace
 Print memory allocation traces. The feature must be enabled at compile time to
 .TP 8
-.B  \-i, \-\-iterations=N
-Stop processing after N iterations.
+.B  \-t, \-\-tags
+Output tags (also known as metadata).
+.TP 8
+.B  \-m, \-\-messages
+Output messages.

@@ -75,17 +78,12 @@
 ANSI escape sequences.  Using this option causes \fIGStreamer\fP
 to print messages without color.
 .TP 8
-.B  \-\-gst\-disable\-debug
+.B  \-\-gst\-debug\-disable
 Disables debugging.
 .TP 8
 .B  \-\-gst\-debug\-help
 Prints a list of available debug categories and their default debugging level.
 .TP 8
-.B  \-\-gst\-disable\-cpu\-opt
-\fIGStreamer\fP normally automatically detects the capabilities of the
-current CPU and selects the optimal implementation for some functions.
-Using this flag disables detection, which is useful for debugging.
-.TP 8
 .B  \-\-gst\-plugin\-spew
 \fIGStreamer\fP info flags to set
 Enable printout of errors while loading \fIGStreamer\fP plugins
@@ -99,9 +97,6 @@
 .TP 8
 .B  \-\-gst\-scheduler=SCHEDULER
 Use SCHEDULER as the default scheduler
-.TP 8
-.B  \-\-gst\-registry=REGISTRY
-Use the file REGISTRY as registry instead of the default


@@ -385,8 +380,12 @@

-.BR gst\-complete (1),
-.BR gst\-register (1),
+.BR gst\-feedback (1),
+.BR gst\-md5sum (1),
+.BR gst\-typefind (1),
+.BR gst\-visualise (1),
+.BR gst\-xmllaunch (1),
+.BR gst\-xmlinspect (1),
 .BR gst\-inspect (1)
 The GStreamer team at
Comment 1 Tim-Philipp Müller 2005-12-17 14:21:15 UTC
Aiee, there was a LOT that needed to be updated :)

Thanks for your list. Should be fixed in CVS.

2005-12-17  Tim-Philipp Müller  <tim at centricular dot net>

        * tools/
          Update gst-launch man page; add a section with useful
          environment variables. Fixes #323882.