
![]() | ![]() |
8.56. diagnostics
Provides
more descriptive diagnostics than those generated by the Perl
compiler and interpreter. Uses the longer, more explanatory error
messages found in the perldiag manpage. Can be
used as a pragma or as a standalone program,
splain.
When used as a pragma, diagnostics affects the compilation phase of
your program as well as the execution phase. As a standalone module,
it is used to post-process errors after execution has completed.
The splain program links to
diagnostics.pm to act on the standard error
output of a Perl program. The program's output can
be sent to a file, which is then used as input to
splain, or it can be piped directly to
splain. Output from splain
is directed to STDOUT.
8.56.1. Options
-p
Sets the variable $diagnostics::PRETTY to true-v
Prints the perldiag manpage introduction, then
any diagnostic messages
As a pragma: use diagnostics [-verbose]
enables the use of diagnostics in your program (and enables
Perl's -w flag). Compilation is
then subject to the enhanced diagnostics, which are issued to STDERR.
Set the diagnostics::PRETTY variable in a BEGIN
block to provide nicer escape sequences for pagers, so your output
looks better. The -verbose option prints the
perldiag manpage introduction, then any
diagnostic messages. Functions are:
enable
Turns diagnostics on at runtimedisable
Turns diagnostics off at runtime
![]() | ![]() | ![]() |
8.55. Devel::SelfStubber | ![]() | 8.57. Digest |

Copyright © 2002 O'Reilly & Associates. All rights reserved.