From: Jani Nikula <jani.nikula@intel.com>
Date: Sun, 29 May 2016 19:27:35 +0000 (+0300)
Subject: kernel-doc/rst: do not output DOC: section titles for requested ones
X-Git-Tag: v5.15~13065^2~37^2~25
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=9e72184b55df2b5b8ebdcf0470bd43ef32dc518f;p=platform%2Fkernel%2Flinux-starfive.git

kernel-doc/rst: do not output DOC: section titles for requested ones

If the user requests a specific DOC: section by name, do not output its
section title. In these cases, the surrounding context already has a
heading, and the DOC: section title is only used as an identifier and a
heading for clarity in the source file.

Signed-off-by: Jani Nikula <jani.nikula@intel.com>
---

diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index dd08944..659d529 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -1764,7 +1764,9 @@ sub output_blockhead_rst(%) {
     my ($parameter, $section);
 
     foreach $section (@{$args{'sectionlist'}}) {
-	print "**$section**\n\n";
+	if ($output_selection != OUTPUT_INCLUDE) {
+	    print "**$section**\n\n";
+	}
 	output_highlight_rst($args{'sections'}{$section});
 	print "\n";
     }