The kerneldoc tooling/parsers/validators get confused if non- standard formatting is used. The first line after the kerneldoc identifier '/**' must not be blank else the following warnings will be issued:
drivers/misc/pti.c:902: warning: Cannot understand * on line 902 - I thought it was a doc line Cc: J Freyensee <[email protected]> Signed-off-by: Lee Jones <[email protected]> --- drivers/misc/pti.c | 1 - 1 file changed, 1 deletion(-) diff --git a/drivers/misc/pti.c b/drivers/misc/pti.c index e19988766aa69..7236ae527b19e 100644 --- a/drivers/misc/pti.c +++ b/drivers/misc/pti.c @@ -898,7 +898,6 @@ static struct pci_driver pti_pci_driver = { }; /** - * * pti_init()- Overall entry/init call to the pti driver. * It starts the registration process with the kernel. * -- 2.25.1
