O

O [opt[="val"]] [opt`val'] [opt?]

Sets or queries option values. If omitted, val defaults to 1. opt? displays the value of option opt. opt can be abbreviated to the shortest unique string, and multiple options can be specified. The possible options are:

AutoTrace

Affects printing of messages at every possible breaking point.

frame

Enables printing of messages on entry and exit from subroutines.

inhibit_exit

Enables stepping off the end of the script.

maxTraceLen

Gives the maximum length of evals/args listed in the stack trace.

ornaments

Affects the appearance of the command line on the screen.

pager

Specifies the program to use for output of pager-piped commands (those beginning with a | character). Default value is $ENV{PAGER}.

PrintRet

Enables printing of return value after r command.

recallCommand, ShellBang

Specifies the characters used to recall previous commands or spawn a shell. By default, these are both set to !.

The following options affect what happens with the V, X, and x commands:

arrayDepth, hashDepth

Prints only to depth n ("" for all).

compactDump, veryCompact

Changes style of array and hash dumps.

DumpDBFiles

Dumps arrays holding debugged files.

DumpPackages

Dumps symbol tables of packages.

globPrint

Specifies whether to print contents of globs.

quote, HighBit, undefPrint

Changes style of string dump.

signalLevel, warnLevel, dieLevel

Specifies level of verbosity.

tkRunning

Runs Tk while prompting (with ReadLine).

During startup, debugger options are initialized from $ENV{PERLDB_OPTS}. You can set the additional initialization options TTY, noTTY, ReadLine, and NonStop there. See Section 6.4, "Customizing the Debugger," later in this chapter, for more information.