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

Merge pull request #4464 from stephenfin/issue/4451

Browse Source 
doc: Resolve inconsistent 'sphinx-apidoc' docs
This commit is contained in:
Takeshi KOMIYA 2018-01-21 12:20:47 +09:00 committed by GitHub
commit 7efb82046b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/man/sphinx-apidoc.rst
View File

@ -4,7 +4,7 @@ sphinx-apidoc
Synopsis
--------
**sphinx-apidoc** [*options*] -o <*outputdir*> <*sourcedir*> [*pathnames* ...]
**sphinx-apidoc** [*OPTIONS*] -o <*OUTPUT_PATH*> <*MODULE_PATH*> [*EXCLUDE_PATTERN*, ...]
Description
-----------
@ -13,9 +13,10 @@ Description
that, using the :rst:dir:`autodoc` extension, document a whole package in the
style of other automatic API documentation tools.
*sourcedir* is the path to a Python package to document, and *outputdir* is the
directory where the generated sources are placed. Any *pathnames* given are
paths to be excluded from the generation.
*MODULE_PATH* is the path to a Python package to document, and *OUTPUT_PATH* is
the directory where the generated sources are placed. Any *EXCLUDE_PATTERN*\s
given are `fnmatch-style <fnmatch>`_ file and/or directory patterns that will
be excluded from generation.
.. warning::
@ -31,7 +32,7 @@ Options
.. program:: sphinx-apidoc
.. option:: -o <outputdir>
.. option:: -o <OUTPUT_PATH>
Directory to place the output files. If it does not exist, it is created.
@ -51,7 +52,7 @@ Options
Suffix for the source files generated. Defaults to ``rst``.
.. option:: -d <maxdepth>
.. option:: -d <MAXDEPTH>
Maximum depth for the generated table of contents file.
@ -130,3 +131,5 @@ See also
--------
:manpage:`sphinx-build(1)`, :manpage:`sphinx-autogen(1)`
.. _fnmatch: https://docs.python.org/3/library/fnmatch.html