浏览代码

kernel-doc: improve handling of whitespace on the first line param description

Handle whitespace on the first line of param text as if it was the empty
string. There is no need to add the newline in this case. This improves
the rst output in particular, where blank lines may be problematic in
parameter lists.

Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Jani Nikula 9 年之前
父节点
当前提交
0a7263014b
共有 1 个文件被更改,包括 4 次插入4 次删除
  1. 4 4
      scripts/kernel-doc

+ 4 - 4
scripts/kernel-doc

@@ -2814,11 +2814,11 @@ sub process_file($) {
 		$in_doc_sect = 1;
 		$in_doc_sect = 1;
 		$in_purpose = 0;
 		$in_purpose = 0;
 		$contents = $newcontents;
 		$contents = $newcontents;
+		while ((substr($contents, 0, 1) eq " ") ||
+		       substr($contents, 0, 1) eq "\t") {
+		    $contents = substr($contents, 1);
+		}
 		if ($contents ne "") {
 		if ($contents ne "") {
-		    while ((substr($contents, 0, 1) eq " ") ||
-			substr($contents, 0, 1) eq "\t") {
-			    $contents = substr($contents, 1);
-		    }
 		    $contents .= "\n";
 		    $contents .= "\n";
 		}
 		}
 		$section = $newsection;
 		$section = $newsection;