that stub pages should be generated for the entries listed in this
directive. The option accepts a directory name as an argument;
:program:`sphinx-autogen` will by default place its output in this
+ directory. If no argument is given, output is placed in the same directory
+ as the file that contains the directive.
* If you don't want the :dir:`autosummary` to show function signatures in the
listing, include the ``nosignatures`` option::
.. confval:: autosummary_generate
- A list of documents for which stub pages should be generated. They will be
- placed in the directories specified in the ``:toctree:`` options.
+ Boolean indicating whether to scan all found documents for
+ autosummary directives, and to generate stub pages for each.
+ Can also be a list of documents for which stub pages should be
+ The new files will be placed in the directories specified in the
+ ``:toctree:`` options of the directives.