| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
| |
Fix several reference errors throughout the documentation and set
``nitpick_ignore`` in ``doc/conf.py``.
|
|
|
| |
Add the missing default arguments to two CLI flags, ``-l`` and ``-d``
|
|
|
|
|
|
| |
To describe the purpose more accurately, the `master_doc` is now renamed
to `root_doc`. The old name is still available. But it is recommeneded
to use new one from now on.
|
|\ |
|
| | |
|
|/
|
|
| |
#6674
Nixing the comma in `EXCLUDE PATTERN, ...` because it's not supposed to be there. See the issue for the research.
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
| |
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 <stephen@that.guru>
Fixes: #4451
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Add docs for '--module-first' option and 'SPHINX_APIDOC_OPTIONS'
environment variable. Per the closest thing we have to official man page
guidelines [1]:
ENVIRONMENT
lists all environment variables that affect the program or function
and how they affect it.
[1] https://linux.die.net/man/7/man-pages
Signed-off-by: Stephen Finucane <stephen@that.guru>
Fixes #2250
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Per the closest thing we have to official man page guidelines [1]:
Use of an AUTHORS section is strongly discouraged. Generally, it is
better not to clutter every page with a list of (over time potentially
numerous) authors; if you write or significantly amend a page, add a
copyright notice as a comment in the source file.
We already do a good job of tracking authors in the AUTHORS file, so we
can remove this.
[1] https://linux.die.net/man/7/man-pages
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
|
|
|
|
|
| |
This wasn't documented in depth anywhere, so do just that.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
|
|
|
|
|
|
| |
This man page wasn't making full use of Sphinx's own features. Update it
to do so, and remove the duplicated information from 'invocation'.
Signed-off-by: Stephen Finucane <stephen@that.guru>
|
| |
|
| |
|
|
|
|
| |
updated apidoc docs.
|
| |
|
|
|