The reStructuredText domain (name rst) provides the following directives:
Describes a reST directive. The name can be a single directive name or actual directive syntax (.. prefix and :: suffix) with arguments that will be rendered differently. For example:
.. rst:directive:: foo
Foo description.
.. rst:directive:: .. bar:: baz
Bar description.
will be rendered as:
Describes a reST role. For example:
.. rst:role:: foo
Foo description.
will be rendered as:
- :foo:¶
Foo description.
These roles are provided to refer to the described objects: