]> git.baikalelectronics.ru Git - kernel.git/commit
doc/sphinx: Enable keep_warnings
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Tue, 19 Jul 2016 11:42:54 +0000 (13:42 +0200)
committerJonathan Corbet <corbet@lwn.net>
Tue, 19 Jul 2016 22:22:20 +0000 (16:22 -0600)
commita2b553e40e41259d221afeb87c60f83611ccabf1
tree33e4ef3143f359c5b2d5ac74c74465ced6e70593
parent7f9b5cd0d185e5b7be8cc0be6127c114bd9a13e3
doc/sphinx: Enable keep_warnings

Unfortunately warnings generated after parsing in sphinx can end up
with entirely bogus files and line numbers as sources. Strangely for
outright errors this is not a problem. Trying to convert warnings to
errors also doesn't fix it.

The only way to get useful output out of sphinx to be able to root
cause the error seems to be enabling keep_warnings, which inserts
a System Message into the actual output. Not pretty at all, but I
don't really want to fix up core rst/sphinx code, and this gets the job
done meanwhile.

Cc: Markus Heiser <markus.heiser@darmarit.de>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py