diff mbox series

[-next] dmaengine: xilinx: xdma: Fix some kernel-doc comments

Message ID 20230214010344.5354-1-yang.lee@linux.alibaba.com (mailing list archive)
State Accepted
Commit b771baf3988a094c5129b05f1e5eaa383f1ec185
Headers show
Series [-next] dmaengine: xilinx: xdma: Fix some kernel-doc comments | expand

Commit Message

Yang Li Feb. 14, 2023, 1:03 a.m. UTC
Make the description of @xdma_chan to @xchan to silence the warnings:

drivers/dma/xilinx/xdma.c:283: warning: Function parameter or member 'xchan' not described in 'xdma_xfer_start'
drivers/dma/xilinx/xdma.c:283: warning: Excess function parameter 'xdma_chan' description in 'xdma_xfer_start'

Reported-by: Abaci Robot <abaci@linux.alibaba.com>
Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=4051
Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
---
 drivers/dma/xilinx/xdma.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comments

Peter Korsgaard Feb. 14, 2023, 9:19 a.m. UTC | #1
>>>>> "Yang" == Yang Li <yang.lee@linux.alibaba.com> writes:

 > Make the description of @xdma_chan to @xchan to silence the warnings:
 > drivers/dma/xilinx/xdma.c:283: warning: Function parameter or member 'xchan' not described in 'xdma_xfer_start'
 > drivers/dma/xilinx/xdma.c:283: warning: Excess function parameter 'xdma_chan' description in 'xdma_xfer_start'

 > Reported-by: Abaci Robot <abaci@linux.alibaba.com>
 > Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=4051
 > Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>

Acked-by: Peter Korsgaard <peter@korsgaard.com>

> ---
 >  drivers/dma/xilinx/xdma.c | 2 +-
 >  1 file changed, 1 insertion(+), 1 deletion(-)

 > diff --git a/drivers/dma/xilinx/xdma.c b/drivers/dma/xilinx/xdma.c
 > index 462109c61653..93ee298d52b8 100644
 > --- a/drivers/dma/xilinx/xdma.c
 > +++ b/drivers/dma/xilinx/xdma.c
 > @@ -277,7 +277,7 @@ xdma_alloc_desc(struct xdma_chan *chan, u32 desc_num)
 
 >  /**
 >   * xdma_xfer_start - Start DMA transfer
 > - * @xdma_chan: DMA channel pointer
 > + * @xchan: DMA channel pointer
 >   */
 >  static int xdma_xfer_start(struct xdma_chan *xchan)
 >  {
 > -- 

 > 2.20.1.7.g153144c
Vinod Koul March 17, 2023, 5:53 p.m. UTC | #2
On 14-02-23, 09:03, Yang Li wrote:
> Make the description of @xdma_chan to @xchan to silence the warnings:

Applied, thanks
diff mbox series

Patch

diff --git a/drivers/dma/xilinx/xdma.c b/drivers/dma/xilinx/xdma.c
index 462109c61653..93ee298d52b8 100644
--- a/drivers/dma/xilinx/xdma.c
+++ b/drivers/dma/xilinx/xdma.c
@@ -277,7 +277,7 @@  xdma_alloc_desc(struct xdma_chan *chan, u32 desc_num)
 
 /**
  * xdma_xfer_start - Start DMA transfer
- * @xdma_chan: DMA channel pointer
+ * @xchan: DMA channel pointer
  */
 static int xdma_xfer_start(struct xdma_chan *xchan)
 {