``:lenient:`` Causes the exit code for the subprocess to be ignored. ``:literal:`` Interpret the returned value as a literal block.

If this option is not present, the return value is interpreted as reStructuredText and is parsed again.

Any error returned by the shell generates a level 3 error message. To see the output of a command that is expected to generate an error, do::

.. system:: <your command> 2>&1 | cat

The following defines are processed by the system directive:

-D trusted Must be specified for system directives to be processed. This requirement is to prevent a system directive in a file written elsewhere from doing destructive things on your computer. =end Description =end reST