[Bug 658192] New: Documentation instructions produce what appears as a false negative.

[GStreamer (bugzilla.gnome.org)]

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

           Summary: Documentation instructions produce what appears as a
                    false negative.
    Classification: Platform
           Product: GStreamer
           Version: unspecified
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: neon_bikini at hotmail.com
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


Parole audio player reports this error:
"A text/uri-list decoder plugin is required to play this stream, but not
installed."

I searched gstreamer support for troubleshooting this problem. This provides
the following support recommendations:

1) List plugins installed, 
Documentation:
[url=http://gstreamer.freedesktop.org/data/doc/gstreamer/head/faq/html/chapter-using.html#using-gst-inspect]
"To do this you use the gst-inspect command-line tool, which comes standard
with GStreamer. Invoked without any arguments,"
   $ gst-inspect

This step outputs this related plugin, "text/uri-list:ram". From this I assume
ram is supported. I want to add support for m3u. The next page continues with
more troubleshooting information.

2) Check that I have a plugin that I am supposed to have from (1) above:
Documentation:
[url=http://gstreamer.freedesktop.org/data/doc/gstreamer/head/faq/html/chapter-troubleshooting.html]
"Q: Some application is telling me that I am missing a plug-in. What do I do ?
A: Well, start by checking if you really are missing the plug-in."
   $ gst-inspect (plug-in)

3) Typing various permutations of the output from (1) using the instructions in
(2):
# gst-inspect text/uri-list
text/uri-list: a typefind function
[root at xtiansimonibm Xtian]# gst-inspect text/uri-list:ram
No such element or plugin 'text/uri-list:ram'
[root at xtiansimonibm Xtian]# gst-inspect text/uri-list: ram
No such element or plugin 'ram'
[root at xtiansimonibm Xtian]# gst-inspect ram
No such element or plugin 'ram'

Producing what appears to me as a false negative. Certainly all command line
tools only output based on what you put in. At the very least these
instructions should communicate how to create positive test output.

-- 
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.