[gstreamer-bugs] [Bug 608127] New: Application Development Manual inconsistent about return value of GstBusFunc

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=608127
  GStreamer | documentation | git

           Summary: Application Development Manual inconsistent about
                    return value of GstBusFunc
    Classification: Desktop
           Product: GStreamer
           Version: git
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.sourceforge.net
        ReportedBy: ozamosi at flukkost.nu
         QAContact: gstreamer-bugs at lists.sourceforge.net
      GNOME target: ---
     GNOME version: ---


In the application development manual, in the document
gstreamer/docs/manual/basics-bus.xml, it says that "The return value of the
handler should be TRUE to remove the message from the bus" when explaining what
a message handler added with gst_bus_add_watch () does.

According to a comment in the code sample further down in the same document,
and the documentation for both gst_bus_add_watch and GstBusFunc, the return
value does not control whether the message should be removed from the bus or
not, but rather whether the handler should receive more messages or not.

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