diff --git a/docs/src/cdist-install.rst b/docs/src/cdist-install.rst
index f9feef36..afc50016 100644
--- a/docs/src/cdist-install.rst
+++ b/docs/src/cdist-install.rst
@@ -131,7 +131,10 @@ some other custom .cdist directory, e.g. /opt/cdist then use:
 
 .. code-block:: sh
 
-    DOT_CDIST_PATH=/opt/cdist make dotman
+    make DOT_CDIST_PATH=/opt/cdist dotman
+
+Note that `dotman`-target has to be built before a `make docs`-run, otherwise
+the custom man-pages are not picked up.
 
 Python package
 ~~~~~~~~~~~~~~