A.3. Options

When setting an option with the O command, it is necessary to type only enough initial letters to distinguish it from the other options. They are not case sensitive.

recallCommand
shellBang

Change the character used for command recall or shell escape respectively. Note in the case of the latter that it still has to be repeated; you are changing each !, not the !! string.

pager

Set to | followed by the name of the program you want to use for paging; for example: O pag='|less'.

A.3.1. Options affecting the V, X, and x commands

arrayDepth
hashDepth

Set the maximum number of elements to print.

quote
HighBit
undefPrint

Change the style of string dumps. The valid values for quote are ", ', or auto.

globPrint

This is a Boolean indicating whether to print typeglobs.

DumpDBFiles
DumpPackages
DumpReused

These control whether to dump the contents of arrays holding debugged files, package symbol tables, and reused addresses, respectively.

bareStringify

If a variable overloads its stringify operator, don't call it; print the raw variable instead.

usageOnly

This causes V and X to display memory usage statistics for each package instead of listing variable values.

A.3.2. Options Affecting Exception Handling

signalLevel
dieLevel
warnLevel

By changing these values from their default of 0, you can get the debugger to intercept signals, warnings, and dies. With a value of 1, dies even within evals will be intercepted; with a value of 2, dies will be intercepted even if you created a $SIG{__DIE__} handler to trap them.

A.3.3. Options Affecting Control by Another Program

RemotePort

Specify a remote host and port number for remote control of the debugger in the format host:port.

tkRunning

Set if running under a PerlTk GUI.

inhibit_exit

According to the documentation, this controls whether the debugger allows “stepping off the end of the script,” but it may be broken.

immediateStop

The debugger should “stop as soon as possible.” If set in PERLDB_OPTS before invocation, debugging starts at the first line even if it is in a BEGIN block. This is handy for debugging used modules because normally the debugger will go past them before prompting.

A.3.4. Miscellaneous Options

compactDump
veryCompact

These affect the verbosity of the display of lists of lists.

frame

frame can be set to a number that is a combination of bit flags specifying certain information to be dumped whenever the stack frame changes (i.e., when a subroutine is entered or left). At the time of writing, some of the higher numbered flags had problems; we'll just say that frame=1 shows subroutine entries and frame=2 shows subroutine exits as well.

PrintRet

Set this option to false to inhibit printing of return information with the r command.

AutoTrace

This is the toggle set by the t command.

maxTraceLen

Used to set the maximum output used for argument printing in tracing.

ornaments

This affects display of the output.; see the Term::ReadLine package for value interpretations.