docs: minor documentation fixes for recently-added tags

Mention the type of the tag in the gtk-doc blurb, so people know
which accessor API to use, and fix up the doc blurbs to match the
actual tag define.
This commit is contained in:
Tim-Philipp Müller 2010-01-06 20:06:47 +00:00
parent 27fd0b8d9c
commit 1474e7a9fa

View file

@ -791,33 +791,33 @@ gboolean gst_tag_list_get_buffer_index (const GstTagList * list,
*/
#define GST_TAG_GEO_LOCATION_ELEVATION "geo-location-elevation"
/**
* GST_TAG_TV_SHOW
* GST_TAG_SHOW_NAME
*
* Name of the show of the media, used for displaying
* Name of the show, used for displaying (string)
*
* Since: 0.10.26
*/
#define GST_TAG_SHOW_NAME "show-name"
/**
* GST_TAG_TV_SHOW_SORTNAME
* GST_TAG_SHOW_SORTNAME
*
* Name of the show of the media, used for sorting
* Name of the show, used for sorting (string)
*
* Since: 0.10.26
*/
#define GST_TAG_SHOW_SORTNAME "show-sortname"
/**
* GST_TAG_EPISODE_NUMBER
* GST_TAG_SHOW_EPISODE_NUMBER
*
* Number of the episode within a season/show
* Number of the episode within a season/show (unsigned integer)
*
* Since: 0.10.26
*/
#define GST_TAG_SHOW_EPISODE_NUMBER "show-episode-number"
/**
* GST_TAG_SEASON_NUMBER
* GST_TAG_SHOW_SEASON_NUMBER
*
* Number of the season of a show/series
* Number of the season of a show/series (unsigned integer)
*
* Since: 0.10.26
*/
@ -825,7 +825,7 @@ gboolean gst_tag_list_get_buffer_index (const GstTagList * list,
/**
* GST_TAG_LYRICS
*
* The lyrics of the media
* The lyrics of the media (string)
*
* Since: 0.10.26
*/
@ -833,7 +833,7 @@ gboolean gst_tag_list_get_buffer_index (const GstTagList * list,
/**
* GST_TAG_COMPOSER_SORTNAME
*
* The composer's name, used for sorting
* The composer's name, used for sorting (string)
*
* Since: 0.10.26
*/
@ -842,11 +842,12 @@ gboolean gst_tag_list_get_buffer_index (const GstTagList * list,
* GST_TAG_GROUPING
*
* Groups together media that are related and spans multiple tracks. An
* example are multiple pieces of a concerto.
* example are multiple pieces of a concerto. (string)
*
* Since: 0.10.26
*/
#define GST_TAG_GROUPING "grouping"
G_END_DECLS
#endif /* __GST_TAGLIST_H__ */