diff --git a/doc/docbkx/README.rst b/doc/docbkx/README.rst
index 43f07bbeb..b19ecb640 100644
--- a/doc/docbkx/README.rst
+++ b/doc/docbkx/README.rst
@@ -9,18 +9,21 @@ Dependencies
 ============
 
 on Ubuntu:
+::
 
-  sudo apt-get install maven
+  $ sudo apt-get install maven
 
 on Fedora Core:
+::
 
-  sudo yum install maven
+  $ sudo yum install maven
 
 Use `mvn`
 =========
 
 Build the Senlin admin guide:
+::
 
-  cd senlin-admin
-  mvn clean generate-sources
+  $ cd senlin-admin
+  $ mvn clean generate-sources