From 78a44b5825af61efb3c2bb02018a635975308703 Mon Sep 17 00:00:00 2001 From: Stephen Finucane Date: Sat, 20 Jan 2018 13:17:35 +0000 Subject: [PATCH] doc: Resolve inconsistent 'sphinx-apidoc' docs The signature for the 'sphinx-apidoc' call differs between the man page and the output of 'sphinx-apidoc --help'. Resolve this by considering the 'sphinx-apidoc --help' output the canonical reference. Signed-off-by: Stephen Finucane Fixes: #4451 --- doc/man/sphinx-apidoc.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/doc/man/sphinx-apidoc.rst b/doc/man/sphinx-apidoc.rst index 9a13f1401..8f75d6f7c 100644 --- a/doc/man/sphinx-apidoc.rst +++ b/doc/man/sphinx-apidoc.rst @@ -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 `_ file and/or directory patterns that will +be excluded from generation. .. warning:: @@ -31,7 +32,7 @@ Options .. program:: sphinx-apidoc -.. option:: -o +.. option:: -o 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 +.. option:: -d 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