From: Michal Wajdeczko <michal.wajdeczko@intel.com>
Date: Mon, 18 Jan 2021 11:08:13 +0000 (+0100)
Subject: scripts/kernel-doc: add internal hyperlink to DOC: sections
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=06a755d6269c072ed0c9b84227eaf33113dc243f;p=linux.git

scripts/kernel-doc: add internal hyperlink to DOC: sections

While DOC: section titles are not converted into RST headings
sections and are only decorated with strong emphasis markup,
nothing stops us from generating internal hyperlinks for them,
to mimic implicit hyperlinks to RST headings.

Signed-off-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Jani Nikula <jani.nikula@intel.com>
Cc: Chris Wilson <chris@chris-wilson.co.uk>
Link: https://lore.kernel.org/r/20210118110813.1490-1-michal.wajdeczko@intel.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
---

diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index a9a92e623dbc4..e046e16e4411b 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -836,6 +836,7 @@ sub output_blockhead_rst(%) {
 	next if (defined($nosymbol_table{$section}));
 
 	if ($output_selection != OUTPUT_INCLUDE) {
+	    print ".. _$section:\n\n";
 	    print "**$section**\n\n";
 	}
         print_lineno($section_start_lines{$section});