diff options
| author | Peter Scott <peter@psdt.com> | 2011-11-24 01:21:29 -0800 |
|---|---|---|
| committer | Father Chrysostomos <sprout@cpan.org> | 2011-11-24 01:45:32 -0800 |
| commit | 611272bb8372feaba3d008744b5aa5a14c8b92c0 (patch) | |
| tree | 3e5f3457bb224c9368eec457140fa48a952937c9 /pod/perldebug.pod | |
| parent | 0b754184eac744bd93c1b9c338cbbfbc82fb7bd4 (diff) | |
| download | perl-611272bb8372feaba3d008744b5aa5a14c8b92c0.tar.gz | |
The attached patch adds to the debugger a capability I thought about
ages ago and which turned out to be absurdly easy to implement. It adds
an optional parameter to the t(race) command, a maximum number of stack
frames to trace below the current one:, e.g.:
t 3 - turn tracing on, trace up to 3 levels below current depth, be
silent below that
t 2 fnord() - trace up to 2 levels deep in execution of fnord()
Since it is backwards compatible I added it to the legacy command set as
well, but that's certainly debatable.
Diffstat (limited to 'pod/perldebug.pod')
| -rw-r--r-- | pod/perldebug.pod | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/pod/perldebug.pod b/pod/perldebug.pod index 69245f9de6..fcdb29c803 100644 --- a/pod/perldebug.pod +++ b/pod/perldebug.pod @@ -269,15 +269,19 @@ X<debugger command, S> List subroutine names [not] matching the regex. -=item t +=item t [n] X<debugger command, t> Toggle trace mode (see also the C<AutoTrace> option). +Optional argument is the maximum number of levels to trace below +the current one; anything deeper than that will be silent. -=item t expr +=item t [n] expr X<debugger command, t> Trace through execution of C<expr>. +Optional first argument is the maximum number of levels to trace below +the current one; anything deeper than that will be silent. See L<perldebguts/"Frame Listing Output Examples"> for examples. =item b |