Perl in a Nutshell

The perlbug Program

As you develop and debug your own code, it’s possible that you’ll run into a bug in Perl itself—if you do, the best way to report it is with the perlbug program. perlbug is a Perl program designed to automate the process of reporting bugs in the Perl standard distribution and the standard modules. It works interactively, prompting you for the information needed and generating an email message addressed to [e-mail]. (If the bug you found is in one of the non-standard Perl ports, see the documentation for that port to find out how to report bugs.) When you run perlbug, it prompts you to include all relevant information, making it easier for the Perl developers to reproduce and track down the bug. If you come up with a patch to resolve the problem, include that too.

Don’t use perlbug as a way to get help debugging your code (see the list of newsgroups and other resources in Chapter 1, for that), but if you believe you’ve found a bug in Perl itself, perlbug is the way to report it.

To run perlbug, simply enter the command, with any options you want to include. For example:

% perlbug -t

The possible options are:

-a address

Email address to send report to. Default is [e-mail].

-b body

Body of report. If not included on the command line or in a file, you are given a chance to edit it.

-C

Don’t send a copy to your Perl administrator.

-c address

Email address where copy should be sent. Default is your Perl administrator.

-d

Data mode. (The default ...