rtsp-server: added annotations to indicate type of ownership transfer of return values

https://bugzilla.gnome.org/show_bug.cgi?id=680777

diff --git a/gst/rtsp-server/rtsp-media.c b/gst/rtsp-server/rtsp-media.c
index e7328c0..ddad38d 100644 (file)
--- a/gst/rtsp-server/rtsp-media.c
+++ b/gst/rtsp-server/rtsp-media.c
@@ -690,7 +690,7 @@ gst_rtsp_media_collect_streams (GstRTSPMedia * media)
  * Create a new stream in @media that provides RTP data on @srcpad.
  * @srcpad should be a pad of an element inside @media->element.
  *
- * Returns: a new #GstRTSPStream that remains valid for as long
+ * Returns: (transfer none): a new #GstRTSPStream that remains valid for as long
  *          as @media exists.
  */
 GstRTSPStream *
@@ -747,7 +747,7 @@ gst_rtsp_media_n_streams (GstRTSPMedia * media)
  *
  * Retrieve the stream with index @idx from @media.
  *
- * Returns: the #GstRTSPStream at index @idx or %NULL when a stream with
+ * Returns: (transfer none): the #GstRTSPStream at index @idx or %NULL when a stream with
  * that index did not exist.
  */
 GstRTSPStream *

diff --git a/gst/rtsp-server/rtsp-session-media.c b/gst/rtsp-server/rtsp-session-media.c
index 7b100a6..c8b08d6 100644 (file)
--- a/gst/rtsp-server/rtsp-session-media.c
+++ b/gst/rtsp-server/rtsp-session-media.c
@@ -124,7 +124,7 @@ gst_rtsp_session_media_new (const GstRTSPUrl * url, GstRTSPMedia * media)
  *
  * Configure the transport for @stream to @tr in @media.
  *
- * Returns: the new or updated #GstRTSPStreamTransport for @stream.
+ * Returns: (transfer none): the new or updated #GstRTSPStreamTransport for @stream.
  */
 GstRTSPStreamTransport *
 gst_rtsp_session_media_set_transport (GstRTSPSessionMedia * media,
@@ -153,8 +153,8 @@ gst_rtsp_session_media_set_transport (GstRTSPSessionMedia * media,
  *
  * Get a previously created #GstRTSPStreamTransport for the stream at @idx.
  *
- * Returns: a #GstRTSPStreamTransport that is valid until the session of @media
- * is unreffed.
+ * Returns: (transfer none): a #GstRTSPStreamTransport that is valid until the
+ * session of @media is unreffed.
  */
 GstRTSPStreamTransport *
 gst_rtsp_session_media_get_transport (GstRTSPSessionMedia * media, guint idx)

diff --git a/gst/rtsp-server/rtsp-session.c b/gst/rtsp-server/rtsp-session.c
index 58abc4b..1c81091 100644 (file)
--- a/gst/rtsp-server/rtsp-session.c
+++ b/gst/rtsp-server/rtsp-session.c
@@ -142,7 +142,7 @@ gst_rtsp_session_set_property (GObject * object, guint propid,
  *
  * Ownership is taken from @media.
  *
- * Returns: a new @GstRTSPSessionMedia object.
+ * Returns: (transfer none): a new @GstRTSPSessionMedia object.
  */
 GstRTSPSessionMedia *
 gst_rtsp_session_manage_media (GstRTSPSession * sess, const GstRTSPUrl * uri,
@@ -197,7 +197,7 @@ gst_rtsp_session_release_media (GstRTSPSession * sess,
  *
  * Get the session media of the @url.
  *
- * Returns: the configuration for @url in @sess.
+ * Returns: (transfer none): the configuration for @url in @sess.
  */
 GstRTSPSessionMedia *
 gst_rtsp_session_get_media (GstRTSPSession * sess, const GstRTSPUrl * url)