X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2Fsigtrap.pm;h=e099ac465813b668f3b020568f9f53caa6ee76ca;hb=54d04a52ebe0ed5248ec3caf5cda11b87acffb7b;hp=72b9cb60441025f0be96a8834ef973abedb71e05;hpb=a0d0e21ea6ea90a22318550944fe6cb09ae10cda;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/lib/sigtrap.pm b/lib/sigtrap.pm
index 72b9cb6..e099ac4 100644
--- a/lib/sigtrap.pm
+++ b/lib/sigtrap.pm
@@ -1,5 +1,27 @@
 package sigtrap;
 
+=head1 NAME
+
+sigtrap - Perl pragma to enable stack backtrace on unexpected signals
+
+=head1 SYNOPSIS
+
+    use sigtrap;
+    use sigtrap qw(BUS SEGV PIPE SYS ABRT TRAP);
+
+=head1 DESCRIPTION
+
+The C<sigtrap> pragma initializes some default signal handlers that print
+a stack dump of your Perl program, then sends itself a SIGABRT.  This
+provides a nice starting point if something horrible goes wrong.
+
+By default, handlers are installed for the ABRT, BUS, EMT, FPE, ILL, PIPE,
+QUIT, SEGV, SYS, TERM, and TRAP signals.
+
+See L<perlmod/Pragmatic Modules>.
+
+=cut
+
 require Carp;
 
 sub import {
@@ -25,19 +47,29 @@ sub trap {
     syswrite(STDERR, "\n", 1);
 
     # Now go for broke.
-    for ($i = 1; ($p,$f,$l,$s,$h,$w) = caller($i); $i++) {
-	@a = ();
+    for ($i = 1; ($p,$f,$l,$s,$h,$w,$e,$r) = caller($i); $i++) {
+        @a = ();
 	for $arg (@args) {
 	    $_ = "$arg";
-	    s/'/\\'/g;
+	    s/([\'\\])/\\$1/g;
 	    s/([^\0]*)/'$1'/
-		unless /^(?: -?[\d.]+ | \*[\w:]* )$/x;
+	      unless /^(?: -?[\d.]+ | \*[\w:]* )$/x;
 	    s/([\200-\377])/sprintf("M-%c",ord($1)&0177)/eg;
 	    s/([\0-\37\177])/sprintf("^%c",ord($1)^64)/eg;
 	    push(@a, $_);
 	}
 	$w = $w ? '@ = ' : '$ = ';
 	$a = $h ? '(' . join(', ', @a) . ')' : '';
+	$e =~ s/\n\s*\;\s*\Z// if $e;
+	$e =~ s/[\\\']/\\$1/g if $e;
+	if ($r) {
+	    $s = "require '$e'";
+	} elsif (defined $r) {
+	    $s = "eval '$e'";
+	} elsif ($s eq '(eval)') {
+	    $s = "eval {...}";
+	}
+	$f = "file `$f'" unless $f eq '-e';
 	$mess = "$w$s$a called from $f line $l\n";
 	syswrite(STDERR, $mess, length($mess));
     }