From 3cfe16cc63e89ba1d37c6f32034a142f5dac847b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= Date: Wed, 4 Mar 2009 21:30:30 +0000 Subject: photography: declare interface as unstable API by means of a warning Application developers won't know right away which module an interface comes from, and may assume that it is covered by the usual GStreamer API guarantees, so make it as clear as possible that this particular API is still subject to change (should have done that with other libraries in -bad before too really). --- gst-libs/gst/interfaces/Makefile.am | 2 +- gst-libs/gst/interfaces/photography.h | 5 +++++ 2 files changed, 6 insertions(+), 1 deletion(-) (limited to 'gst-libs/gst') diff --git a/gst-libs/gst/interfaces/Makefile.am b/gst-libs/gst/interfaces/Makefile.am index 5b6977fc..d7ee304b 100644 --- a/gst-libs/gst/interfaces/Makefile.am +++ b/gst-libs/gst/interfaces/Makefile.am @@ -28,7 +28,7 @@ libgstphotography_@GST_MAJORMINOR@_la_SOURCES = \ nodist_libgstphotography_@GST_MAJORMINOR@_la_SOURCES = \ $(built_sources) -libgstphotography_@GST_MAJORMINOR@_la_CFLAGS = $(GST_CFLAGS) +libgstphotography_@GST_MAJORMINOR@_la_CFLAGS = $(GST_CFLAGS) -DGST_USE_UNSTABLE_API libgstphotography_@GST_MAJORMINOR@_la_LIBADD = $(GST_LIBS) libgstphotography_@GST_MAJORMINOR@_la_LDFLAGS = $(GST_LIB_LDFLAGS) $(GST_ALL_LDFLAGS) $(GST_LT_LDFLAGS) diff --git a/gst-libs/gst/interfaces/photography.h b/gst-libs/gst/interfaces/photography.h index afa4631a..b7f6b940 100644 --- a/gst-libs/gst/interfaces/photography.h +++ b/gst-libs/gst/interfaces/photography.h @@ -24,6 +24,11 @@ #ifndef __GST_PHOTOGRAPHY_H__ #define __GST_PHOTOGRAPHY_H__ +#ifndef GST_USE_UNSTABLE_API +#warning "The GstPhotography interface is unstable API and may change in future." +#warning "You can define GST_USE_UNSTABLE_API to avoid this warning." +#endif + #include #include -- cgit v1.2.1