Skip to contentSkip to conversation

kernel-doc: warn on badly formatted short description

PATCH New Randy Dunlap 1 participant 1 message Jan 31, 2008

lore
Share & tools
lore
#0 lore raw

PATCH 2/2 kernel-doc: warn on badly formatted short description

From: Randy Dunlap <[email protected]>

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.

---
 scripts/kernel-doc |    8 ++++++++
 1 file changed, 8 insertions(+)
scripts/kernel-doc +8 -0
@@ -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/) {