lib: deprecate media discoverer events

include/vlc/deprecated.h

@@ -277,6 +277,18 @@ libvlc_media_discoverer_new_from_name( libvlc_instance_t * p_inst,
 LIBVLC_DEPRECATED LIBVLC_API char *
 libvlc_media_discoverer_localized_name( libvlc_media_discoverer_t * p_mdis );
 
+/**
+ * Get event manager from media service discover object.
+ *
+ * \deprecated Useless, media_discoverer events are only triggered when calling
+ * libvlc_media_discoverer_start() and libvlc_media_discoverer_stop().
+ *
+ * \param p_mdis media service discover object
+ * \return event manager object.
+ */
+LIBVLC_DEPRECATED LIBVLC_API libvlc_event_manager_t *
+libvlc_media_discoverer_event_manager( libvlc_media_discoverer_t * p_mdis );
+
 /** @}*/
 
 /**

include/vlc/libvlc_events.h

@@ -100,7 +100,15 @@ enum libvlc_event_e {
     libvlc_MediaListPlayerNextItemSet,
     libvlc_MediaListPlayerStopped,
 
+    /**
+     * \deprecated Useless event, it will be triggered only when calling
+     * libvlc_media_discoverer_start()
+     */
     libvlc_MediaDiscovererStarted=0x500,
+    /**
+     * \deprecated Useless event, it will be triggered only when calling
+     * libvlc_media_discoverer_stop()
+     */
     libvlc_MediaDiscovererEnded,
 
     libvlc_VlmMediaAdded=0x600,

include/vlc/libvlc_media_discoverer.h

@@ -138,15 +138,6 @@ libvlc_media_discoverer_release( libvlc_media_discoverer_t * p_mdis );
 LIBVLC_API libvlc_media_list_t *
 libvlc_media_discoverer_media_list( libvlc_media_discoverer_t * p_mdis );
 
-/**
- * Get event manager from media service discover object.
- *
- * \param p_mdis media service discover object
- * \return event manager object.
- */
-LIBVLC_API libvlc_event_manager_t *
-libvlc_media_discoverer_event_manager( libvlc_media_discoverer_t * p_mdis );
-
 /**
  * Query if media service discover object is running.
  *