From bcc35915965a4d006aad24cb25e071aebf74f390 Mon Sep 17 00:00:00 2001
From: Randy Dunlap <randy.dunlap@oracle.com>
Date: Thu, 7 Feb 2008 00:13:42 -0800
Subject: [PATCH] --- yaml --- r: 83749 b: refs/heads/master c:
 77cc23b8c7f2f5ea0270bf4be31438aa38316e16 h: refs/heads/master i:   83747:
 d8b03769939358cb894020637ea1e751105cc9b6 v: v3

---
 [refs]                   | 2 +-
 trunk/scripts/kernel-doc | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/[refs] b/[refs]
index f7955e620451..0d1499e22b3d 100644
--- a/[refs]
+++ b/[refs]
@@ -1,2 +1,2 @@
 ---
-refs/heads/master: 792aa2f2cc4924024e28c9ddf1456434992f9c41
+refs/heads/master: 77cc23b8c7f2f5ea0270bf4be31438aa38316e16
diff --git a/trunk/scripts/kernel-doc b/trunk/scripts/kernel-doc
index 7df099e6d1fd..6c18a14386a4 100755
--- a/trunk/scripts/kernel-doc
+++ b/trunk/scripts/kernel-doc
@@ -218,6 +218,7 @@ sub usage {
     print "         [ -function funcname [ -function funcname ...] ]\n";
     print "         [ -nofunction funcname [ -nofunction funcname ...] ]\n";
     print "         c source file(s) > outputfile\n";
+    print "         -v : verbose output, more warnings & other info listed\n";
     exit 1;
 }
 
@@ -1881,6 +1882,13 @@ sub process_file($) {
 		} else {
 		    $declaration_purpose = "";
 		}
+
+		if (($declaration_purpose eq "") && $verbose) {
+			print STDERR "Warning(${file}:$.): missing initial short description on line:\n";
+			print STDERR $_;
+			++$warnings;
+		}
+
 		if ($identifier =~ m/^struct/) {
 		    $decl_type = 'struct';
 		} elsif ($identifier =~ m/^union/) {