diff --git a/doc/README.rst b/doc/README.rst
index 342aba9110f6..a85f7bc91287 100644
--- a/doc/README.rst
+++ b/doc/README.rst
@@ -8,15 +8,15 @@ Included documents:
 
 Building the docs
 -----------------
-From the root nova director:
+From the root nova director::
 
-    python setup.py build_sphinx
+  python setup.py build_sphinx
 
 Building just the man pages
 ---------------------------
-from the root nova director:
+from the root nova director::
 
-    python setup.py build_sphinx -b man
+  python setup.py build_sphinx -b man
 
 
 Installing the man pages
@@ -25,7 +25,8 @@ After building the man pages, they can be found in ``doc/build/man/``.
 You can install the man page onto your system by following the following steps:
 
 Example for ``nova-manage``::
-    # mkdir /usr/local/man/man1
-    # install -g 0 -o 0 -m 0644 doc/build/man/nova-manage.1  /usr/local/man/man1/nova-manage.1
-    # gzip /usr/local/man/man1/nova-manage.1
-    # man nova-manage
+
+  mkdir /usr/local/man/man1
+  install -g 0 -o 0 -m 0644 doc/build/man/nova-manage.1  /usr/local/man/man1/nova-manage.1
+  gzip /usr/local/man/man1/nova-manage.1
+  man nova-manage