_frontend/cli.py: Fix formatting for `bst show` help text
-
Sphinx does not allow sections within docstrings so convert the "FORMAT" heading into bold text. See https://sphinx-dev.narkive.com/7rqrxjgL/headings-in-docstrings for some related discussion on this issue.
-
Sphinx uses double backticks for code samples so fix that for CLI options.
-
Fix a typo.
Fixes #323 (closed).
This is not perfect but this is probably as good as it is going to get while this usage info lives inside a docstring. We can't really use more complex markup here as the CLI help text would suffer in that case. For example, I attempted to convert the list of format options into a table, but that made the CLI help text look gross although the generated HTML was much better.