[gstreamer-bugs] [Bug 570142] New: Documentation is broken for uridecodebin

[GStreamer (bugzilla.gnome.org)]

If you have any questions why you received this email, please see the text at
the end of this email. Replies to this email are NOT read, please see the text
at the end of this email. You can add comments to this bug at:
  http://bugzilla.gnome.org/show_bug.cgi?id=570142

  GStreamer | documentation | Ver: git
           Summary: Documentation is broken for uridecodebin
           Product: GStreamer
           Version: git
          Platform: Other
        OS/Version: Windows
            Status: UNCONFIRMED
          Severity: trivial
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.sourceforge.net
        ReportedBy: lrn1986 at gmail.com
         QAContact: gstreamer-bugs at lists.sourceforge.net
     GNOME version: Unspecified
   GNOME milestone: Unspecified


gsturidecodebin.c:351:55 - sudden sentence cutoff. Impossible to fix, because
this signal makes no sense for API users at all: to get a list of factories and
actually do something, application must have access to gstfactorylists.c which
is not a part of public API.

gsturidecodebin.c:368-377 and gstdecodebin.c:517-526 - description is
completely incorrect. Here is the correct one:

   * @pad: The #GstPad.
   * @caps: The #GstCaps.
   * @factory: A #GstElementFactory that could be used.
   *
   * Decides whether or not to handle given @caps with an element built by
   * @factory.
   *
   * Returns: #GST_AUTOPLUG_SELECT_TRY if @factory should be tried on @caps,
   * #GST_AUTOPLUG_SELECT_EXPOSE to prevent further autoplugging for this @caps
   * and expose it as is, #GST_AUTOPLUG_SELECT_SKIP if @factory should not be
   * tried on @caps. The default handler always returns
#GST_AUTOPLUG_SELECT_TRY


-- 
See http://bugzilla.gnome.org/page.cgi?id=email.html for more info about why you received
this email, why you can't respond via email, how to stop receiving
emails (or reduce the number you receive), and how to contact someone
if you are having problems with the system.

You can add comments to this bug at http://bugzilla.gnome.org/show_bug.cgi?id=570142.