diff --git a/docs/requirements.txt b/docs/requirements.txt
index 987b18492..eec1660bf 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,10 +1,10 @@
 # This is a list of python packages used to generate documentation. This file is used with pip:
-# pip install -r requirements.txt
+# pip install --user -r requirements.txt
 #
-sphinx>=1.6.5
+sphinx>=1.8.4
+breathe>=4.11.1
 sphinx-rtd-theme
-breathe>=4.7.3
-sphinxcontrib.blockdiag>=1.5.3
-sphinxcontrib.seqdiag>=0.8.5
-sphinxcontrib.actdiag>=0.8.5
-sphinxcontrib.nwdiag>=0.9.5
+sphinxcontrib-blockdiag>=1.5.5
+sphinxcontrib-seqdiag>=0.8.5
+sphinxcontrib-actdiag>=0.8.5
+sphinxcontrib-nwdiag>=0.9.5