]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/commit - scripts/kernel-doc
scripts/kernel-doc: Remove duplicated DOC: start handling
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Wed, 1 Jun 2016 21:46:23 +0000 (23:46 +0200)
committerJani Nikula <jani.nikula@intel.com>
Fri, 3 Jun 2016 08:26:39 +0000 (11:26 +0300)
commitebff7f929b2a72fa614f5e95fd34c56c82ac9c36
tree056021385f8805666eb0f5591cee39a3b952c6c7
parent9cc1a44c03113cb2f3be73650d7c611c3e273ada
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>
scripts/kernel-doc