Document PERL_DEBUGGING_MSTATS in INSTALL and in the Win32 Makefile.

Subject: [DOC PATCH 5.8.0] Re: Problem with Devel::Peek on Perl 5.8.0
Message-ID: <3E9D2C86.8040104@uk.radan.com>

p4raw-id: //depot/perl@19280

diff --git a/INSTALL b/INSTALL
index bebc24f..76eeb5f 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -990,6 +990,16 @@ from the linker for malloc et al.  In such cases, the system probably
 does not allow its malloc functions to be fully replaced with custom
 versions.
 
+=item -DPERL_DEBUGGING_MSTATS
+
+This flag enables debugging mstats, which is required to use the
+Devel::Peek::mstat() function. You cannot enable this unless you are
+using Perl's malloc, so a typical Configure command would be
+
+       sh Configure -DPERL_DEBUGGING_MSTATS -Dusemymalloc='y'
+
+to enable this option.
+
 =back
 
 =head2 Building a debugging perl

diff --git a/win32/Makefile b/win32/Makefile
index fcc7bb9..c51417e 100644 (file)
--- a/win32/Makefile
+++ b/win32/Makefile
@@ -137,6 +137,14 @@ CCTYPE             = MSVC60
 #PERL_MALLOC   = define
 
 #
+# set this to enable debugging mstats
+# This must be enabled to use the Devel::Peek::mstat() function.  This cannot
+# be enabled without PERL_MALLOC as well.
+#
+#DEBUG_MSTATS  = define
+
+#
+#
 # set the install locations of the compiler include/libraries
 # Running VCVARS32.BAT is *required* when using Visual C.
 # Some versions of Visual C don't define MSVCDIR in the environment,
@@ -200,6 +208,15 @@ CRYPT_FLAG = -DHAVE_DES_FCRYPT
 
 !IF "$(PERL_MALLOC)" == ""
 PERL_MALLOC    = undef
+DEBUG_MSTATS   = undef
+!ENDIF
+
+!IF "$(DEBUG_MSTATS)" == ""
+DEBUG_MSTATS   = undef
+!ENDIF
+
+!IF "$(DEBUG_MSTATS)" == "define"
+BUILDOPT       = $(BUILDOPT) -DPERL_DEBUGGING_MSTATS
 !ENDIF
 
 !IF "$(USE_IMP_SYS)" == "define"