cbdce7a362
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> Acked-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20210317202144.20290-1-yashsri421@gmail.com Signed-off-by: Takashi Iwai <tiwai@suse.de> |
||
|---|---|---|
| .. | ||
| Makefile | ||
| asihpi.c | ||
| hpi.h | ||
| hpi6000.c | ||
| hpi6000.h | ||
| hpi6205.c | ||
| hpi6205.h | ||
| hpi_internal.h | ||
| hpi_version.h | ||
| hpicmn.c | ||
| hpicmn.h | ||
| hpidebug.c | ||
| hpidebug.h | ||
| hpidspcd.c | ||
| hpidspcd.h | ||
| hpifunc.c | ||
| hpimsginit.c | ||
| hpimsginit.h | ||
| hpimsgx.c | ||
| hpimsgx.h | ||
| hpioctl.c | ||
| hpioctl.h | ||
| hpios.c | ||
| hpios.h | ||
| hpipcida.h | ||