doc: player: mention that get_pipeline method needs unref

All other methods in docs clearly mention that an unref is needed, so should `get_pipeline()`. #1450

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1764>

diff --git a/gst-libs/gst/player/gstplayer.c b/gst-libs/gst/player/gstplayer.c
index 04148fa1d1a371188cb4d6b0f092f228a6fd8e3b..45705c6710a3aeb510849867f403968d2c7497ee 100644 (file)
--- a/gst-libs/gst/player/gstplayer.c
+++ b/gst-libs/gst/player/gstplayer.c
@@ -3680,7 +3680,9 @@ gst_player_set_mute (GstPlayer * self, gboolean val)
  * gst_player_get_pipeline:
  * @player: #GstPlayer instance
  *
- * Returns: (transfer full): The internal playbin instance
+ * Returns: (transfer full): The internal playbin instance.
+ *
+ * The caller should free it with g_object_unref()
  */
 GstElement *
 gst_player_get_pipeline (GstPlayer * self)