perlbug
Report Perl bugs to developers
SYNOPSIS
perlbug [options]
PARAMETERS
-v
Display the version number of `perlbug` and exit.
-a
Attach specified files to the bug report.
-d
Include debugging information (equivalent to `-v`).
-f
Force sending the email without prompting for confirmation.
USE WITH CAUTION!
-n
Do not actually send the email, only display it.
-u
Specify the user to be used as the 'From:' address in the email.
-e
Specify the email address to be used in the 'From:' header of the bug report. Overrides -u.
-t
Specifies the recipient address to send the email to. Overrides the default recipient.
-s
Set the email subject.
-M
Include information about a specific module.
-V
Verbose mode; displays additional information during execution.
DESCRIPTION
The `perlbug` command is a utility included with Perl distributions designed to facilitate the reporting of bugs or feature requests to the Perl development team. It gathers information about your system, Perl version, installed modules, and other relevant details, then composes an email with this information pre-filled. This helps ensure that the developers have the necessary context to understand and address the issue you are reporting. The command streamlines the bug reporting process and promotes consistent, informative submissions.
CAVEATS
The precise format of the information included in the bug report may vary slightly depending on the Perl version and system configuration. It relies on a functional email setup on the system where it is being executed. Ensure your system is properly configured to send email.
ENVIRONMENT VARIABLES
The script reads several environment variables, in particular, the value of $EDITOR will be respected. If this variable is not set, `perlbug` will try to invoke 'vi'.
HISTORY
The `perlbug` command has been a part of the Perl distribution for a long time, evolving alongside Perl itself. Its primary purpose has remained consistent: to simplify and standardize the process of submitting bug reports, ensuring developers receive all relevant system and Perl environment information.
SEE ALSO
perl(1)