lines 6-28 of file: xrst/suspend_command.py

{xrst_begin suspend_cmd user}

Suspend and Resume Commands
###########################

Syntax
******
- ``\{xrst_suspend}``
- ``\{xrst_resume}``

Purpose
*******
It is possible to suspend (resume) the xrst extraction during a page.
One begins (ends) the suspension with a line that only contains spaces,
tabs and a suspend command (resume command).
Note that this will also suspend all other xrst processing; e.g.,
spell checking.

Example
*******
:ref:`suspend_example-name`

{xrst_end suspend_cmd}