kernel-doc: better handle '::' sequences
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Thu, 25 Mar 2021 18:14:25 +0000 (19:14 +0100)
committerJonathan Corbet <corbet@lwn.net>
Thu, 25 Mar 2021 18:50:27 +0000 (12:50 -0600)
commit8d295fbad687a61eaa0cf14958c284a3ddbf2173
treec4b1ef2bad7e5ab3beb3f78d3c6b102f2ec9c7a9
parent4b9d49d1ec8dcf9851a132e510c1fd176a6561d1
kernel-doc: better handle '::' sequences

Right now, if one of the following headers end with a '::', the
kernel-doc script will do the wrong thing:

description|context|returns?|notes?|examples?

The real issue is with examples, as people could try to write
something like:

example::

/* Some C code */

and this won't be properly evaluated. So, improve the regex
to not catch '\w+::' regex for the above identifiers.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/2cf44cf1fa42588632735d4fbc8e84304bdc235f.1616696051.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/kernel-doc