aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Documentation/sphinx/kernel-doc.py12
1 files changed, 9 insertions, 3 deletions
diff --git a/Documentation/sphinx/kernel-doc.py b/Documentation/sphinx/kernel-doc.py
index dedb24e3bb7a..f6920c0af6ee 100644
--- a/Documentation/sphinx/kernel-doc.py
+++ b/Documentation/sphinx/kernel-doc.py
@@ -37,6 +37,7 @@ from docutils import nodes, statemachine
37from docutils.statemachine import ViewList 37from docutils.statemachine import ViewList
38from docutils.parsers.rst import directives 38from docutils.parsers.rst import directives
39from sphinx.util.compat import Directive 39from sphinx.util.compat import Directive
40from sphinx.ext.autodoc import AutodocReporter
40 41
41class KernelDocDirective(Directive): 42class KernelDocDirective(Directive):
42 """Extract kernel-doc comments from the specified file""" 43 """Extract kernel-doc comments from the specified file"""
@@ -117,12 +118,17 @@ class KernelDocDirective(Directive):
117 lineoffset += 1 118 lineoffset += 1
118 119
119 node = nodes.section() 120 node = nodes.section()
120 node.document = self.state.document 121 buf = self.state.memo.title_styles, self.state.memo.section_level, self.state.memo.reporter
121 self.state.nested_parse(result, self.content_offset, node) 122 self.state.memo.reporter = AutodocReporter(result, self.state.memo.reporter)
123 self.state.memo.title_styles, self.state.memo.section_level = [], 0
124 try:
125 self.state.nested_parse(result, 0, node, match_titles=1)
126 finally:
127 self.state.memo.title_styles, self.state.memo.section_level, self.state.memo.reporter = buf
122 128
123 return node.children 129 return node.children
124 130
125 except Exception as e: 131 except Exception as e: # pylint: disable=W0703
126 env.app.warn('kernel-doc \'%s\' processing failed with: %s' % 132 env.app.warn('kernel-doc \'%s\' processing failed with: %s' %
127 (" ".join(cmd), str(e))) 133 (" ".join(cmd), str(e)))
128 return [nodes.error(None, nodes.paragraph(text = "kernel-doc missing"))] 134 return [nodes.error(None, nodes.paragraph(text = "kernel-doc missing"))]