From 75598337a90ad7dd390e81063d62c464e52ec56e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20P=C3=B6lsterl?= <sebp@k-d-w.org>
Date: Sun, 28 Oct 2012 13:48:44 +0100
Subject: [PATCH] rtsp-server: added annotations to indicate type of ownership
 transfer of return values

https://bugzilla.gnome.org/show_bug.cgi?id=680777
---
 gst/rtsp-server/rtsp-media.c         | 4 ++--
 gst/rtsp-server/rtsp-session-media.c | 6 +++---
 gst/rtsp-server/rtsp-session.c       | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/gst/rtsp-server/rtsp-media.c b/gst/rtsp-server/rtsp-media.c
index e7328c0afe..ddad38d264 100644
--- 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 7b100a6af8..c8b08d6a0f 100644
--- 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 58abc4bc8f..1c810915e2 100644
--- 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)