codecs: Fix some documentation

Add missing "transfer full" annotation, etc

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

diff --git a/gst-libs/gst/codecs/gsth264picture.c b/gst-libs/gst/codecs/gsth264picture.c
index fb8a3b7..16f7a20 100644 (file)
--- a/gst-libs/gst/codecs/gsth264picture.c
+++ b/gst-libs/gst/codecs/gsth264picture.c
@@ -370,7 +370,6 @@ gst_h264_dpb_get_long_ref_by_pic_num (GstH264Dpb * dpb, gint pic_num)
 /**
  * gst_h264_dpb_get_lowest_frame_num_short_ref:
  * @dpb: a #GstH264Dpb
- * @pic_num: a picture number
  *
  * Find a short term reference picture which has the lowest frame_num_wrap
  *
@@ -402,7 +401,7 @@ gst_h264_dpb_get_lowest_frame_num_short_ref (GstH264Dpb * dpb)
 /**
  * gst_h264_dpb_get_pictures_not_outputted:
  * @dpb: a #GstH264Dpb
- * @out: (out): a list of #GstH264Dpb
+ * @out: (out) (transfer full): a list of #GstH264Picture
  *
  * Retrieve all not-outputted pictures from @dpb
  */
@@ -426,7 +425,7 @@ gst_h264_dpb_get_pictures_not_outputted (GstH264Dpb * dpb, GList ** out)
 /**
  * gst_h264_dpb_get_pictures_short_term_ref:
  * @dpb: a #GstH264Dpb
- * @out: (out): a list of #GstH264Dpb
+ * @out: (out) (transfer full): a list of #GstH264Picture
  *
  * Retrieve all short-term reference pictures from @dpb
  */
@@ -450,7 +449,7 @@ gst_h264_dpb_get_pictures_short_term_ref (GstH264Dpb * dpb, GList ** out)
 /**
  * gst_h264_dpb_get_pictures_long_term_ref:
  * @dpb: a #GstH264Dpb
- * @out: (out): a list of #GstH264Dpb
+ * @out: (out) (transfer full): a list of #GstH264Picture
  *
  * Retrieve all long-term reference pictures from @dpb
  */

diff --git a/gst-libs/gst/codecs/gsth265picture.c b/gst-libs/gst/codecs/gsth265picture.c
index cf51c59..41eaa43 100644 (file)
--- a/gst-libs/gst/codecs/gsth265picture.c
+++ b/gst-libs/gst/codecs/gsth265picture.c
@@ -333,7 +333,7 @@ gst_h265_dpb_get_ref_by_poc (GstH265Dpb * dpb, gint poc)
 }
 
 /**
- * gst_h265_dpb_get_ref_by_poc:
+ * gst_h265_dpb_get_ref_by_poc_lsb:
  * @dpb: a #GstH265Dpb
  * @poc_lsb: a picture order count lsb
  *
@@ -422,7 +422,7 @@ gst_h265_dpb_get_long_ref_by_poc (GstH265Dpb * dpb, gint poc)
 /**
  * gst_h265_dpb_get_pictures_not_outputted:
  * @dpb: a #GstH265Dpb
- * @out: (out): a list of #GstH265Dpb
+ * @out: (out) (transfer full): a list of #GstH265Dpb
  *
  * Retrieve all not-outputted pictures from @dpb
  */

diff --git a/gst-libs/gst/codecs/gstvp9picture.c b/gst-libs/gst/codecs/gstvp9picture.c
index a66632c..adddc1f 100644 (file)
--- a/gst-libs/gst/codecs/gstvp9picture.c
+++ b/gst-libs/gst/codecs/gstvp9picture.c
@@ -41,7 +41,6 @@ _gst_vp9_picture_free (GstVp9Picture * picture)
 
 /**
  * gst_vp9_picture_new:
- * @buffer: (transfer none): a #GstBuffer
  *
  * Create new #GstVp9Picture
  *