From nobody Thu Apr 16 09:26:41 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C5B2321256C for ; Sun, 1 Mar 2026 01:12:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772327550; cv=none; b=WZxiFR+3KBAxbSImrm/F/6oxgVoeycGHGm4AxhkS3kuEvJfNb7wuAuJY6A0lbMhyI+SCQk8xNlz2X6GgI4R+T7zx/uI21rFzeDcBHQ/77RiETvpCJd+G1WeD2mNjFC/TqUL82GV/NrC8n2eIpBMCzvtmn1Q17tvGr5a79Q4dltU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772327550; c=relaxed/simple; bh=KvWhavgvFzVFUhjEyWAXqJ60eIEXFBUHYHs8VqsPtWE=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=JKk91Pt9F/DKB8qEg31Bqg0p6DpZXCEyOV67Aci7CyZT+Y4FBcGi2dWwdYQbs7S2W7m4m9B9Nfu5JOmbHVTB9KpAtrnPfI/aF7kuvyzNYXRjcsF8Fp1URlsnnNPU5ms7FQqY2+JpkRkZdbfihy+3uWJzNZhHuWD6ClDa31gl1jI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=m4D5m51m; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="m4D5m51m" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=hlmpAPsHHu7+Sm/mZ1X3OzoXMfSu/CbcNAYQryJE7xs=; b=m4D5m51msRkd/scSVxsHI0/XlV vbtdkZFggiw/QxppU6ST6KA+UiCzU+C8V0/J9S43UfxSWpyO2f7MQyrpV9vI+xhd0ll4MCoIdl1s0 /e9FJXQOBrVmSQJM1Urn9Ww/YYutMeB05icvdNUKJiVgHjz8jCBn1K6d5M8ufIsu6CFmy9N3q0sb8 yyZuZinItzXQf4rMI+V5tFB9Q85rVm4sufM6TwQpPmEUu5BOvRuecYoroCkqfKh8sHYwKJPqSk29D x/1iIin1Xs5rrvnKNuuSBJP+Yqgxn9bGRM1AhhvKJ0/oInheM3Y5XZu3XD9D16Ykb9odOn+ghTdH8 /G978//g==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vwVMD-0000000ARTB-0lo1; Sun, 01 Mar 2026 01:12:29 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Nishanth Menon , Santosh Shilimkar , Sandeep Nair , linux-arm-kernel@lists.infradead.org Subject: [PATCH] soc: ti: knav_dma: fix all kernel-doc warnings in knav_dma.h Date: Sat, 28 Feb 2026 17:12:28 -0800 Message-ID: <20260301011228.3064940-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use correct struct member names and formats to avoid kernel-doc warnings: Warning: include/linux/soc/ti/knav_dma.h:83 struct member 'priority' not described in 'knav_dma_tx_cfg' Warning: include/linux/soc/ti/knav_dma.h:113 struct member 'err_mode' not described in 'knav_dma_rx_cfg' Warning: include/linux/soc/ti/knav_dma.h:113 struct member 'desc_type' not described in 'knav_dma_rx_cfg' Warning: include/linux/soc/ti/knav_dma.h:113 struct member 'fdq' not described in 'knav_dma_rx_cfg' Warning: include/linux/soc/ti/knav_dma.h:127 struct member 'direction' not described in 'knav_dma_cfg' Warning: include/linux/soc/ti/knav_dma.h:127 struct member 'u' not described in 'knav_dma_cfg' Signed-off-by: Randy Dunlap --- Cc: Nishanth Menon Cc: Santosh Shilimkar Cc: Sandeep Nair Cc: linux-arm-kernel@lists.infradead.org include/linux/soc/ti/knav_dma.h | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) --- linux-next-20260227.orig/include/linux/soc/ti/knav_dma.h +++ linux-next-20260227/include/linux/soc/ti/knav_dma.h @@ -75,7 +75,7 @@ enum knav_dma_desc_type { * struct knav_dma_tx_cfg: Tx channel configuration * @filt_einfo: Filter extended packet info * @filt_pswords: Filter PS words present - * @knav_dma_tx_priority: Tx channel scheduling priority + * @priority: Tx channel scheduling priority */ struct knav_dma_tx_cfg { bool filt_einfo; @@ -87,13 +87,13 @@ struct knav_dma_tx_cfg { * struct knav_dma_rx_cfg: Rx flow configuration * @einfo_present: Extended packet info present * @psinfo_present: PS words present - * @knav_dma_rx_err_mode: Error during buffer starvation - * @knav_dma_desc_type: Host or Monolithic desc + * @err_mode: Error during buffer starvation + * @desc_type: Host or Monolithic desc * @psinfo_at_sop: PS word located at start of packet * @sop_offset: Start of packet offset * @dst_q: Destination queue for a given flow * @thresh: Rx flow size threshold - * @fdq[]: Free desc Queue array + * @fdq: Free desc Queue array * @sz_thresh0: RX packet size threshold 0 * @sz_thresh1: RX packet size threshold 1 * @sz_thresh2: RX packet size threshold 2 @@ -115,7 +115,8 @@ struct knav_dma_rx_cfg { =20 /** * struct knav_dma_cfg: Pktdma channel configuration - * @sl_cfg: Slave configuration + * @direction: DMA transfer mode and direction + * @u: union containing @tx or @rx * @tx: Tx channel configuration * @rx: Rx flow configuration */