summaryrefslogtreecommitdiff
path: root/doc/markup/code.rst
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2008-09-09 19:10:09 +0000
committerGeorg Brandl <georg@python.org>2008-09-09 19:10:09 +0000
commit7d3539c041ed0d0dff76a5a471cc62e654e2f1b2 (patch)
treec674a3501e99a7856aa037a952e9c2b7778886de /doc/markup/code.rst
parent97e5802c397baab046af255771800566f72775ba (diff)
downloadsphinx-git-7d3539c041ed0d0dff76a5a471cc62e654e2f1b2.tar.gz
Add default highlight language selection support.
Add support for recognizing Python 3 console output.
Diffstat (limited to 'doc/markup/code.rst')
-rw-r--r--doc/markup/code.rst8
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/markup/code.rst b/doc/markup/code.rst
index ca8f39bb8..f01070f69 100644
--- a/doc/markup/code.rst
+++ b/doc/markup/code.rst
@@ -1,5 +1,7 @@
.. highlight:: rest
+.. _code-examples:
+
Showing code examples
---------------------
@@ -23,7 +25,9 @@ Syntax highlighting is done with `Pygments <http://pygments.org>`_ (if it's
installed) and handled in a smart way:
* There is a "highlighting language" for each source file. Per default, this is
- ``'python'`` as the majority of files will have to highlight Python snippets.
+ ``'python'`` as the majority of files will have to highlight Python snippets,
+ but the doc-wide default can be set with the :confval:`highlight_language`
+ config value.
* Within Python highlighting mode, interactive sessions are recognized
automatically and highlighted appropriately.
@@ -48,7 +52,7 @@ installed) and handled in a smart way:
* The valid values for the highlighting language are:
* ``none`` (no highlighting)
- * ``python`` (the default)
+ * ``python`` (the default when :confval:`highlight_language` isn't set)
* ``rest``
* ``c``
* ... and any other lexer name that Pygments supports.