From fb8e2c60a2d83a829795887f745929d4a5b94f01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= <sebastian@centricular.com>
Date: Sat, 4 May 2024 11:56:05 +0300
Subject: [PATCH] play: Mention that gst_play_new() also initialized GStreamer

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/6821>
---
 girs/GstPlay-1.0.gir                                        | 5 ++++-
 girs/GstPlayer-1.0.gir                                      | 5 ++++-
 subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c     | 3 +++
 subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c | 3 +++
 4 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/girs/GstPlay-1.0.gir b/girs/GstPlay-1.0.gir
index d23dfd923e..0f1dabaf68 100644
--- a/girs/GstPlay-1.0.gir
+++ b/girs/GstPlay-1.0.gir
@@ -345,7 +345,10 @@ of its queued messages, thus breaking any possible reference cycle.</doc>
 
 Video is going to be rendered by @video_renderer, or if %NULL is provided
 no special video set up will be done and some default handling will be
-performed.</doc>
+performed.
+
+This also initializes GStreamer via `gst_init()` on the first call if this
+didn't happen before.</doc>
         <source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.h"/>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c">a new #GstPlay instance</doc>
diff --git a/girs/GstPlayer-1.0.gir b/girs/GstPlayer-1.0.gir
index 6e153adef2..92efe7e756 100644
--- a/girs/GstPlayer-1.0.gir
+++ b/girs/GstPlayer-1.0.gir
@@ -337,7 +337,10 @@ passed. See gst_player_g_main_context_signal_dispatcher_new().
 
 Video is going to be rendered by @video_renderer, or if %NULL is provided
 no special video set up will be done and some default handling will be
-performed.</doc>
+performed.
+
+This also initializes GStreamer via `gst_init()` on the first call if this
+didn't happen before.</doc>
         <source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.h"/>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c">a new #GstPlayer instance</doc>
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c b/subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c
index 46b37833bb..64adcd12d9 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/play/gstplay.c
@@ -2738,6 +2738,9 @@ gst_play_init_once (G_GNUC_UNUSED gpointer user_data)
  * no special video set up will be done and some default handling will be
  * performed.
  *
+ * This also initializes GStreamer via `gst_init()` on the first call if this
+ * didn't happen before.
+ *
  * Returns: (transfer full): a new #GstPlay instance
  * Since: 1.20
  */
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c b/subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c
index b9f93f8367..ad78731ae4 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/player/gstplayer.c
@@ -625,6 +625,9 @@ gst_player_constructed (GObject * object)
  * no special video set up will be done and some default handling will be
  * performed.
  *
+ * This also initializes GStreamer via `gst_init()` on the first call if this
+ * didn't happen before.
+ *
  * Returns: (transfer full): a new #GstPlayer instance
  */
 GstPlayer *