OS Manuals

/usr/bin/sphinx-apidoc

Executable binaries for sphinx-7 installed for python3.11

From py3.11-sphinx-7-bin 7.4.7-r7 (os), captured 2026-11-05 by running sphinx-apidoc --help (exit 0). permalink

usage: sphinx-apidoc [OPTIONS] -o <OUTPUT_PATH> <MODULE_PATH> [EXCLUDE_PATTERN, ...]

Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with
automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or
directory patterns that will be excluded from generation. Note: By default this script will not
overwrite already created files.

positional arguments:
  module_path           path to module to document
  exclude_pattern       fnmatch-style file and/or directory patterns to exclude from generation

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -o DESTDIR, --output-dir DESTDIR
                        directory to place all output
  -q                    no output on stdout, just warnings on stderr
  -d MAXDEPTH, --maxdepth MAXDEPTH
                        maximum depth of submodules to show in the TOC (default: 4)
  -f, --force           overwrite existing files
  -l, --follow-links    follow symbolic links. Powerful when combined with
                        collective.recipe.omelette.
  -n, --dry-run         run the script without creating files
  -e, --separate        put documentation for each module on its own page
  -P, --private         include "_private" modules
  --tocfile TOCFILE     filename of table of contents (default: modules)
  -T, --no-toc          don't create a table of contents file
  -E, --no-headings     don't create headings for the module/package packages (e.g. when the
                        docstrings already contain them)
  -M, --module-first    put module documentation before submodule documentation
  --implicit-namespaces
                        interpret module paths according to PEP-0420 implicit namespaces
                        specification
  -s SUFFIX, --suffix SUFFIX
                        file suffix (default: rst)
  --remove-old          Remove existing files in the output directory that were not generated
  -F, --full            generate a full project with sphinx-quickstart
  -a, --append-syspath  append module_path to sys.path, used when --full is given
  -H HEADER, --doc-project HEADER
                        project name (default: root module name)
  -A AUTHOR, --doc-author AUTHOR
                        project author(s), used when --full is given
  -V VERSION, --doc-version VERSION
                        project version, used when --full is given
  -R RELEASE, --doc-release RELEASE
                        project release, used when --full is given, defaults to --doc-version

extension options:
  --extensions EXTENSIONS
                        enable arbitrary extensions
  --ext-autodoc         enable autodoc extension
  --ext-doctest         enable doctest extension
  --ext-intersphinx     enable intersphinx extension
  --ext-todo            enable todo extension
  --ext-coverage        enable coverage extension
  --ext-imgmath         enable imgmath extension
  --ext-mathjax         enable mathjax extension
  --ext-ifconfig        enable ifconfig extension
  --ext-viewcode        enable viewcode extension
  --ext-githubpages     enable githubpages extension

Project templating:
  -t TEMPLATEDIR, --templatedir TEMPLATEDIR
                        template directory for template files

For more information, visit <https://www.sphinx-doc.org/>.
Options (27)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--versionshow program's version number and exithelp
-qno output on stdout, just warnings on stderrhelp
-f, --forceoverwrite existing fileshelp
-l, --follow-linksfollow symbolic links.help
-n, --dry-runrun the script without creating fileshelp
-e, --separateput documentation for each module on its own pagehelp
-P, --privateinclude "_private" moduleshelp
--tocfile TOCFILEfilename of table of contents (default: modules)help
-T, --no-tocdon't create a table of contents filehelp
-E, --no-headingsdon't create headings for the module/package packages (e.g. when the docstrings already contain them)help
-M, --module-firstput module documentation before submodule documentationhelp
--implicit-namespacesinterpret module paths according to PEP-0420 implicit namespaces specificationhelp
--remove-oldRemove existing files in the output directory that were not generatedhelp
-F, --fullgenerate a full project with sphinx-quickstarthelp
-a, --append-syspathappend module_path to sys.path, used when --full is givenhelp
--extensions EXTENSIONSenable arbitrary extensionshelp
--ext-autodocenable autodoc extensionhelp
--ext-doctestenable doctest extensionhelp
--ext-intersphinxenable intersphinx extensionhelp
--ext-todoenable todo extensionhelp
--ext-coverageenable coverage extensionhelp
--ext-imgmathenable imgmath extensionhelp
--ext-mathjaxenable mathjax extensionhelp
--ext-ifconfigenable ifconfig extensionhelp
--ext-viewcodeenable viewcode extensionhelp
--ext-githubpagesenable githubpages extensionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.