diff options
-rw-r--r-- | Documentation/sphinx/kernel-doc.py | 12 |
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 | |||
37 | from docutils.statemachine import ViewList | 37 | from docutils.statemachine import ViewList |
38 | from docutils.parsers.rst import directives | 38 | from docutils.parsers.rst import directives |
39 | from sphinx.util.compat import Directive | 39 | from sphinx.util.compat import Directive |
40 | from sphinx.ext.autodoc import AutodocReporter | ||
40 | 41 | ||
41 | class KernelDocDirective(Directive): | 42 | class 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"))] |