From 2937e429ecaab9c6b07a13ce1b219b7ae663b7fe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rafa=C5=82=20Dzi=C4=99giel?= Date: Sun, 16 Nov 2025 13:25:59 +0100 Subject: [PATCH] clapper: Deprecate Discoverer feature It was ported to Clapper Enhancers repo as a plugin and applications using old one should slowy move towards using new implementation instead. --- src/lib/clapper/clapper-enums.h | 2 ++ .../clapper/features/discoverer/clapper-discoverer.c | 10 ++++++++++ .../clapper/features/discoverer/clapper-discoverer.h | 8 ++++---- 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/lib/clapper/clapper-enums.h b/src/lib/clapper/clapper-enums.h index 6f398bbb..818108bc 100644 --- a/src/lib/clapper/clapper-enums.h +++ b/src/lib/clapper/clapper-enums.h @@ -119,6 +119,8 @@ typedef enum * @CLAPPER_DISCOVERER_DISCOVERY_NONCURRENT: Only run discovery on an item if it is not a currently selected item in [class@Clapper.Queue]. * This mode is optimal when application always plays (or at least goes into paused) after selecting item from queue. * It will skip discovery of such items since they will be discovered by [class@Clapper.Player] anyway. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ typedef enum { diff --git a/src/lib/clapper/features/discoverer/clapper-discoverer.c b/src/lib/clapper/features/discoverer/clapper-discoverer.c index c9497434..19881894 100644 --- a/src/lib/clapper/features/discoverer/clapper-discoverer.c +++ b/src/lib/clapper/features/discoverer/clapper-discoverer.c @@ -36,6 +36,8 @@ * * Use [const@Clapper.HAVE_DISCOVERER] macro to check if Clapper API * was compiled with this feature. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ #include @@ -369,6 +371,8 @@ clapper_discoverer_unprepare (ClapperFeature *feature) * Creates a new #ClapperDiscoverer instance. * * Returns: (transfer full): a new #ClapperDiscoverer instance. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ ClapperDiscoverer * clapper_discoverer_new (void) @@ -385,6 +389,8 @@ clapper_discoverer_new (void) * @mode: a #ClapperDiscovererDiscoveryMode * * Set the [enum@Clapper.DiscovererDiscoveryMode] of @discoverer. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ void clapper_discoverer_set_discovery_mode (ClapperDiscoverer *self, ClapperDiscovererDiscoveryMode mode) @@ -409,6 +415,8 @@ clapper_discoverer_set_discovery_mode (ClapperDiscoverer *self, ClapperDiscovere * Get the [enum@Clapper.DiscovererDiscoveryMode] of @discoverer. * * Returns: a currently set #ClapperDiscovererDiscoveryMode. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ ClapperDiscovererDiscoveryMode clapper_discoverer_get_discovery_mode (ClapperDiscoverer *self) @@ -498,6 +506,8 @@ clapper_discoverer_class_init (ClapperDiscovererClass *klass) * ClapperDiscoverer:discovery-mode: * * Discoverer discovery mode. + * + * Deprecated: 0.10: Use Media Scanner from `clapper-enhancers` repo instead. */ param_specs[PROP_DISCOVERY_MODE] = g_param_spec_enum ("discovery-mode", NULL, NULL, CLAPPER_TYPE_DISCOVERER_DISCOVERY_MODE, DEFAULT_DISCOVERY_MODE, diff --git a/src/lib/clapper/features/discoverer/clapper-discoverer.h b/src/lib/clapper/features/discoverer/clapper-discoverer.h index f3bbdcd7..2055c9e5 100644 --- a/src/lib/clapper/features/discoverer/clapper-discoverer.h +++ b/src/lib/clapper/features/discoverer/clapper-discoverer.h @@ -33,16 +33,16 @@ G_BEGIN_DECLS #define CLAPPER_TYPE_DISCOVERER (clapper_discoverer_get_type()) #define CLAPPER_DISCOVERER_CAST(obj) ((ClapperDiscoverer *)(obj)) -CLAPPER_API +CLAPPER_DEPRECATED G_DECLARE_FINAL_TYPE (ClapperDiscoverer, clapper_discoverer, CLAPPER, DISCOVERER, ClapperFeature) -CLAPPER_API +CLAPPER_DEPRECATED ClapperDiscoverer * clapper_discoverer_new (void); -CLAPPER_API +CLAPPER_DEPRECATED void clapper_discoverer_set_discovery_mode (ClapperDiscoverer *discoverer, ClapperDiscovererDiscoveryMode mode); -CLAPPER_API +CLAPPER_DEPRECATED ClapperDiscovererDiscoveryMode clapper_discoverer_get_discovery_mode (ClapperDiscoverer *discoverer); G_END_DECLS