Encourage --with-pydebug rather than individual setting of debug options.

diff --git a/Misc/SpecialBuilds.txt b/Misc/SpecialBuilds.txt
index 25bb6d1e380a89ca900d2eb2a956c2328087244b..1413cf0ebdbdd9076b02cade9b747932cee38794 100644 (file)
--- a/Misc/SpecialBuilds.txt
+++ b/Misc/SpecialBuilds.txt
@@ -1,7 +1,12 @@
 This file describes some special Python build types enabled via
 compile-time preprocessor defines.
 
-It is best to define these options in the EXTRA_CFLAGS make variable;
+IMPORTANT: if you want to build a debug-enabled Python, it is recommended
+that you use ``./configure --with-pydebug``, rather than the options listed
+here.
+
+However, if you wish to define some of these options individually, it is best
+to define them in the EXTRA_CFLAGS make variable;
 ``make EXTRA_CFLAGS="-DPy_REF_DEBUG"``.
 
 ---------------------------------------------------------------------------