perlbug

perlbug [options]

-r, --email reporter
    Specifies the email address of the reporter for the bug report.

-s, --subject subject
    Sets the subject line of the bug report email.

-b, --body body
    Provides an initial body for the bug report. This content will be editable.

-a, --attach files
    Attaches one or more files to the bug report. Multiple files can be specified separated by commas.

-e, --editor editor
    Specifies the path to an external editor to use for writing the report body.

-m, --mail mailer
    Designates the mailer program to use for sending the email (e.g., /usr/sbin/sendmail).

-t, --to to_address
    Overrides the default recipient address for the bug report (usually perlbug@perl.org).

-S, --smtp-server server
    Directly uses the specified SMTP server for sending the report.

-p, --proxy proxy
    Specifies a proxy server to use for SMTP connections.

-v, --version
    Displays the version of the perlbug utility.

-d, --debug
    Enables debug mode, providing verbose output for troubleshooting perlbug itself.

-h, --help
    Shows a brief help message and exit.

perlbug is a utility designed to assist users in preparing and sending bug reports concerning the Perl programming language. It automates much of the data collection process, gathering crucial information about the user's operating system, Perl version, and other relevant system specifics. This ensures that bug reports are comprehensive and useful to the Perl development team. The command operates interactively, guiding the user through a series of questions to elicit details about the bug, including a description, steps to reproduce, and expected versus actual behavior. Once the information is collected, perlbug formats it into an email and attempts to send it to the official Perl bug reporting address, typically perlbug@perl.org, using a configured mailer program.

perlbug relies on a properly configured mailer system (like sendmail or a specified SMTP server) to send reports. Issues with local mailer setup can prevent reports from being sent successfully. It is recommended to verify network connectivity and mailer configuration if reports fail to send.
The utility attempts to auto-detect system information, but users should review the generated report for accuracy before sending.

• EDITOR: Specifies the preferred text editor to use when editing the bug report body.
• PERLBUG_OPTS: Can contain additional default options for perlbug.

• ~/.perlbug: A user-specific configuration file that can store default options.
• Internal modules (e.g., /usr/lib/perl5/perlbug.pm): Used by perlbug for its operations.

perl(1), perldoc(1), perlfaq(1), sendmail(8)