ALSA: ctxfi: fix comment syntax in file headers
authorAditya Srivastava <yashsri421@gmail.com>
Wed, 17 Mar 2021 20:39:32 +0000 (02:09 +0530)
committerTakashi Iwai <tiwai@suse.de>
Thu, 18 Mar 2021 09:14:08 +0000 (10:14 +0100)
commita08b9f2f2267421092bf4b882a9461858216ed47
tree2bae817880579ec04715ba29c440faa775319d50
parentcbdce7a3620c7daff6b8a2cb27b41bb0a2e6f78d
ALSA: ctxfi: fix comment syntax in file headers

The opening comment mark '/**' is used for highlighting the beginning of
kernel-doc comments.
There are files in sound/pci/ctxfi 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/ctxfi/ctresource.c
causes this warning:
"warning: wrong kernel-doc identifier on line:
 * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved."

Similarly for other files too.

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/20210317203932.23993-1-yashsri421@gmail.com
Signed-off-by: Takashi Iwai <tiwai@suse.de>
20 files changed:
sound/pci/ctxfi/ct20k1reg.h
sound/pci/ctxfi/ct20k2reg.h
sound/pci/ctxfi/ctamixer.c
sound/pci/ctxfi/ctamixer.h
sound/pci/ctxfi/ctatc.c
sound/pci/ctxfi/ctatc.h
sound/pci/ctxfi/ctdaio.c
sound/pci/ctxfi/ctdaio.h
sound/pci/ctxfi/cthardware.h
sound/pci/ctxfi/cthw20k1.h
sound/pci/ctxfi/cthw20k2.h
sound/pci/ctxfi/ctimap.h
sound/pci/ctxfi/ctmixer.h
sound/pci/ctxfi/ctpcm.h
sound/pci/ctxfi/ctresource.c
sound/pci/ctxfi/ctresource.h
sound/pci/ctxfi/ctsrc.c
sound/pci/ctxfi/ctsrc.h
sound/pci/ctxfi/ctvmem.c
sound/pci/ctxfi/ctvmem.h