media: ti-vpe/cal.h: fix kernel-doc formatting
authorHans Verkuil <hverkuil-cisco@xs4all.nl>
Thu, 11 Mar 2021 10:20:12 +0000 (11:20 +0100)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Mon, 22 Mar 2021 11:53:45 +0000 (12:53 +0100)
Fix inline struct member documentation, was missing the
'@memb:' prefix.

Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
drivers/media/platform/ti-vpe/cal.h

index 1b5c88dc0ab01afa652c2e3cd814a9e3cd1f56b8..db0e408eaa94a9f17c7f457ef29eabaa1a851505 100644 (file)
@@ -84,35 +84,34 @@ struct cal_buffer {
 
 /**
  * struct cal_dmaqueue - Queue of DMA buffers
- * @active: Buffer being DMA'ed to for the current frame
  */
 struct cal_dmaqueue {
        /**
-        * Protects all fields in the cal_dmaqueue.
+        * @lock: Protects all fields in the cal_dmaqueue.
         */
        spinlock_t              lock;
 
        /**
-        * Buffers queued to the driver and waiting for DMA processing.
+        * @queue: Buffers queued to the driver and waiting for DMA processing.
         * Buffers are added to the list by the vb2 .buffer_queue() operation,
         * and move to @pending when they are scheduled for the next frame.
         */
        struct list_head        queue;
        /**
-        * Buffer provided to the hardware to DMA the next frame. Will move to
-        * @active at the end of the current frame.
+        * @pending: Buffer provided to the hardware to DMA the next frame.
+        * Will move to @active at the end of the current frame.
         */
        struct cal_buffer       *pending;
        /**
-        * Buffer being DMA'ed to for the current frame. Will be retired and
-        * given back to vb2 at the end of the current frame if a @pending
-        * buffer has been scheduled to replace it.
+        * @active: Buffer being DMA'ed to for the current frame. Will be
+        * retired and given back to vb2 at the end of the current frame if
+        * a @pending buffer has been scheduled to replace it.
         */
        struct cal_buffer       *active;
 
-       /** State of the DMA engine. */
+       /** @state: State of the DMA engine. */
        enum cal_dma_state      state;
-       /** Wait queue to signal a @state transition to CAL_DMA_STOPPED. */
+       /** @wait: Wait queue to signal a @state transition to CAL_DMA_STOPPED. */
        struct wait_queue_head  wait;
 };