[svn] Document "handlecodeblocks" option. Bad mitsuhiko :)

2 files changed, 11 insertions, 0 deletions

diff --git a/docs/src/rstdirective.txt b/docs/src/rstdirective.txt
index e049c87f..6e13d1f0 100644
--- a/docs/src/rstdirective.txt
+++ b/docs/src/rstdirective.txt
@@ -41,4 +41,8 @@ files using this syntax::
 
         your code here
 
+*Loosely related note:* The ReST lexer now recognizes ``.. sourcecode::`` and
+``.. code::`` directives and highlights the contents in the specified language
+if the `handlecodeblocks` option is true.
+
 .. _ReST: http://docutils.sf.net/rst.html
diff --git a/pygments/lexers/text.py b/pygments/lexers/text.py
index 5b10c7a8..deab203d 100644
--- a/pygments/lexers/text.py
+++ b/pygments/lexers/text.py
@@ -453,6 +453,13 @@ class RstLexer(RegexLexer):
     For `reStructuredText <http://docutils.sf.net/rst.html>`_ markup.
 
     *New in Pygments 0.7.*
+
+    Additional options accepted:
+
+    `handlecodeblocks`
+        Highlight the contents of ``.. sourcecode:: langauge`` and
+        ``.. code:: language`` directives with a lexer for the given
+        language (default: ``True``). *New in Pygments 0.8.*
     """
     name = 'reStructuredText'
     aliases = ['rst', 'rest', 'restructuredtext']