kernel-doc: warn on badly formatted short description
authorRandy Dunlap <randy.dunlap@oracle.com>
Thu, 7 Feb 2008 08:13:42 +0000 (00:13 -0800)
committerLinus Torvalds <torvalds@woody.linux-foundation.org>
Thu, 7 Feb 2008 16:42:17 +0000 (08:42 -0800)
commit77cc23b8c7f2f5ea0270bf4be31438aa38316e16
tree9ef9b95916f2f8ffbcc75cc2e079a4e3caac0c50
parent792aa2f2cc4924024e28c9ddf1456434992f9c41
kernel-doc: warn on badly formatted short description

Make kernel-doc warn when a function/struct/union/typedef does not contain
a properly formatted short description, such as:
 * scsi_devinfo: set up the dynamic device list
or
 * scsi_devinfo -

This warning is only generated when verbose (-v) mode is used.

Also explain the -v command line option in the -h output.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
scripts/kernel-doc