[gstreamer-bugs] [Bug 575922] New: disabling subsystems cause API break

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

  GStreamer | gstreamer (core) | Ver: git
           Summary: disabling subsystems cause API break
           Product: GStreamer
           Version: git
          Platform: Other
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: gstreamer (core)
        AssignedTo: gstreamer-bugs at lists.sourceforge.net
        ReportedBy: ensonic at sonicpulse.de
         QAContact: gstreamer-bugs at lists.sourceforge.net
     GNOME version: Unspecified
   GNOME milestone: Unspecified


running configure with e.g. --disable-dst-debug causes the debug system beeing
compiled out. What I propose is to handle this more like we handle deprecated
api. There we have DISABLE_DEPRECATED and REMOVE_DEPRECATED. The first hides it
from the headers, so that people get compiler warnings, but existing binaries
would run. The 2nd would cause the api break, which is not serious, if all
software builds with with DISABLE_DEPRECATED.

Now for the subsystems we could GST_DISABLE_GST_DEBUG could remove it from the
header as it already does. In the .c file we could use:

#ifndef GST_DISABLE_GST_DEBUG

// normal api here

#else /* !GST_DISABLE_GST_DEBUG */
#ifndef GST_REMOVE_DISABLED

// dummy api here

#endif /* GST_REMOVE_DISABLED */
#endif /* GST_DISABLE_GST_DEBUG */

This would require someone to build using
make CFLAGS=-DGST_REMOVE_DISABLED to force the API break here.
(this is in sync with: make CFLAGS=-DGST_REMOVE_DEPRECATED)


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