[gstreamer-bugs] [Bug 323882] New: gst-launch manpage needs updates

[GStreamer (bugzilla.gnome.org)]

Do not reply to this via email (we are currently unable to handle email
responses and they get discarded).  You can add comments to this bug at
http://bugzilla.gnome.org/show_bug.cgi?id=323882
 GStreamer | gstreamer (core) | Ver: HEAD CVS

           Summary: gst-launch manpage needs updates
           Product: GStreamer
           Version: HEAD CVS
          Platform: Other
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: gstreamer (core)
        AssignedTo: gstreamer-bugs at lists.sourceforge.net
        ReportedBy: ben.pineau at gmail.com
         QAContact: gstreamer-bugs at lists.sourceforge.net
                CC: all-bugs at bugzilla.gnome.org


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.

1- OPTIONS 
  - "-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
  
2- SEE ALSO 
  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 ?)
  
3- GSTREAMER OPTIONS
  --gst-disable-cpu-opt : should be removed
  --gst-disable-debug (man) should be --gst-debug-disable
  --gst-registry : should be removed  
   
4- PIPELINE EXAMPLES

  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
    idem
    gst-launch filesrc location=music.wav ! wavparse ! audioconvert ! \
      vorbisenc  ! oggmux ! filesink location=music.ogg
  - gst-launch osssrc ! vorbisenc ! filesink location=input.ogg
    idem
    gst-launch osssrc ! audioconvert ! vorbisenc ! oggmux ! filesink \
      location=input.ogg
  - gst-launch videotestsrc ! xvideosink
    should be (I'm not shure about this one)
    gst-launch videotestsrc ! xvimagesink

Then :

Index: tools/gst-launch.1.in
===================================================================
RCS file: /cvs/gstreamer/gstreamer/tools/gst-launch.1.in,v
retrieving revision 1.10
diff -u -r1.10 gst-launch.1.in
--- tools/gst-launch.1.in       23 Nov 2005 15:49:06 -0000      1.10
+++ tools/gst-launch.1.in       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
 work.
 .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.

 .
 .SH "GSTREAMER OPTIONS"
@@ -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

 .SH "PIPELINE DESCRIPTION"

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

 .
 .SH "SEE ALSO"
-.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)
 .SH "AUTHOR"
 The GStreamer team at http://gstreamer.net/

------- You are receiving this mail because: -------
You are the assignee for the bug.
You are the QA contact for the bug.