summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJani Nikula <jani.nikula@intel.com>2016-05-29 22:27:35 +0300
committerJani Nikula <jani.nikula@intel.com>2016-05-30 13:38:55 +0300
commit9e72184b55df2b5b8ebdcf0470bd43ef32dc518f (patch)
tree2ea6586f6bb6a9c1a5c297ff198f8c99aec06a89
parentb6c3f456cfed53e9f06f431270c9dcd52010785e (diff)
downloadblackbird-obmc-linux-9e72184b55df2b5b8ebdcf0470bd43ef32dc518f.tar.gz
blackbird-obmc-linux-9e72184b55df2b5b8ebdcf0470bd43ef32dc518f.zip
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>
-rwxr-xr-xscripts/kernel-doc4
1 files changed, 3 insertions, 1 deletions
diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index dd08944b0a6f..659d529b99d8 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";
}
OpenPOWER on IntegriCloud