diff --git a/docs/INSTALL.rst b/docs/INSTALL.rst
index 3ed830a..7562249 100644
--- a/docs/INSTALL.rst
+++ b/docs/INSTALL.rst
@@ -139,6 +139,12 @@
 
 -  ``build/unit-tests``: A unit test binary for the library
 
+1.5GB available memory per CPU core is necessary for efficient compilation.
+On a multi-core machine with less than 1.5GB available memory per CPU core,
+limit the objects being compiled in parallel with ``./waf -jN`` where N is the amount
+of available memory divided by 1.5GB (eg. ``./waf -j1`` for 1.5GB memory),
+which could usually avoid memory thrashing and result in faster compilation.
+
 Build with examples
 -------------------