From 7b1958c8de4a53f630df8d46e28578a3b610856d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Corentin=20No=C3=ABl?= <corentin.noel@collabora.com>
Date: Fri, 26 Nov 2021 10:12:50 +0100
Subject: [PATCH] pushsrc: Add missing annotations

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/1392>
---
 subprojects/gstreamer/libs/gst/base/gstpushsrc.h | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/subprojects/gstreamer/libs/gst/base/gstpushsrc.h b/subprojects/gstreamer/libs/gst/base/gstpushsrc.h
index 7dd53b6f07..d0d8cef9b7 100644
--- a/subprojects/gstreamer/libs/gst/base/gstpushsrc.h
+++ b/subprojects/gstreamer/libs/gst/base/gstpushsrc.h
@@ -70,10 +70,20 @@ struct _GstPushSrc {
 struct _GstPushSrcClass {
   GstBaseSrcClass parent_class;
 
-  /* ask the subclass to create a buffer, the default implementation
-   * uses alloc and fill */
+  /**
+   * GstPushSrcClass::create:
+   * @buf: (inout):
+   *
+   * Ask the subclass to create a buffer, the default implementation will call alloc if
+   * no allocated @buf is provided and then call fill.
+   */
   GstFlowReturn (*create) (GstPushSrc *src, GstBuffer **buf);
-  /* allocate memory for a buffer */
+  /**
+   * GstPushSrcClass::alloc:
+   * @buf: (out):
+   *
+   * Allocate memory for a buffer.
+   */
   GstFlowReturn (*alloc)  (GstPushSrc *src, GstBuffer **buf);
   /* ask the subclass to fill a buffer */
   GstFlowReturn (*fill)   (GstPushSrc *src, GstBuffer *buf);