various documentation fixes

parent 38af8831
......@@ -255,7 +255,7 @@ static inline int __var_SetInteger( vlc_object_t *p_obj, const char *psz_name, i
*
* \param p_obj The object that holds the variable
* \param psz_name The name of the variable
* \param i The new integer value of this variable
* \param b The new boolean value of this variable
*/
static inline int __var_SetBool( vlc_object_t *p_obj, const char *psz_name, vlc_bool_t b )
{
......
......@@ -34,14 +34,14 @@
* Must be entered with playlist lock
*
* \param p_playlist the playlist to get the info from
* \param i_item position of the item on
* which we want the info ( -1 for current )
* \param i_pos position of the item on
* which we want the info ( -1 for current )
* \param psz_cat the category in which the info is stored
* \param psz_name the name of the info
* \return the info value if any, an empty string else
*/
*/
char * playlist_GetInfo( playlist_t *p_playlist, int i_pos,
const char * psz_cat, const char *psz_name )
const char *psz_cat, const char *psz_name )
{
playlist_item_t *p_item;
char *psz_buffer;
......@@ -117,7 +117,6 @@ info_category_t * playlist_ItemGetCategory( playlist_item_t *p_item,
/**
* Create one info category for an item ( no p_playlist required )
*
* \param p_playlist the playlist
* \param p_item the item to create category for
* \param psz_cat the category we want to create
* \return the info category.
......
......@@ -152,7 +152,7 @@ playlist_item_t * playlist_ItemGetById( playlist_t * p_playlist , int i_id )
* This function must be entered with the playlist lock
*
* \param p_playlist the playlist
* \param i_id the id to find
* \param i_pos the position of the item to find
* \return the item, or NULL on failure
*/
playlist_item_t * playlist_ItemGetByPos( playlist_t * p_playlist , int i_pos )
......@@ -181,6 +181,7 @@ playlist_item_t * playlist_ItemGetByPos( playlist_t * p_playlist , int i_pos )
* Set the group of a playlist item
*
* \param p_item the item
* \param i_group the group to set
* \return VLC_SUCCESS on success
*/
int playlist_ItemSetGroup( playlist_item_t *p_item, int i_group)
......@@ -281,7 +282,7 @@ int playlist_SetName( playlist_t *p_playlist, int i_pos, char *psz_name )
* This function must be entered with the item lock
*
* \param p_item the item
* \param psz_name the new name
* \param i_duration the new duration
* \return VLC_SUCCESS on success, VLC_EGENERIC on failure
*/
int playlist_ItemSetDuration( playlist_item_t *p_item, mtime_t i_duration )
......
......@@ -32,6 +32,7 @@
/**
* Create a new item, without adding it to the playlist
*
* \param p_obj a vlc object (anyone will do)
* \param psz_uri the mrl of the item
* \param psz_name a text giving a name or description of the item
* \return the new item or NULL on failure
......@@ -254,7 +255,7 @@ int playlist_AddItem( playlist_t *p_playlist, playlist_item_t *p_item,
* Add a option to one item ( no need for p_playlist )
*
* \param p_item the item on which we want the info
* \param psz_format the option
* \param psz_option the option
* \return 0 on success
*/
int playlist_ItemAddOption( playlist_item_t *p_item, const char *psz_option )
......
......@@ -79,6 +79,7 @@ void vout_DisplaySubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
* already allocated zone of memory in the spu data fields. It needs locking
* since several pictures can be created by several producers threads.
* \param p_vout the vout in which to create the subpicture
* \param i_channel the channel this subpicture should belong to
* \param i_type the type of the subpicture
* \return NULL on error, a reserved subpicture otherwise
*/
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment