[PATCH 06/14 v2] ASoC: fsl: mpc5200_dma: use the struct keyword for kernel-doc comments
From: Randy Dunlap <hidden>
Date: 2026-07-15 00:05:31
Also in:
linux-arm-msm, linux-sound
Use the documented format for kernel-doc of structs and the correct struct name to prevent kernel-doc warnings: Warning: ../sound/soc/fsl/mpc5200_dma.h:21 cannot understand function prototype: 'struct psc_dma_stream' Warning: ../sound/soc/fsl/mpc5200_dma.h:50 cannot understand function prototype: 'struct psc_dma' Warning: sound/soc/fsl/mpc5200_dma.h:35 expecting prototype for struct psc_ac97_stream. Prototype was for struct psc_dma_stream instead Signed-off-by: Randy Dunlap <redacted> --- v2: no change Cc: Liam Girdwood <lgirdwood@gmail.com> Cc: Mark Brown <broonie@kernel.org> Cc: linux-sound@vger.kernel.org Cc: Shengjiu Wang <shengjiu.wang@gmail.com> Cc: Xiubo Li <Xiubo.Lee@gmail.com> Cc: Fabio Estevam <festevam@gmail.com> Cc: Nicolin Chen <nicoleotsuka@gmail.com> Cc: linuxppc-dev@lists.ozlabs.org sound/soc/fsl/mpc5200_dma.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
--- linext-2026-0710.orig/sound/soc/fsl/mpc5200_dma.h
+++ linext-2026-0710/sound/soc/fsl/mpc5200_dma.h@@ -9,7 +9,7 @@ #define PSC_STREAM_NAME_LEN 32 /** - * psc_ac97_stream - Data specific to a single stream (playback or capture) + * struct psc_dma_stream - Data specific to a single stream (playback or capture) * @active: flag indicating if the stream is active * @psc_dma: pointer back to parent psc_dma data structure * @bcom_task: bestcomm task structure
@@ -36,7 +36,7 @@ struct psc_dma_stream { }; /** - * psc_dma - Private driver data + * struct psc_dma - Private driver data * @name: short name for this device ("PSC0", "PSC1", etc) * @psc_regs: pointer to the PSC's registers * @fifo_regs: pointer to the PSC's FIFO registers