kerneldoc: Implement "Example" section handling

The default kernel-doc strips starting spaces from every single
line in the Example section. This makes the code look bad. Thus,
implement special handling for this section.

Signed-off-by: Marek Vasut <marex@denx.de>

diff --git a/tools/kernel-doc/kernel-doc b/tools/kernel-doc/kernel-doc
index 8848efd8eda3f9860e2fe017526d343b9c4c7110..6347418904811d60c3ba316653c2d931a3baea7b 100755 (executable)
--- a/tools/kernel-doc/kernel-doc
+++ b/tools/kernel-doc/kernel-doc
@@ -2424,6 +2424,9 @@ sub process_file($) {
                    # Continued declaration purpose
                    chomp($declaration_purpose);
                    $declaration_purpose .= " " . xml_escape($1);
+               } elsif ($section =~ m/^Example/) {
+                   $_ =~ s/^\s*\*//;
+                   $contents .= $_;
                } else {
                    $contents .= $1 . "\n";
                }