ada asm awk c changelog cpp elisp fortran haskell html idl java
javascript mail makefile nroff objc pascal perl postscript python
scheme sh states synopsys tcl vba verilog vhdl

The directive has the following options:

``:file: <filename>`` Reads the code sample from a file rather than using the content block. ``:color:`` Specifies that "color" markup should be done. What this actually means is that the following interpreted-text roles are used for parts of the code markup:

=============== ================
comment         A comment in the language
function-name   A function name
variable-name   A variable name
keyword         A reserved keyword
reference-name  A reference name
string          A quoted string
builtin         Variable names built into language
type-name       Names associated with the language's type system
=============== ================

If any of these roles is undefined before processing the macro, a
null definition is entered for them.
``:level: <level>``
The level of markup.  ``<level>`` can be one of ``none``, ``light``,
or ``heavy`` (default ``heavy``).  Ignored if ``:color:`` is specified.
``:numbered:``
Number the lines of the code block.

This directive also uses the following command-line definition:

-D code-block-states-file=<file>    The file to be passed to the states
                                    program to specify how to do the
                                    formatting.  Searches the perl include
                                    path to find the file.  Default is
                                    "Text/Restructured/Directive/rst.st".
-D code-block-states-flags=<flags>  A set of flags to be passed to the
                                    states program to specify how to do the
                                    formatting.  Default is "".
=end Description
=end reST