docs: Add annotations for return values

Rephrase and clarify some return value descriptions

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=725521
This commit is contained in:
Sebastian Rasmussen 2014-03-02 12:54:08 +01:00 committed by Tim-Philipp Müller
parent 5b4f2ba20b
commit 35bb1b3328
4 changed files with 9 additions and 8 deletions

View file

@ -2751,8 +2751,8 @@ gst_rtsp_connection_set_ip (GstRTSPConnection * conn, const gchar * ip)
*
* Get the file descriptor for reading.
*
* Returns: the file descriptor used for reading or %NULL on error. The file
* descriptor remains valid until the connection is closed.
* Returns: (transfer none): the file descriptor used for reading or %NULL on
* error. The file descriptor remains valid until the connection is closed.
*/
GSocket *
gst_rtsp_connection_get_read_socket (const GstRTSPConnection * conn)
@ -2769,8 +2769,8 @@ gst_rtsp_connection_get_read_socket (const GstRTSPConnection * conn)
*
* Get the file descriptor for writing.
*
* Returns: the file descriptor used for writing or NULL on error. The file
* descriptor remains valid until the connection is closed.
* Returns: (transfer none): the file descriptor used for writing or NULL on
* error. The file descriptor remains valid until the connection is closed.
*/
GSocket *
gst_rtsp_connection_get_write_socket (const GstRTSPConnection * conn)

View file

@ -273,7 +273,7 @@ gst_rtsp_transport_get_mime (GstRTSPTransMode trans, const gchar ** mime)
/**
* gst_rtsp_transport_get_media_type:
* @transport: a #GstRTSPTransport
* @media_type: media type of @transport
* @media_type: (out): media type of @transport
*
* Get the media type of @transport. This media type is typically
* used to generate #GstCaps events.

View file

@ -393,7 +393,8 @@ unescape_path_component (gchar * comp)
* Also note that since paths usually start with a slash, the first component
* will usually be the empty string.
*
* Returns: a string vector. g_strfreev() after usage.
* Returns: (transfer full): %NULL-terminated array of URL components. Free with
* g_strfreev() when no longer needed.
*/
gchar **
gst_rtsp_url_decode_path_components (const GstRTSPUrl * url)

View file

@ -2776,8 +2776,8 @@ gst_video_format_get_info (GstVideoFormat format)
* Get the default palette of @format. This the palette used in the pack
* function for paletted formats.
*
* Returns: the default palette of @format or %NULL when @format does not have a
* palette.
* Returns: (transfer none): the default palette of @format or %NULL when
* @format does not have a palette.
*
* Since: 1.2
*/