kernel-doc: detect trailing kernel-doc line trash

Print a warning when a kernel-doc comment block ends with text on the same line as the ending comment characters, e.g.: * this text is lost. */

Randy Dunlap committed 18 years ago

Commit 46b958e1 parent 94dc7ad1 file · +5 −0Browse files

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

Unified · Split

@@ -1950,6 +1950,11 @@ sub process_file($) { · 1949 unmodified lines
1950	1950	$section = $section_default;
1951	1951	$contents = "";
1952	1952	}
	1953	+ # look for doc_com + <text> + doc_end:
	1954	+ if ($_ =~ m'\s\\s[a-zA-Z_0-9:\.]+\/') {
	1955	+ print STDERR "Warning(${file}:$.): suspicious ending line: $_";
	1956	+ ++$warnings;
	1957	+ }
1953	1958
1954	1959	$prototype = "";
1955	1960	$state = 3;