TrepanPl

trepan.pl - Perl "Trepanning" Debugger

SYNOPSIS

trepan.pl [options] [[--] perl-program [perl-program-options ...]]

Options:
   --help               brief help message
   --man                full documentation
   --basename           Show basename only on source file listings.
                        (Needed in regression tests)
   --bw                 Use Bullwinkle Processor (for front-ends) rather
                        that the command-line processor
   -c| --command FILE   Run or 'source' debugger command file FILE
   --cmddir DIR         Read DIR for additional debugger commands
   --batch FILE         Like --command, but quit after reading FILE.
                        This option has precidence over --command and
                        will also set --nx
   --cd DIR             Change current directory to DIR
   -e| --exec STRING    eval STRING. Multiple -e's can be given.
                        Works like Perl's -e switch
   --nx                 Don't run user startup file (e.g. .treplrc)

   --client {'tcp' host port} | {'tty', input-slave output-slave}
                        Set for out-of-process debugging.
                        The client runs outside of this process.
                        'tcp' uses TCP/IP
                        'tty' uses pseudo tty.

   --server {'tcp' host port} | {'tty'}
                        Set for out-of-process debugging. The server
                        rus the Perl program to be debugged runs.

   --fall-off-end       Don't stay in debugger when program terminates

   --include | -I DIR   Add DIR to @INC in invoking program

   --module  | -M MOD   Add module MOD in invoking program

   --post-mortem        Enter debugger on die
   --readline  | --no-readline
                        Try or don't try to use Term::Readline
   -x|--trace           Simulate line tracing (think POSIX shell set -x)
   --highlight | --no-highlight
                        Use or don't use ANSI terminal sequences for syntax
                        highlight
   --verbose            Show what trepan.pl is invoking under the
                        covers

DESCRIPTION

trepan.pl is a gdb-like debugger. Much of the interface and code has been adapted from the trepanning debuggers of Ruby.