[vlc-commits] lib: deprecate media discoverer events

[Thomas Guillem]

vlc | branch: master | Thomas Guillem <thomas at gllm.fr> | Fri Jun 10 14:30:51 2016 +0200| [518cbeadcebc8cfb69708b082e680caca1247a1a] | committer: Thomas Guillem

lib: deprecate media discoverer events

> http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=518cbeadcebc8cfb69708b082e680caca1247a1a
---

 include/vlc/deprecated.h              |   12 ++++++++++++
 include/vlc/libvlc_events.h           |    8 ++++++++
 include/vlc/libvlc_media_discoverer.h |    9 ---------
 3 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/include/vlc/deprecated.h b/include/vlc/deprecated.h
index 0a1277a..5a65043 100644
--- a/include/vlc/deprecated.h
+++ b/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 );
+
 /** @}*/
 
 /**
diff --git a/include/vlc/libvlc_events.h b/include/vlc/libvlc_events.h
index c5aecca..462fe7f 100644
--- a/include/vlc/libvlc_events.h
+++ b/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,
diff --git a/include/vlc/libvlc_media_discoverer.h b/include/vlc/libvlc_media_discoverer.h
index 6dd86f1..79b8e43 100644
--- a/include/vlc/libvlc_media_discoverer.h
+++ b/include/vlc/libvlc_media_discoverer.h
@@ -139,15 +139,6 @@ 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.
  *
  * \param p_mdis media service discover object