docs: memory needed for efficient compilation
refs #2171
Change-Id: Ibaff2c2d7c560c1efabfbf7b41a60060f137bc22
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
-------------------