[vlc-commits] commit: Revert "libvlc_media_get_tracks_info(): correct help" ( =?UTF-8?Q?Rafa=C3=ABl=20Carr=C3=A9=20?=)

[git at videolan.org]

vlc | branch: master | Rafaël Carré <rafael.carre at gmail.com> | Tue Nov 23 18:28:34 2010 +0100| [193aeeff9d12888728c46b21720b4fc06d9033f3] | committer: Rafaël Carré 

Revert "libvlc_media_get_tracks_info(): correct help"

This reverts commit 708a15ff0ec23067c5e2cda77b6ed3334ba18393.

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

 include/vlc/libvlc_media.h |   16 ++++++++++++++--
 1 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/include/vlc/libvlc_media.h b/include/vlc/libvlc_media.h
index 1b722e1..ccdaeae 100644
--- a/include/vlc/libvlc_media.h
+++ b/include/vlc/libvlc_media.h
@@ -486,8 +486,20 @@ VLC_PUBLIC_API void *libvlc_media_get_user_data( libvlc_media_t *p_md );
 /**
  * Get media descriptor's elementary streams description
  *
- * Note, you need to call libvlc_media_parse() before calling this function.
- * Not doing this will result in an empty array.
+ * Note, you need to play the media _one_ time with --sout="#description"
+ * Not doing this will result in an empty array, and doing it more than once
+ * will duplicate the entries in the array each time. Something like this:
+ *
+ * @begincode
+ * libvlc_media_player_t *player = libvlc_media_player_new_from_media(media);
+ * libvlc_media_add_option_flag(media, "sout=#description");
+ * libvlc_media_player_play(player);
+ * // ... wait until playing
+ * libvlc_media_player_release(player);
+ * @endcode
+ *
+ * This is very likely to change in next release, and be done at the parsing
+ * phase.
  *
  * \param p_md media descriptor object
  * \param tracks address to store an allocated array of Elementary Streams