[Bug 708331] New: gst-launch manpage could explain debug-levels better

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=708331
  GStreamer | documentation | unspecified

           Summary: gst-launch manpage could explain debug-levels better
    Classification: Platform
           Product: GStreamer
           Version: unspecified
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: piotr5 at users.sf.net
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


first off, is there any difference between the environment var GST_DEBUG and
the commandline-option --gst-debug? if not then this should be mentioned. but
the major issue here is that man-page merely mentions the possibility to
increase debug level, and suggests to use --gst-debug-help to get more info.
this way that option gets too little emphasis, which is strange for a tool
that's supposed to be merely a sandbox for testing out pipelines. there
certainly are parts that can be debugged and that do not depend on whatever
external plugins. please make a choice of the most useful debug options and put
them into the man-page with the GST_DEBUG or --gst-debug info. it's good to see
some examples for gst-launch usage, but for a programmer more interesting would
be to also see examples for how to learn more about what is happening under the
hood. maybe also a section called troubleshooting could be added. there
frequently asked questions could be addressed with some fitting debug-levels.
in other words, please put more emphasis on the possibility of debugging within
the man-page. at least to me, now that I know of this possibility, gst isn't as
frightening a beast as it was before...

-- 
Configure bugmail: https://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.