reStructuredText "code" role and directive

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@7119 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 31 insertions, 2 deletions

diff --git a/docutils/docs/user/config.txt b/docutils/docs/user/config.txt
index 6bebf143b..3a46e45df 100644
--- a/docutils/docs/user/config.txt
+++ b/docutils/docs/user/config.txt
@@ -383,8 +383,13 @@ _`record_dependencies`
     Default: None.  Option: ``--record-dependencies``.
 
 _`report_level`
-    Verbosity threshold at or above which system messages are
-    reported.
+    Report system messages at or higher than <level>:
+
+    1  info
+    2  warning
+    3  error
+    4  severe
+    5  none
 
     Default: warning (2).  Options: ``--report, -r, --verbose, -v,
     --quiet, -q``.
@@ -553,6 +558,30 @@ _`trim_footnote_reference_space`
 __ `footnote_references [latex2e writer]`_
 
 
+_`syntax_highlight`
+
+    Token type names used by Pygments_ when parsing contents of the code_
+    directive and role.
+
+    Supported values:
+
+    long
+      Use hierarchy of long token type names.
+    short
+      Use short token type names. (For use with
+      `Pygments-generated stylesheets`_.)
+    none
+      No code parsing. Use this to avoid the "Pygments not
+      found" warning when Pygments is not installed.
+
+    Default: "short".  Option: ``--syntax-highlight``.
+
+.. _Pygments: http://pygments.org/
+.. _code: ../ref/rst/directives.html#code
+.. _Pygments-generated stylesheets:
+   http://pygments.org/docs/cmdline/#generating-styles
+
+
 [readers]
 ---------