vlc | branch: master | Rémi Denis-Courmont <[email protected]> | Sat Nov 6 18:39:57 2010 +0200| [a67fbfcd732babd4d5acc2f5c71898a43e43bcd9] | committer: Rémi Denis-Courmont
libvlc_media_new_(location|path): try to clarify the difference > http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=a67fbfcd732babd4d5acc2f5c71898a43e43bcd9 --- include/vlc/libvlc_media.h | 12 +++++++++--- 1 files changed, 9 insertions(+), 3 deletions(-) diff --git a/include/vlc/libvlc_media.h b/include/vlc/libvlc_media.h index b9a114a..e0e7705 100644 --- a/include/vlc/libvlc_media.h +++ b/include/vlc/libvlc_media.h @@ -171,12 +171,18 @@ typedef struct libvlc_media_track_info_t /** - * Create a media with a certain given media resource location. + * Create a media with a certain given media resource location, + * for instance a valid URL. + * + * \note To refer to a local file with this function, + * the file://... URI syntax <b>must</b> be used (see IETF RFC3986). + * We recommend using libvlc_media_new_path() instead when dealing with + * local files. * * \see libvlc_media_release * * \param p_instance the instance - * \param psz_mrl the MRL to read + * \param psz_mrl the media location * \return the newly created media or NULL on error */ VLC_PUBLIC_API libvlc_media_t *libvlc_media_new_location( @@ -184,7 +190,7 @@ VLC_PUBLIC_API libvlc_media_t *libvlc_media_new_location( const char * psz_mrl ); /** - * Create a media with a certain file path. + * Create a media for a certain file path. * * \see libvlc_media_release * _______________________________________________ vlc-commits mailing list [email protected] http://mailman.videolan.org/listinfo/vlc-commits
