On 7/14/26 2:44 AM, Randy Dunlap wrote:
> Modify the "/**" to use "/*" instead since this is not a kernel-doc
> comment. This avoids all kernel-doc warnings in this header file:
>
> Warning: include/uapi/sound/snd_ar_tokens.h:61 Cannot find identifier on line:
> * %AR_TKN_U32_SUB_GRAPH_INSTANCE_ID: Sub Graph Instance Id
> Warning: ../include/uapi/sound/snd_ar_tokens.h:62 Cannot find identifier on
> line: *
> Warning: ../include/uapi/sound/snd_ar_tokens.h:63 Cannot find identifier on
> line:
> * %AR_TKN_U32_SUB_GRAPH_PERF_MODE: Performance mode of subgraph
> Warning: include/uapi/sound/snd_ar_tokens.h:64 This comment starts with
> '/**', but isn't a kernel-doc comment.
>
> Signed-off-by: Randy Dunlap <[email protected]>
Reviewed-by: Srinivas Kandagatla <[email protected]>
--srini
> ---
> Cc: Liam Girdwood <[email protected]>
> Cc: Mark Brown <[email protected]>
> Cc: Srinivas Kandagatla <[email protected]>
> Cc: [email protected]
>
> include/uapi/sound/snd_ar_tokens.h | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> --- linext-2026-0710.orig/include/uapi/sound/snd_ar_tokens.h
> +++ linext-2026-0710/include/uapi/sound/snd_ar_tokens.h
> @@ -58,7 +58,7 @@ enum ar_event_types {
> #define SND_SOC_AR_TPLG_FE_BE_GRAPH_CTL_MIX 256
> #define SND_SOC_AR_TPLG_VOL_CTL 257
>
> -/**
> +/*
> * %AR_TKN_U32_SUB_GRAPH_INSTANCE_ID: Sub Graph Instance Id
> *
> * %AR_TKN_U32_SUB_GRAPH_PERF_MODE: Performance mode of subgraph
