Received-SPF: pass (google.com: domain of linux-kernel+bounces-169111-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1;
From: Jeff Johnson <quic_jjohnson@quicinc.com>
Date: Sun, 5 May 2024 12:32:12 -0700
Subject: [PATCH] dmaengine: xilinx: xdma: fix struct xdma_chan kernel-doc
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-ID: <20240505-xdma_chan-kdoc-v1-1-18cefca3f168@quicinc.com>
To: Lizhi Hou <lizhi.hou@amd.com>, Brian Xu <brian.xu@amd.com>,
        "Raj Kumar
 Rampelli" <raj.kumar.rampelli@amd.com>,
        Vinod Koul <vkoul@kernel.org>, "Michal Simek" <michal.simek@amd.com>
CC: <dmaengine@vger.kernel.org>, <linux-arm-kernel@lists.infradead.org>,
        <linux-kernel@vger.kernel.org>,
        Jeff Johnson <quic_jjohnson@quicinc.com>

make C=1 reports:

warning: Function parameter or struct member 'last_interrupt' not described in 'xdma_chan'
warning: Function parameter or struct member 'stop_requested' not described in 'xdma_chan'

So add missing documentation for these members.

Signed-off-by: Jeff Johnson <quic_jjohnson@quicinc.com>
---
 drivers/dma/xilinx/xdma.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/drivers/dma/xilinx/xdma.c b/drivers/dma/xilinx/xdma.c
index 313b217388fe..43488678ef9e 100644
--- a/drivers/dma/xilinx/xdma.c
+++ b/drivers/dma/xilinx/xdma.c
@@ -61,6 +61,8 @@ struct xdma_desc_block {
  * @dir: Transferring direction of the channel
  * @cfg: Transferring config of the channel
  * @irq: IRQ assigned to the channel
+ * @last_interrupt: Completion variable to signal the last interrupt
+ * @stop_requested: Stop Requested flag of the channel
  */
 struct xdma_chan {
 	struct virt_dma_chan		vchan;

---
base-commit: 2c4d8e19cf060744a9db466ffbaea13ab37f25ca
change-id: 20240505-xdma_chan-kdoc-bf82a3827d2a