Messages in this thread | | | Date | Thu, 18 Mar 2021 10:13:40 +0100 | From | Takashi Iwai <> | Subject | Re: [PATCH] ALSA: asihpi: fix comment syntax in file headers |
| |
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 causes unexpected > warnings from kernel-doc. > > E.g., running scripts/kernel-doc -none on sound/pci/asihpi/hpidspcd.h > causes this warning: > "warning: Cannot understand > on line 4 - I thought it was a doc line" > > Provide a simple fix by replacing the kernel-doc like comment syntax with > general format, i.e. "/*", to prevent kernel-doc from parsing it. > > Signed-off-by: Aditya Srivastava <yashsri421@gmail.com>
Applied now. Thanks.
Takashi
| |