diff --git a/docs/01-readme.md b/docs/01-readme.md
index 5c471328..7f2ecedc 100644
--- a/docs/01-readme.md
+++ b/docs/01-readme.md
@@ -19,11 +19,17 @@ After building is finished, you can either install via `make install`:
 or by auto-generating a .deb or .rpm package, for easy removal later on:
 
     make package
-    
+
     sudo dpkg -i awesome-x.y.z.deb
     # or
     sudo rpm -Uvh awesome-x.y.z.rpm
 
+NOTE: awesome uses [`cmake`](https://cmake.org) to build. In case you want to
+pass arguments to cmake, please use the `CMAKE_ARGS` environment variable. For
+instance:
+
+    CMAKE_ARGS="-DCMAKE_INSTALL_PREFIX=/opt/awesome" make
+
 ### Build dependencies
 
 Awesome has the following dependencies (besides a more-or-less standard POSIX