diff options
| author | Daniel Vetter <daniel.vetter@ffwll.ch> | 2016-06-01 23:46:23 +0200 |
|---|---|---|
| committer | Jani Nikula <jani.nikula@intel.com> | 2016-06-03 11:26:39 +0300 |
| commit | ebff7f929b2a72fa614f5e95fd34c56c82ac9c36 (patch) | |
| tree | 056021385f8805666eb0f5591cee39a3b952c6c7 | |
| parent | 9cc1a44c03113cb2f3be73650d7c611c3e273ada (diff) | |
scripts/kernel-doc: Remove duplicated DOC: start handling
Further up in the state machinery we switch from STATE_NAME to
STATE_DOCBLOCK when we match /$doc_block/. Which means this block of
code here is entirely unreachable, unless there are multiple DOC:
sections within a single kernel-doc comment.
Getting a list of all the files with more than one DOC: section using
$ git grep -c " * DOC:" | grep -v ":1$"
and then doing a full audit of them reveals there are no such comment
blocks in the kernel.
Supporting multiple DOC: sections in a single kernel-doc comment does
not seem like a recommended way of doing things anyway, so nuke the code
for simplicity.
Cc: Jani Nikula <jani.nikula@intel.com>
Cc: linux-doc@vger.kernel.org
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
[Jani: amended the commit message]
Signed-off-by: Jani Nikula <jani.nikula@intel.com>