diff --git a/docs/kbase/locking.html.in b/docs/kbase/locking.html.in
deleted file mode 100644
index 4532dbddf931a1389f673beade216722ba848e32..0000000000000000000000000000000000000000
--- a/docs/kbase/locking.html.in
+++ /dev/null
@@ -1,48 +0,0 @@
-
-
-
-
- Virtual machine lock manager
-
-
-
-
- Libvirt includes a framework for ensuring mutual exclusion
- between virtual machines using host resources. Typically
- this is used to prevent two VM processes from having concurrent
- write access to the same disk image, as this would result in
- data corruption if the guest was not using a cluster
- aware filesystem.
-
-
-
-
-
- The lock manager framework has a pluggable architecture,
- to allow different locking technologies to be used.
-
-
-
- nop
- - This is a "no op" implementation which does absolutely
- nothing. This can be used if mutual exclusion between
- virtual machines is not required, or if it is being
- solved at another level in the management stack.
- lockd
- - This is the current preferred implementation shipped
- with libvirt. It uses the
virtlockd
daemon
- to manage locks using the POSIX fcntl() advisory locking
- capability. As such it requires a shared filesystem of
- some kind be accessible to all hosts which share the
- same image storage.
- sanlock
- - This is an alternative implementation preferred by
- the oVirt project. It uses a disk paxos algorithm for
- maintaining continuously renewed leases. In the default
- setup it requires some shared filesystem, but it is
- possible to use it in a manual mode where the management
- application creates leases in SAN storage volumes.
-
-
-
-
diff --git a/docs/kbase/locking.rst b/docs/kbase/locking.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c0d5e39b2dd821385a77ff282419695012abf9e6
--- /dev/null
+++ b/docs/kbase/locking.rst
@@ -0,0 +1,33 @@
+============================
+Virtual machine lock manager
+============================
+
+Libvirt includes a framework for ensuring mutual exclusion between
+virtual machines using host resources. Typically this is used to prevent
+two VM processes from having concurrent write access to the same disk
+image, as this would result in data corruption if the guest was not
+using a cluster aware filesystem.
+
+Lock manager plugins
+====================
+
+The lock manager framework has a pluggable architecture, to allow
+different locking technologies to be used.
+
+nop
+ This is a "no op" implementation which does absolutely nothing. This
+ can be used if mutual exclusion between virtual machines is not
+ required, or if it is being solved at another level in the management
+ stack.
+`lockd `__
+ This is the current preferred implementation shipped with libvirt. It
+ uses the ``virtlockd`` daemon to manage locks using the POSIX fcntl()
+ advisory locking capability. As such it requires a shared filesystem
+ of some kind be accessible to all hosts which share the same image
+ storage.
+`sanlock `__
+ This is an alternative implementation preferred by the oVirt project.
+ It uses a disk paxos algorithm for maintaining continuously renewed
+ leases. In the default setup it requires some shared filesystem, but
+ it is possible to use it in a manual mode where the management
+ application creates leases in SAN storage volumes.