From 4fc194b2052979cb8d28873cf62c0ce84cd214f5 Mon Sep 17 00:00:00 2001 From: Gurusamy Sarathy Date: Mon, 24 Feb 1997 15:09:51 -0500 Subject: [PATCH] perlbug.pod for 5.004 On Mon, 24 Feb 1997 16:10:10 GMT, "M.J.T. Guy" wrote: >You wrote to perl5-porters: >> I hope I got Kenneth right as the AUTHOR of perlbug. > >Doesn't he deserve the E treatment, like the rest of you? > >>+ Kenneth Albanowski , subsequently Itored by Sure. That, and a few pod2man noises fixed below. Goes on top of the previous patch. p5p-msgid: <199702242009.PAA02849@aatma.engin.umich.edu> --- pod/perl.pod | 1 + pod/perldelta.pod | 4 ++++ utils/perlbug.PL | 38 +++++++++++++++++++------------------- 3 files changed, 24 insertions(+), 19 deletions(-) diff --git a/pod/perl.pod b/pod/perl.pod index 302f58b..e306037 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -42,6 +42,7 @@ of sections: perlbot Perl OO tricks and examples perlipc Perl interprocess communication + perlbug Perl bug reports howto perldebug Perl debugging perldiag Perl diagnostic messages perlsec Perl security diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 628ca22..23f216f 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -680,6 +680,10 @@ new pods are included in section 1: =over +=item L + +A "howto" on reporting perl bugs. + =item L This document. diff --git a/utils/perlbug.PL b/utils/perlbug.PL index 33290d5..064d71d 100644 --- a/utils/perlbug.PL +++ b/utils/perlbug.PL @@ -837,10 +837,10 @@ with perl (we'll admit this is no mean task, given the sheer volume of it all, but at least have a look at the sections that I relevant). Be aware of the familiar traps that perl programmers of various hues -fall into. See perltrap(1). +fall into. See L. Try to study the problem under the perl debugger, if necessary. -See perldebug(1). +See L. =item Do you have a proper test case? @@ -908,62 +908,62 @@ version of perl comes out and your bug is still present. =over 8 -=item -a +=item B<-a> Address to send the report to. Defaults to `perlbug@perl.com'. -=item -b +=item B<-b> Body of the report. If not included on the command line, or -in a file with -f, you will get a chance to edit the message. +in a file with B<-f>, you will get a chance to edit the message. -=item -C +=item B<-C> Don't send copy to administrator. -=item -c +=item B<-c> Address to send copy of report to. Defaults to the address of the local perl administrator (recorded when perl was built). -=item -d +=item B<-d> Data mode (the default if you redirect or pipe output). This prints out your configuration data, without mailing anything. You can use this -with -v to get more complete data. +with B<-v> to get more complete data. -=item -e +=item B<-e> Editor to use. -=item -f +=item B<-f> File containing the body of the report. Use this to quickly send a prepared message. -=item -h +=item B<-h> Prints a brief summary of the options. -=item -r +=item B<-r> Your return address. The program will ask you to confirm its default if you don't use this option. -=item -S +=item B<-S> Send without asking for confirmation. -=item -s +=item B<-s> Subject to include with the message. You will be prompted if you don't supply one on the command line. -=item -t +=item B<-t> Test mode. The target address defaults to `perlbug-test@perl.com'. -=item -v +=item B<-v> Include verbose configuration data in the report. @@ -971,8 +971,8 @@ Include verbose configuration data in the report. =head1 AUTHORS -Kenneth Albanowski , subsequently Itored by -Gurusamy Sarathy (Egsar@umich.eduE), Tom Christiansen +Kenneth Albanowski (Ekjahds@kjahds.comE), subsequently Itored +by Gurusamy Sarathy (Egsar@umich.eduE), Tom Christiansen (Etchrist@perl.comE), and Nathan Torkington (Egnat@frii.comE). -- 2.7.4