diff --git a/include/mbedtls/config.h b/include/mbedtls/config.h
index 41e98217e..3ffb1e2e1 100644
--- a/include/mbedtls/config.h
+++ b/include/mbedtls/config.h
@@ -3635,6 +3635,8 @@
  * If defined, this is a header which will be included instead of
  * `"mbedtls/config.h"`.
  * This header file specifies the compile-time configuration of Mbed TLS.
+ * Unlike other configuration options, this one must be defined on the
+ * compiler command line: a definition in `config.h` would have no effect.
  *
  * This macro is expanded after an <tt>\#include</tt> directive. This is a popular but
  * non-standard feature of the C language, so this feature is only available