From 0a68003efe44b05e03adaa263da3bb97649d8d60 Mon Sep 17 00:00:00 2001 From: Stefan Kost Date: Thu, 10 Sep 2009 10:26:23 +0300 Subject: docs: fix gtk-doc warnings --- sys/v4l2/gstv4l2bufferpool.c | 52 +++++++++++++++++++++++++++++--------------- sys/v4l2/gstv4l2object.c | 2 +- sys/v4l2/gstv4l2sink.c | 8 +++---- sys/v4l2/gstv4l2sink.h | 4 ++-- 4 files changed, 42 insertions(+), 24 deletions(-) diff --git a/sys/v4l2/gstv4l2bufferpool.c b/sys/v4l2/gstv4l2bufferpool.c index 494f46d7..bca07b9d 100644 --- a/sys/v4l2/gstv4l2bufferpool.c +++ b/sys/v4l2/gstv4l2bufferpool.c @@ -298,17 +298,19 @@ get_v4l2_object (GstElement * v4l2elem) /** - * Construct a new buffer pool + * gst_v4l2_buffer_pool_new: + * @v4l2elem: the v4l2 element (src or sink) that owns this pool + * @fd: the video device file descriptor + * @num_buffers: the requested number of buffers in the pool + * @caps: the caps to set on the buffer + * @requeuebuf: if %TRUE, and if the pool is still in the running state, a + * buffer with no remaining references is immediately passed back to v4l2 + * (VIDIOC_QBUF), otherwise it is returned to the pool of available buffers + * (which can be accessed via gst_v4l2_buffer_pool_get(). * - * @v4l2elem the v4l2 element (src or sink) that owns this pool - * @fd the video device file descriptor - * @num_buffers the requested number of buffers in the pool - * @caps the caps to set on the buffer - * @requeuebuf if TRUE, and if the pool is still in the - * running state, a buffer with no remaining references - * is immediately passed back to v4l2 (VIDIOC_QBUF), - * otherwise it is returned to the pool of available buffers - * (which can be accessed via gst_v4l2_buffer_pool_get(). + * Construct a new buffer pool. + * + * Returns: the new pool, use gst_v4l2_buffer_pool_destroy() to free resources */ GstV4l2BufferPool * gst_v4l2_buffer_pool_new (GstElement * v4l2elem, gint fd, gint num_buffers, @@ -409,7 +411,12 @@ buffer_new_failed: } } - +/** + * gst_v4l2_buffer_pool_destroy: + * @pool: the pool + * + * Free all resources in the pool and the pool itself. + */ void gst_v4l2_buffer_pool_destroy (GstV4l2BufferPool * pool) { @@ -443,9 +450,10 @@ gst_v4l2_buffer_pool_destroy (GstV4l2BufferPool * pool) } /** - * Get an available buffer in the pool + * gst_v4l2_buffer_pool_get: + * @pool: the pool * - * @pool the "this" object + * Get an available buffer in the pool */ GstV4l2Buffer * gst_v4l2_buffer_pool_get (GstV4l2BufferPool * pool) @@ -462,10 +470,13 @@ gst_v4l2_buffer_pool_get (GstV4l2BufferPool * pool) /** + * gst_v4l2_buffer_pool_qbuf: + * @pool: the pool + * @buf: the buffer to queue + * * Queue a buffer to the driver * - * @pool the "this" object - * @buf the buffer to queue + * Returns: %TRUE for success */ gboolean gst_v4l2_buffer_pool_qbuf (GstV4l2BufferPool * pool, GstV4l2Buffer * buf) @@ -483,11 +494,14 @@ gst_v4l2_buffer_pool_qbuf (GstV4l2BufferPool * pool, GstV4l2Buffer * buf) } /** + * gst_v4l2_buffer_pool_dqbuf: + * @pool: the pool + * * Dequeue a buffer from the driver. Some generic error handling is done in * this function, but any error handling specific to v4l2src (capture) or * v4l2sink (output) can be done outside this function by checking 'errno' * - * @pool the "this" object + * Returns: a buffer */ GstV4l2Buffer * gst_v4l2_buffer_pool_dqbuf (GstV4l2BufferPool * pool) @@ -590,8 +604,12 @@ gst_v4l2_buffer_pool_dqbuf (GstV4l2BufferPool * pool) /** * gst_v4l2_buffer_pool_available_buffers: - * Returns the number of buffers available to the driver, ie. buffers that + * @pool: the pool + * + * Check the number of buffers available to the driver, ie. buffers that * have been QBUF'd but not yet DQBUF'd. + * + * Returns: the number of buffers available. */ gint gst_v4l2_buffer_pool_available_buffers (GstV4l2BufferPool * pool) diff --git a/sys/v4l2/gstv4l2object.c b/sys/v4l2/gstv4l2object.c index 8f8097d6..3712b043 100644 --- a/sys/v4l2/gstv4l2object.c +++ b/sys/v4l2/gstv4l2object.c @@ -924,7 +924,7 @@ failed: } } -/** +/* * Get the list of supported capture formats, a list of * struct v4l2_fmtdesc. */ diff --git a/sys/v4l2/gstv4l2sink.c b/sys/v4l2/gstv4l2sink.c index fd792cd7..d2d5cb34 100644 --- a/sys/v4l2/gstv4l2sink.c +++ b/sys/v4l2/gstv4l2sink.c @@ -309,7 +309,7 @@ gst_v4l2sink_finalize (GstV4l2Sink * v4l2sink) } -/** +/* * State values */ enum @@ -319,7 +319,7 @@ enum STATE_STREAMING }; -/** +/* * flags to indicate which overlay properties the user has set (and therefore * which ones should override the defaults from the driver) */ @@ -598,7 +598,7 @@ gst_v4l2sink_set_caps (GstBaseSink * bsink, GstCaps * caps) return TRUE; } -/** buffer alloc function to implement pad_alloc for upstream element */ +/* buffer alloc function to implement pad_alloc for upstream element */ static GstFlowReturn gst_v4l2sink_buffer_alloc (GstBaseSink * bsink, guint64 offset, guint size, GstCaps * caps, GstBuffer ** buf) @@ -651,7 +651,7 @@ gst_v4l2sink_buffer_alloc (GstBaseSink * bsink, guint64 offset, guint size, } } -/** called after A/V sync to render frame */ +/* called after A/V sync to render frame */ static GstFlowReturn gst_v4l2sink_show_frame (GstBaseSink * bsink, GstBuffer * buf) { diff --git a/sys/v4l2/gstv4l2sink.h b/sys/v4l2/gstv4l2sink.h index 2d5cadb8..71553cba 100644 --- a/sys/v4l2/gstv4l2sink.h +++ b/sys/v4l2/gstv4l2sink.h @@ -59,13 +59,13 @@ struct _GstV4l2Sink { GstV4l2BufferPool *pool; guint32 num_buffers; - /** + /* * field to store requested overlay-top/left/width/height props: * note, could maybe be combined with 'vwin' field in GstV4l2Object? */ struct v4l2_rect overlay; - /** + /* * bitmask to track which 'overlay' fields user has requested by * setting properties: */ -- cgit