vlc/vlc-1.1 | branch: master | Rémi Denis-Courmont <[email protected]> | Sat Nov 6 18:39:57 2010 +0200| [7c3dd2e62dae7892cc4b090c2602e7e178e0907d] | committer: Rémi Denis-Courmont
libvlc_media_new_(location|path): try to clarify the difference (cherry picked from commit a67fbfcd732babd4d5acc2f5c71898a43e43bcd9) > http://git.videolan.org/gitweb.cgi/vlc/vlc-1.1.git/?a=commit;h=7c3dd2e62dae7892cc4b090c2602e7e178e0907d --- 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 03b68ee..67be998 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
