Sphinx can generate reference documentation from docstrings in your source code.
The Awesome Theme documentation makes use of this function on the page Theme options. This page lists a few additional examples for command line options.
If you want to document command-line options, you have two choices:
An option list (docutils)
Sphinx comes with the
option directive. This renders every option
into its own element, including permalinks:
A compact way to display command-line options is built into the
docutils module and works in Sphinx too:
- -h, --help
Display a helpful message.
- -i FILE, --input FILE
Specify an input file.
- -v, --verbose
Increase the verbosity.