Fix #8597: autodoc: metadata only docstring is treated as undocumented

The metadata in docstring is invisible content. Therefore docstring
having only metadata should be treated as undocumented.
This commit is contained in:
Takeshi KOMIYA
2021-05-02 22:44:44 +09:00
parent 30237c004d
commit 469def56b6
7 changed files with 93 additions and 23 deletions

View File

@@ -22,6 +22,11 @@ The following is a list of deprecated interfaces.
- (will be) Removed
- Alternatives
* - ``sphinx.util.docstrings.extract_metadata()``
- 4.1
- 6.0
- ``sphinx.util.docstrings.separate_metadata()``
* - ``favicon`` variable in HTML templates
- 4.0
- TBD