From bf659379cfe609b06e7271cfb9873b58c9fc7002 Mon Sep 17 00:00:00 2001
From: Seungha Yang <seungha@centricular.com>
Date: Tue, 21 Jul 2020 18:17:09 +0900
Subject: [PATCH] codecs: h264decoder: Update document with Since marks

To make documentation CI happy with the newly added APIs.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1449>
---
 gst-libs/gst/codecs/gsth264decoder.c | 21 +++++++++++++++++++++
 gst-libs/gst/codecs/gsth264picture.c |  9 ++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/gst-libs/gst/codecs/gsth264decoder.c b/gst-libs/gst/codecs/gsth264decoder.c
index cd5a1ae1f4..f8fc9914c4 100644
--- a/gst-libs/gst/codecs/gsth264decoder.c
+++ b/gst-libs/gst/codecs/gsth264decoder.c
@@ -2457,6 +2457,15 @@ gst_h264_decoder_modify_ref_pic_lists (GstH264Decoder * self)
   return TRUE;
 }
 
+/**
+ * gst_h264_decoder_set_process_ref_pic_lists:
+ * @decoder: a #GstH264Decoder
+ * @process: whether subclass is requiring reference picture modification process
+ *
+ * Called to en/disable reference picture modification process.
+ *
+ * Since: 1.18
+ */
 void
 gst_h264_decoder_set_process_ref_pic_lists (GstH264Decoder * decoder,
     gboolean process)
@@ -2464,6 +2473,18 @@ gst_h264_decoder_set_process_ref_pic_lists (GstH264Decoder * decoder,
   decoder->priv->process_ref_pic_lists = process;
 }
 
+/**
+ * gst_h264_decoder_get_picture:
+ * @decoder: a #GstH264Decoder
+ * @system_frame_number: a target system frame number of #GstH264Picture
+ *
+ * Retrive DPB and return a #GstH264Picture corresponding to
+ * the @system_frame_number
+ *
+ * Returns: (transfer full): a #GstH264Picture if successful, or %NULL otherwise
+ *
+ * Since: 1.18
+ */
 GstH264Picture *
 gst_h264_decoder_get_picture (GstH264Decoder * decoder,
     guint32 system_frame_number)
diff --git a/gst-libs/gst/codecs/gsth264picture.c b/gst-libs/gst/codecs/gsth264picture.c
index 45c28d671e..41b3571347 100644
--- a/gst-libs/gst/codecs/gsth264picture.c
+++ b/gst-libs/gst/codecs/gsth264picture.c
@@ -238,6 +238,8 @@ gst_h264_dpb_delete_unused (GstH264Dpb * dpb)
  * @dpb: a #GstH264Dpb
  *
  * Delete already outputted picture, even if they are referenced.
+ *
+ * Since: 1.18
  */
 void
 gst_h264_dpb_delete_outputed (GstH264Dpb * dpb)
@@ -552,9 +554,14 @@ gst_h264_dpb_is_full (GstH264Dpb * dpb)
 
 /**
  * gst_h264_dpb_get_picture:
+ * @dpb: a #GstH264Dpb
  * @system_frame_number The system frame number
  *
- * Returns: the picture identitifed with the specified @system_frame_number.
+ * Returns: (transfer full): the picture identified with the specified
+ * @system_frame_number, or %NULL if DPB does not contain a #GstH264Picture
+ * corresponding to the @system_frame_number
+ *
+ * Since: 1.18
  */
 GstH264Picture *
 gst_h264_dpb_get_picture (GstH264Dpb * dpb, guint32 system_frame_number)