Re: [PATCH] scripts: kernel_doc: fixup reporting of function identifiers

From: Jonathan Corbet
Date: Fri Feb 16 2018 - 09:56:49 EST


On Tue, 13 Feb 2018 13:31:46 +0200
Mike Rapoport <rppt@xxxxxxxxxxxxxxxxxx> wrote:

> When function description includes brackets after the function name as
> suggested by Documentation/doc-guide/kernel-doc, the kernel-doc script
> omits the function name from "Scanning doc for" report.
> Extending match for identifier name with optional brackets fixes this
> issue.

So let me channel akpm here and ask: what are the user-visible effects of
this problem? I ask because applying it doesn't make any difference in
the "make htmldocs" output here. So I don't understand why you're
wanting to make this change.

Thanks,

jon