diff --git a/doc/admin.rst b/doc/admin.rst
index 56a39726324bac4e499811394253f3c0593ac7b3..f44aef2ef75c6f2c12f81c2ee226cc9488213ef4 100644
--- a/doc/admin.rst
+++ b/doc/admin.rst
@@ -1,7 +1,7 @@
 Ganeti administrator's guide
 ============================
 
-Documents Ganeti version 2.0
+Documents Ganeti version |version|
 
 .. contents::
 
@@ -173,8 +173,8 @@ Importing an instance is similar to creating a new one. The command is::
   gnt-backup import -n TARGET_NODE -t DISK_TEMPLATE \
     --src-node=NODE --src-dir=DIR INSTANCE_NAME
 
-Most of the options available for the command *gnt-instance add* are
-supported here too.
+Most of the options available for the command :command:`gnt-instance
+add` are supported here too.
 
 High availability features
 --------------------------
@@ -262,6 +262,7 @@ you can deactivate them with the deactivate-disks command, which works
 in the same way.
 
 Accessing an instance's console
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The command to access a running instance's console is::
 
@@ -281,8 +282,8 @@ command to ran to see a complete status for all your nodes is::
 Cluster-wide debugging
 ~~~~~~~~~~~~~~~~~~~~~~
 
-The *gnt-cluster* command offers several options to run tests or
-execute cluster-wide operations. For example::
+The :command:`gnt-cluster` command offers several options to run tests
+or execute cluster-wide operations. For example::
 
   gnt-cluster command
   gnt-cluster copyfile
@@ -291,4 +292,4 @@ execute cluster-wide operations. For example::
   gnt-cluster getmaster
   gnt-cluster version
 
-See the man page *gnt-cluster* to know more about their usage.
+See the man page :manpage:`gnt-cluster` to know more about their usage.
diff --git a/doc/design-2.0.rst b/doc/design-2.0.rst
index 9d25f748c0d50c833c4d90eefa2adfeb17a694cd..73cfa642427f9d0efaf009385fc13da063df867c 100644
--- a/doc/design-2.0.rst
+++ b/doc/design-2.0.rst
@@ -1558,8 +1558,8 @@ DEBUG_LEVEL
 
 These are only the basic variables we are thinking of now, but more
 may come during the implementation and they will be documented in the
-``ganeti-os-api`` man page. All these variables will be available to
-all scripts.
+:manpage:`ganeti-os-api` man page. All these variables will be
+available to all scripts.
 
 Some scripts will need a few more information to work. These will have
 per-script variables, such as for example:
diff --git a/doc/iallocator.rst b/doc/iallocator.rst
index f4b8bfcf81f7d64c4790ecf935f8ceeb7e93bfeb..58719a0b87ea55f2e1289e0c1e46c22571a8c602 100644
--- a/doc/iallocator.rst
+++ b/doc/iallocator.rst
@@ -223,7 +223,7 @@ nodes
 
   No allocations should be made on nodes having either the ``drained``
   or ``offline`` flags set. More details about these of node status
-  flags is available in the manpage *ganeti(7)*.
+  flags is available in the manpage :manpage:`ganeti(7)`.
 
 
 Respone message
diff --git a/doc/install.rst b/doc/install.rst
index 83e6c8ca4320687e2b0c1cf2c202777d215f0d00..bfbeee7c77f3c3d3c2550c6bea807c34b64cb7f0 100644
--- a/doc/install.rst
+++ b/doc/install.rst
@@ -1,7 +1,7 @@
 Ganeti installation tutorial
 ============================
 
-Documents Ganeti version 2.0
+Documents Ganeti version |version|
 
 .. contents::
 
@@ -450,7 +450,7 @@ installed.
      apt-get install debootstrap dump kpartx
 
 Alternatively, you can create your own OS definitions. See the manpage
-*ganeti-os-interface*.
+:manpage:`ganeti-os-interface`.
 
 Initializing the cluster
 ++++++++++++++++++++++++