[gstreamer-bugs] [Bug 440389] New: [API 0.11] Add GST_LEVEL_FIXME

[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=440389

  GStreamer | gstreamer (core) | Ver: HEAD CVS
           Summary: [API 0.11] Add GST_LEVEL_FIXME
           Product: GStreamer
           Version: HEAD CVS
          Platform: Other
        OS/Version: All
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: Normal
         Component: gstreamer (core)
        AssignedTo: gstreamer-bugs at lists.sourceforge.net
        ReportedBy: otte at gnome.org
         QAContact: gstreamer-bugs at lists.sourceforge.net
     GNOME version: Unspecified
   GNOME milestone: Unspecified


GST_LEVEL_FIXME should be a new debug level between GST_LEVEL_WARN and
GST_LEVEL_ERROR. It's to be used for things that are yet unimplemented for
various reasons. Examples:
- features of closed formats that haven't been reverse engineered (think
various flags in demuxers)
- new features of extensible formats (think new 4CCs in AVI)
- known issues that are hard to implement. Think elements that only implement
subsets of complex formats (think SVG or SMIL)
- incomplete or prototype elements

All of these should allow the pipeline to continue working fine. But they will
probably cause the result to not be as expected. Therefore it's an important
information for people, in particular developers, looking for the failure. It
should be enabled by default in releases.

Rationale for adding this as a seperate debug level and not reusing existing
ones:
- Since it should be enabled in releases, the other category for these messages
would be ERROR. However, errors are to be used for invalid files.
- It is clearer to people reading debug output that this is a missing feature.
They don't get scared by a big "ERROR" or "WARNING" sign.
- It is easy to grep sources for FIXMEs when one wants to improve an existing
element.
- It encourages and documents a sane way to handle missing features. Currently
the behaviour of elements in these cases varies from nothing over various
debugging messages to g_warnings.


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