tracer: declare GstTracer API stable

It's been around for more than 4 years and people have built
lots of stuff on top of it, doesn't really make sense to keep
it marked as unstable. We're unlikely to change it now, and
we can always deprecate it and make a new one if needed.

This stabilises the following API:
- gst_tracer_register()
- gst_tracing_get_active_tracers()
- gst_tracing_register_hook()
- gst_tracer_record_new()
- gst_tracer_record_log()

Might also help a bit with #424

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/576>

gst/gsttracer.c

@@ -32,8 +32,6 @@
  * Since: 1.8
  */
 
-#define GST_USE_UNSTABLE_API
-
 #include "gst_private.h"
 #include "gstenumtypes.h"
 #include "gsttracer.h"

gst/gsttracer.h

@@ -63,8 +63,6 @@ struct _GstTracerClass {
 GST_API
 GType gst_tracer_get_type          (void);
 
-#ifdef GST_USE_UNSTABLE_API
-
 GST_API
 void gst_tracing_register_hook (GstTracer *tracer, const gchar *detail,
   GCallback func);
@@ -77,8 +75,6 @@ gboolean gst_tracer_register (GstPlugin * plugin, const gchar * name, GType type
 GST_API
 GList* gst_tracing_get_active_tracers (void);
 
-#endif
-
 G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstTracer, gst_object_unref)
 
 G_END_DECLS

gst/gsttracerrecord.c

@@ -30,8 +30,6 @@
  * Since: 1.8
  */
 
-#define GST_USE_UNSTABLE_API
-
 #include "gst_private.h"
 #include "gstenumtypes.h"
 #include "gstinfo.h"

gst/gsttracerrecord.h

@@ -91,8 +91,6 @@ typedef enum
   GST_TRACER_VALUE_FLAGS_AGGREGATED = (1 << 1),
 } GstTracerValueFlags;
 
-#ifdef GST_USE_UNSTABLE_API
-
 GST_API
 GstTracerRecord * gst_tracer_record_new (const gchar * name, const gchar * firstfield, ...);
 
@@ -103,8 +101,6 @@ void              gst_tracer_record_log (GstTracerRecord *self, ...);
 #define gst_tracer_record_log(...) G_STMT_START {} G_STMT_END
 #endif
 
-#endif
-
 G_END_DECLS
 
 #endif /* __GST_TRACER_RECORD_H__ */

gst/gsttracerutils.c

@@ -31,8 +31,6 @@
  * and needs to be done before any pipeline state is set to PAUSED.
  */
 
-#define GST_USE_UNSTABLE_API
-
 #include "gst_private.h"
 #include "gsttracer.h"
 #include "gsttracerfactory.h"

gst/meson.build

@@ -251,7 +251,7 @@ libgst = library('gstreamer-1.0', gst_sources,
 )
 
 if build_gir
-  gst_gir_extra_args = gir_init_section + [ '--c-include=gst/gst.h', '-DGST_USE_UNSTABLE_API' ]
+  gst_gir_extra_args = gir_init_section + ['--c-include=gst/gst.h']
   if meson.is_subproject()
     # FIXME: There must be a better way to do this
     # Need to pass the include path to find gst/gst.h and gst/gstenumtypes.h (built)

plugins/tracers/meson.build

@@ -20,13 +20,11 @@ if cdata.has('HAVE_GETRUSAGE')
   gst_tracers_sources += ['gstrusage.c']
 endif
 
-tracers_args = gst_c_args + ['-DGST_USE_UNSTABLE_API']
-
 thread_dep = dependency('threads', required : false)
 
 gst_tracers = library('gstcoretracers',
   gst_tracers_sources,
-  c_args : tracers_args,
+  c_args : gst_c_args,
   include_directories : [configinc],
   dependencies : [gst_dep, thread_dep],
   install : true,

tests/check/meson.build

@@ -125,7 +125,6 @@ test_defines = [
   '-UG_DISABLE_CAST_CHECKS',
   '-DGST_CHECK_TEST_ENVIRONMENT_BEACON="GST_STATE_IGNORE_ELEMENTS"',
   '-DTESTFILE="' + meson.current_source_dir() + '/meson.build"',
-  '-DGST_USE_UNSTABLE_API',
   '-DGST_DISABLE_DEPRECATED',
 ]