Merge pull request #3931 from tk0miya/3926_autodoc_warningiserror

Fix #3926: Add ``autodoc_warningiserror`` to suppress the behavior of ``-W`` option
This commit is contained in:
Takeshi KOMIYA
2017-07-16 14:06:38 +09:00
committed by GitHub
5 changed files with 71 additions and 2 deletions

View File

@@ -386,6 +386,13 @@ There are also new config values that you can set:
This config value only requires to declare the top-level modules that
should be mocked.
.. confval:: autodoc_warningiserror
This value controls the behavior of :option:`sphinx-build -W` during
importing modules.
If ``False`` is given, autodoc forcely suppresses the error if the imported
module emits warnings. By default, ``True``.
Docstring preprocessing
-----------------------