Re: [PATCH] ALSA: asihpi: fix comment syntax in file headers

2021-03-18 Thread Takashi Iwai
On Wed, 17 Mar 2021 21:21:44 +0100, Aditya Srivastava wrote: > > The opening comment mark '/**' is used for highlighting the beginning of > kernel-doc comments. > There are files in sound/pci/asihpi which follow this syntax in their file > headers, i.e. start with '/**' like comments, which

Re: [PATCH] ALSA: asihpi: fix comment syntax in file headers

2021-03-17 Thread Randy Dunlap
On 3/17/21 1:21 PM, Aditya Srivastava wrote: > The opening comment mark '/**' is used for highlighting the beginning of > kernel-doc comments. > There are files in sound/pci/asihpi which follow this syntax in their file > headers, i.e. start with '/**' like comments, which causes unexpected >

[PATCH] ALSA: asihpi: fix comment syntax in file headers

2021-03-17 Thread Aditya Srivastava
The opening comment mark '/**' is used for highlighting the beginning of kernel-doc comments. There are files in sound/pci/asihpi which follow this syntax in their file headers, i.e. start with '/**' like comments, which causes unexpected warnings from kernel-doc. E.g., running scripts/kernel-doc