From 3eb56b1c6f164ec4557913c17cb720d2e17c33a6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 7 Sep 2016 15:45:38 +0900
Subject: [PATCH] doc: Use AutodocReporter at example of
 nested_parse_with_titles()

In detail, please refer following thread:
https://groups.google.com/forum/#!topic/sphinx-dev/l4fHrIJfwq4
---
 doc/extdev/markupapi.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/extdev/markupapi.rst b/doc/extdev/markupapi.rst
index 99a1ae9fb..533660c84 100644
--- a/doc/extdev/markupapi.rst
+++ b/doc/extdev/markupapi.rst
@@ -125,6 +125,8 @@ Both APIs parse the content into a given node. They are used like this::
 
    node = docutils.nodes.paragraph()
    # either
+   from sphinx.ext.autodoc import AutodocReporter
+   self.state.memo.reporter = AutodocReporter(self.result, self.state.memo.reporter)  # override reporter to avoid errors from "include" directive
    nested_parse_with_titles(self.state, self.result, node)
    # or
    self.state.nested_parse(self.result, 0, node)