kernel-doc: always name missing kerneldoc sections

The "no structured comments found" warning is not particularly useful if there are several invocations, one of which is looking for something wrong. So if something specific has been requested, make it clear that it's the one we weren't able to find.

Jonathan Corbet committed 7 years ago

Commit b0d60bf1 parent 3f715b11 file · +9 −7Browse files

Showing the changes to scripts (1 of 1 file). Show all

Unified · Split

scripts/kernel-doc+9−7

     OUTPUT_INTERNAL     => 4, # output non-exported symbols
 };
 my $output_selection = OUTPUT_ALL;
-my $show_not_found = 0;
+my $show_not_found = 0;	# No longer used
 my @export_file_list;
     } elsif ($cmd eq 'enable-lineno') {
 	    $enable_lineno = 1;
     } elsif ($cmd eq 'show-not-found') {
-	$show_not_found = 1;
+	$show_not_found = 1;  # A no-op but don't fail
     } else {
 	# Unknown argument
         usage();
     }
     # Make sure we got something interesting.
-    if ($initial_section_counter == $section_counter) {
+    if ($initial_section_counter == $section_counter && $
-	if ($output_mode ne "none") {
+	output_mode ne "none") {
-	    print STDERR "${file}:1: warning: no structured comments found\n";
+	if ($output_selection == OUTPUT_INCLUDE) {
+	    print STDERR "${file}:1: warning: '$_' not found\n"
+		for keys %function_table;
 	}
-	if (($output_selection == OUTPUT_INCLUDE) && ($show_not_found == 1)) {
+	else {
-	    print STDERR "    Was looking for '$_'.\n" for keys %function_table;
+	    print STDERR "${file}:1: warning: no structured comments found\n";
 	}
     }
 }