 | Chapter 8 Standard Modules |  |
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.
Sets the variable $diagnostics::PRETTY to true.
Prints the perldiag manpage introduction, then any diagnostic messages.
As a pragma:
enables the use ofuse diagnostics [-verbose]
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:enableTurns diagnostics on at runtime.
disableTurns diagnostics off at runtime.
|  | |
| 8.41 Devel::SelfStubber |  | 8.43 DirHandle |
Copyright © 2001 O'Reilly & Associates. All rights reserved.