IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

doc: Update document for autodoc :members: option

Browse Source
This commit is contained in:
Takeshi KOMIYA 2021-03-06 18:57:18 +09:00
parent 647510e184
commit f37e679fd1
1 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/usage/extensions/autodoc.rst
View File

@ -89,33 +89,43 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
Boil the noodle *time* minutes. Boil the noodle *time* minutes.
**Options and advanced usage** .. rubric:: Options
* If you want to automatically document members, there's a ``members`` .. rst:directive:option:: members
option:: :type: no value or comma separated list
If set, autodoc will generate document for the members of the target
module, class or exception.
For example::
.. automodule:: noodle .. automodule:: noodle
:members: :members:
will document all module members (recursively), and :: will document all module members (recursively), and ::
.. autoclass:: Noodle .. autoclass:: Noodle
:members: :members:
will document all non-private member functions and properties (that is, will document all class member methods and properties.
those whose name doesn't start with ``_``).
For modules, ``__all__`` will be respected when looking for members unless By default, autodoc will not generate document for the members that are
you give the ``ignore-module-all`` flag option. Without private, not having docstrings, inherited from super class, or special
``ignore-module-all``, the order of the members will also be the order in members.
``__all__``.
You can also give an explicit list of members; only these will then be For modules, ``__all__`` will be respected when looking for members unless
documented:: you give the ``ignore-module-all`` flag option. Without
``ignore-module-all``, the order of the members will also be the order in
``__all__``.
You can also give an explicit list of members; only these will then be
documented::
.. autoclass:: Noodle .. autoclass:: Noodle
:members: eat, slurp :members: eat, slurp
**Options and advanced usage**
* If you want to make the ``members`` option (or other options described * If you want to make the ``members`` option (or other options described
below) the default, see :confval:`autodoc_default_options`. below) the default, see :confval:`autodoc_default_options`.