output will look like this:
>> ./test:4: print "Statement 1 at line 4\n";
>> ./test:5: print "Statement 2 at line 5\n";
>> ./test:6: print "Call to sub x returns ", &x(), " at line 6.\n";
>> ./test:12: print "In sub x at line 12.\n";
>> ./test:13: return 13;
>> ./test:8: exit 0;
This is something like the shell's C<-x> option.
=head1 DETAILS
Inside your program, you can enable and disable tracing by doing
$Devel::Trace::TRACE = 1; # Enable
$Devel::Trace::TRACE = 0; # Disable
or
Devel::Trace::trace('on'); # Enable
Devel::Trace::trace('off'); # Disable
C
exports the C function if you ask it to:
import Devel::Trace 'trace';
Then if you want you just say
trace 'on'; # Enable
trace 'off'; # Disable
=head1 TODO
=over 4
=item *
You should be able to send the trace output to the filehandle of your choice.
=item *
You should be able to specify the format of the output.
=item *
You should be able to get the output into a string.
=back
We'll see.
=head1 Author
=begin text
Mark-Jason Dominus (C
), Plover Systems co.
See the C Page at http://www.plover.com/~mjd/perl/Trace
for news and upgrades.
=end text
=begin man
Mark-Jason Dominus (C), Plover Systems co.
See the C Page at http://www.plover.com/~mjd/perl/Trace
for news and upgrades.
=end man
=begin html
Mark-Jason Dominus (mjd-perl-trace@plover.com), Plover Systems co.
See The Devel::Trace.pm Page for news and upgrades.
=end html
=cut