extend option directive syntax

One can cross-reference an option value: :option:`--module=foobar`.
This commit is contained in:
Martin Liska
2022-09-20 12:21:29 +02:00
committed by Adam Turner
parent 05683f794c
commit 29e6adab12
5 changed files with 36 additions and 1 deletions

View File

@@ -1775,6 +1775,10 @@ There is a set of directives allowing documenting command-line programs:
referenceable by :rst:role:`option` (in the example case, you'd use something
like ``:option:`dest_dir```, ``:option:`-m```, or ``:option:`--module```).
.. versionchanged:: 5.3
One can cross-reference including an option value: ``:option:`--module=foobar```.
Use :confval:`option_emphasise_placeholders` for parsing of
"variable part" of a literal text (similarly to the :rst:role:`samp` role).