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 <[email protected]> --- v2: no change Cc: Liam Girdwood <[email protected]> Cc: Mark Brown <[email protected]> Cc: [email protected] Cc: Shengjiu Wang <[email protected]> Cc: Xiubo Li <[email protected]> Cc: Fabio Estevam <[email protected]> Cc: Nicolin Chen <[email protected]> Cc: [email protected] 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
