This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Mention DTrace in INSTALL.
authorDavid Mitchell <davem@iabyn.com>
Mon, 20 Jul 2009 12:51:56 +0000 (13:51 +0100)
committerDavid Mitchell <davem@iabyn.com>
Mon, 20 Jul 2009 12:51:56 +0000 (13:51 +0100)
Also explain that a debugging build is slower

INSTALL

diff --git a/INSTALL b/INSTALL
index 50eeea6..89707cf 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -905,6 +905,22 @@ Removes -g from optimize, and -DDEBUGGING from ccflags.
 If you are using a shared libperl, see the warnings about multiple
 versions of perl under L<Building a shared Perl library>.
 
+Note that a perl built with -DDEBUGGING will be bigger and will run more
+slowly than a standard perl.
+
+=head2 DTrace support
+
+On platforms where DTrace is available, it may be enabled by 
+using the -Dusedtrace option to Configure. DTrace probes are available for
+subroutine entry (sub-entry) and subroutine exit (sub-exit). Here's a
+simple D script that uses them:
+
+  perl$target:::sub-entry, perl$target:::sub-return {
+    printf("%s %s (%s:%d)\n", probename == "sub-entry" ? "->" : "<-",
+              copyinstr(arg0), copyinstr(arg1), arg2);
+  }
+
+
 =head2 Extensions
 
 Perl ships with a number of standard extensions.  These are contained