sphinx/doc
Lewis Haley 6e1e35c98a autodoc: allow specifying values to global arguments
Previously, users could specify a *list* of flags in their config files.
The flags were directive names that would otherwise be present in the
.rst files. However, as a list, it was not possible to specify values
to those flags, which *is* possible in .rst files.

For example, in .rst you could say

  :special-members: __init__, __iter__

And this would cause autodoc to generate documents for these methods that
it would otherwise ignore.

This commit changes the config option to instead accept a dictionary.
This is a dictionary whose keys can contain the same flag-names as before,
but whose values can contain the arguments as seen in .rst files.

The old list is still supported, for backwards compatibility, but the data
is transformed into a dictionary when the user's config is loaded.
2018-08-17 15:51:00 +01:00
..
_static doc: Add "quickstart" doc to usage guide 2018-02-26 11:36:46 +00:00
_templates Merge pull request #5096 from tk0miya/update_docs 2018-06-21 01:29:42 +09:00
_themes/sphinx13 Merge branch '1.7' 2018-06-19 23:39:23 +09:00
extdev Move VersionChanges directive to sphinx.domains.changeset 2018-08-02 01:51:51 +09:00
man Merge branch '1.7' 2018-08-04 20:34:42 +09:00
themes Run *.png through zopflipng -m 2016-07-07 18:34:18 +03:00
usage autodoc: allow specifying values to global arguments 2018-08-17 15:51:00 +01:00
web #1428 further indent note 2018-04-08 13:40:23 +02:00
authors.rst Fixup windows newlines. 2014-09-21 20:23:24 +02:00
changes.rst Use "any" role in changelog. 2014-09-19 13:18:29 +02:00
conf.py Revert "LaTeX: extend to all projects the #3742 fix for PDF builds at RTD" 2018-07-31 10:46:48 +02:00
contents.rst doc: Add "extensions" to usage guide 2018-06-20 09:30:47 +01:00
develop.rst Update all pypi.python.org URLs to pypi.org 2018-04-18 19:51:48 -07:00
devguide.rst add devguide.rst as a file instead of symlink. 2016-12-18 10:06:30 +09:00
examples.rst Add "who uses it" page. 2008-06-23 12:35:22 +00:00
faq.rst Update all pypi.python.org URLs to pypi.org 2018-04-18 19:51:48 -07:00
glossary.rst doc: Add "extensions" to usage guide 2018-06-20 09:30:47 +01:00
intl.rst Update intl.rst 2018-06-13 15:32:41 +02:00
intro.rst Update all pypi.python.org URLs to pypi.org 2018-04-18 19:51:48 -07:00
latex.rst Revert "LaTeX: extend to all projects the #3742 fix for PDF builds at RTD" 2018-07-31 10:46:48 +02:00
make.bat make.bat must follow #4097. 2018-06-17 15:24:23 +09:00
Makefile make: Default to Python 3 2018-06-21 15:11:35 +01:00
setuptools.rst Update docs for #5122 (nitpicky option) 2018-07-19 01:22:20 +09:00
templating.rst Closes #2157: helper function `warning()` for HTML themes is added 2018-03-19 00:18:10 +09:00
theming.rst doc: collapsiblesidebar works well with stickysidebar 2018-07-22 00:09:11 +09:00
translation.png Run *.png through zopflipng -m 2016-07-07 18:34:18 +03:00
websupport.rst Update versionadded for SoC projects. 2010-08-21 19:23:05 +02:00