Differences between current version and predecessor to the previous major change of perldebug(1).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Tuesday, June 4, 2002 12:22:32 am | by perry | |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:22:32 am | by perry | Revert |
@@ -164,9 +164,9 @@
with stops before each statement.
r Continue until the return from the current subroutine.
-Dump the return value if the PrintRet option is set
+Dump the return value if the !
PrintRet option is set
(default).
CR n or
@@ -264,9 +264,9 @@
List subroutine names [[not] matching the regex.
-t Toggle trace mode (see also the AutoTrace
+t Toggle trace mode (see also the !
AutoTrace
option).
t expr
@@ -626,9 +626,9 @@
environment or an rc file. (./.perldb or ~/.perldb under
Unix.)
-recallCommand, ShellBang
+recallCommand, !
ShellBang
The characters used to recall command or spawn shell. By
default, both are set to !, which is
@@ -650,9 +650,9 @@
tkRunning
-Run Tk while prompting (with ReadLine).
+Run Tk while prompting (with !
ReadLine).
signalLevel, warnLevel,
dieLevel
@@ -683,16 +683,16 @@
purposes, but tends to hopelessly destroy any program that
takes its exception handling seriously.
-AutoTrace
+!
AutoTrace
Trace mode (similar to t command, but can be put
into PERLDB_OPTS).
-LineInfo
+!
LineInfo
File or pipe to print line number info to. If it is a pipe
(say, visual_perl_db), then a short message is
@@ -708,9 +708,9 @@
If 0, allows ''stepping off'' the end of the
script.
-PrintRet
+!
PrintRet
Print return value after r command if set
(default).
@@ -719,9 +719,9 @@
ornaments
Affects screen appearance of the command line (see
-Term::ReadLine). There is currently no way to disable these,
+Term::!
ReadLine). There is currently no way to disable these,
which can render some output illegible on some displays, or
with some pagers. This is considered a bug.
@@ -782,21 +782,21 @@
Dump arrays holding debugged files.
-DumpPackages
+!
DumpPackages
Dump symbol tables of packages.
-DumpReused
+!
DumpReused
Dump contents of ``reused'' addresses.
-quote, HighBit,
+quote, !
HighBit,
undefPrint
Change the style of string dump. The default value for
@@ -806,9 +806,9 @@
characters with their high bit set are printed
verbatim.
-UsageOnly
+!
UsageOnly
Rudimentary per-package memory usage dump. Calculates total
size of strings found in variables in the package. This does
@@ -819,17 +819,17 @@
After the rc file is read, the debugger reads the
$ENV{PERLDB_OPTS} environment variable and parses
this as the remainder of a `O ...' line as one might enter
at the debugger prompt. You may place the initialization
-options TTY, noTTY, ReadLine, and
-NonStop there.
+options TTY, noTTY, !
ReadLine, and
+!
NonStop there.
If your rc file contains:
parse_options(
-then your script will run without human intervention, putting trace information into the file ''db.out''. (If you interrupt it, you'd better reset LineInfo to ''/dev/tty'' if you expect to see anything.)
+then your script will run without human intervention, putting trace information into the file ''db.out''. (If you interrupt it, you'd better reset !
LineInfo to ''/dev/tty'' if you expect to see anything.)
TTY The TTY to use for debugging
I/O.
@@ -837,9 +837,9 @@
noTTY
-If set, the debugger goes into NonStop mode and
+If set, the debugger goes into !
NonStop mode and
will not connect to a TTY . If interrupted
(or if control goes to the debugger via explicit setting of
$DB::signal or $DB::single from the Perl
script), it connects to a TTY specified in
@@ -858,17 +858,17 @@
is not inspected for proper ownership, so security hazards
are theoretically possible.
-ReadLine
+!
ReadLine
If false, readline support in the debugger is disabled in
order to debug applications that themselves use
-ReadLine.
+!
ReadLine.
-NonStop
+!
NonStop
If set, the debugger goes into non-interactive mode until
interrupted, or programmatically by setting
@@ -879,24 +879,24 @@
variable:
$ PERLDB_OPTS=
-That will run the script __myprogram__ without human intervention, printing out the call tree with entry and exit points. Note that NonStop=1 frame=2 is equivalent to N f=2, and that originally, options could be uniquely abbreviated by the first letter (modulo the Dump* options). It is nevertheless recommended that you always spell them out in full for legibility and future compatibility.
+That will run the script __myprogram__ without human intervention, printing out the call tree with entry and exit points. Note that !
NonStop=1 frame=2 is equivalent to N f=2, and that originally, options could be uniquely abbreviated by the first letter (modulo the Dump* options). It is nevertheless recommended that you always spell them out in full for legibility and future compatibility.
Other examples include
$ PERLDB_OPTS=
-which runs script non-interactively, printing info on each entry into a subroutine and each executed line into the file named ''listing''. (If you interrupt it, you would better reset LineInfo to something ``interactive''!)
+which runs script non-interactively, printing info on each entry into a subroutine and each executed line into the file named ''listing''. (If you interrupt it, you would better reset !
LineInfo to something ``interactive''!)
Other examples include (using standard shell syntax to show
environment variable settings):
$ ( PERLDB_OPTS=
-which may be useful for debugging a program that uses Term::ReadLine itself. Do not forget to detach your shell from the TTY in the window that corresponds to ''/dev/ttyXX'', say, by issuing a command like
+which may be useful for debugging a program that uses Term::!
ReadLine itself. Do not forget to detach your shell from the TTY in the window that corresponds to ''/dev/ttyXX'', say, by issuing a command like
$ sleep 1000000
See ``Debugger Internals'' in perldebguts for details.
@@ -985,9 +985,9 @@
within BEGIN and CHECK blocks
or use statements), these will ''not'' be
stopped by debugger, although requires and
INIT blocks will, and compile-time statements
-can be traced with AutoTrace option set in
+can be traced with !
AutoTrace option set in
PERLDB_OPTS). From your own Perl code, however, you
can transfer control back to the debugger using the
following statement, which is harmless if the debugger is
not running:
@@ -1055,9 +1055,9 @@
As shipped, the only command-line history supplied is a
simplistic one that checks for leading exclamation points.
-However, if you install the Term::ReadKey and Term::ReadLine
+However, if you install the Term::!
ReadKey and Term::!
ReadLine
modules from CPAN , you will have full
editing capabilities much like GNU
readline(3) provides. Look for these in the
''modules/by-module/Term'' directory on
