diff --git a/docs/commands.rst b/docs/commands.rst
index 76d49ac4..b0fc831f 100644
--- a/docs/commands.rst
+++ b/docs/commands.rst
@@ -30,7 +30,9 @@ name and a colon. Files is searched for using *sys.path*, and the `.py`
 suffix may be omitted in the file name.
 
 Examples:
-++++++++
++++++++++
+
+::
 
    break              # Break where we are current stopped at
    break if i < j     # Break at current line if i < j
@@ -60,6 +62,8 @@ made unconditional.
 Examples:
 +++++++++
 
+::
+
    condition 5 x > 10  # Breakpoint 5 now has condition x > 10
    condition 5         # Remove above condition
 
@@ -69,8 +73,6 @@ See also:
 `break`, `tbreak`."""
 
 
-
-
 Data
 ====
 
@@ -94,6 +96,8 @@ disassemble that.
 Examples:
 +++++++++
 
+::
+
        disassemble    # Possibly lots of stuff dissassembled
        disassemble .  # Disassemble lines starting at current stopping point.
        disassemble +                  # Same as above
@@ -220,9 +224,9 @@ Files
 List (show me the code!)
 ------------------------
 
-The list command will show you your source code.
+The list command will show you your source code::
 
-.. code:: python
+::
 
         (trepan2) list 2
           1     #!/usr/bin/python
diff --git a/docs/index.rst b/docs/index.rst
index edd4eff2..20ba93f4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,12 +6,10 @@
 Welcome to trepan's documentation!
 ==================================
 
-Contents:
-
 .. toctree::
    :maxdepth: 2
 
-See :doc:`commands` for a the debugger command reference.
+See :doc:`commands` for the debugger command reference.
 
 Indices and tables
 ==================