SPHINX-APIDOC(1) Sphinx SPHINX-APIDOC(1)
NAME
sphinx-apidoc - Sphinx API doc generator tool
SYNOPSIS
sphinx-apidoc [options] -o <outputdir> <sourcedir> [pathnames ...]
DESCRIPTION
sphinx-apidoc is a tool for automatic generation of Sphinx sources that, using the autodoc extension, document a whole package in the style
of other automatic API documentation tools.
sourcedir must point to a Python package. Any pathnames given are paths to be excluded from the generation.
OPTIONS
-o <outputdir>
Directory to place the output files. If it does not exist, it is created.
-f, --force
Usually, apidoc does not overwrite files, unless this option is given.
-n, --dry-run
If given, apidoc does not create any files.
-s <suffix>
Suffix for the source files generated, default is rst.
-d <maxdepth>
Maximum depth for the generated table of contents file.
-T, --no-toc
Do not create a table of contents file.
-F, --full
If given, a full Sphinx project is generated (conf.py, Makefile etc.) using sphinx-quickstart.
These options are used with -F:
-H <project>
Project name to put into the configuration.
-A <author>
Author name(s) to put into the configuration.
-V <version>
Project version.
-R <release>
Project release.
SEE ALSO
sphinx-build(1)
AUTHOR
Etienne Desautels, <etienne.desautels@gmail.com>, Georg Brandl <georg@python.org> et al.
COPYRIGHT
2007-2011, Georg Brandl
1.1.3 May 24, 2012 SPHINX-APIDOC(1)