<HTML>
<HEAD>
<TITLE>docs/adminfaq</TITLE>
<LINK REV="made" HREF="mailto:root@pc026991.otn.m.dasa.de">
</HEAD>
<BODY>
<!-- INDEX BEGIN -->
<UL>
<LI><A HREF="#NAME">NAME</A>
<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
<LI><A HREF="#This_FAQ">This FAQ</A>
<LI><A HREF="#Who_are_the_perl_bugmongers_">Who are the perl bugmongers?</A>
<LI><A HREF="#What_do_the_bugmongers_do_">What do the bugmongers do?</A>
<LI><A HREF="#What_is_the_lifecycle_of_a_perl_">What is the lifecycle of a perl bug?</A>
<LI><A HREF="#How_do_I_close_a_bug_">How do I close a bug?</A>
<UL>
<LI><A HREF="#How_do_I_close_a_bug_if_I_am_not">How do I close a bug if I am not an administrator?</A>
<LI><A HREF="#How_do_I_close_an_old_bug_">How do I close an _old_ bug?</A>
<LI><A HREF="#How_do_I_close_a_new_bug_">How do I close a _new_ bug?</A>
</UL>
<LI><A HREF="#When_do_I_delete_a_bug_">When do I delete a bug?</A>
<LI><A HREF="#What_versions_of_perl_should_I_c">What versions of perl should I check for bugs to have been fixed in?</A>
<LI><A HREF="#Web_Interface_Those_Checkboxes">Web Interface: Those Checkboxes</A>
<LI><A HREF="#Why_is_the_note_field_displayed_">Why is the note field displayed _outside_ of the textarea?</A>
<LI><A HREF="#What_is_the_abandoned_status_f">What is the _abandoned_ status for?</A>
<LI><A HREF="#How_do_I_get_more_help_">How do I get more help?</A>
<LI><A HREF="#AUTHOR">AUTHOR</A>
</UL>
<!-- INDEX END -->
<HR>
<P>
<H1><A NAME="NAME">NAME</A></H1>
<P>
The Perl Bug Administrator FAQ
<P>
<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
<P>
Frequently Asked Questions related to Perl Bug Administration.
<P>
$Revision: 1.2 $ $Date: 2001/05/29 01:10:43 $
<P>
<HR>
<H1><A NAME="This_FAQ">This FAQ</A></H1>
<P>
This FAQ is intended for use by the perlbug administrators. The latest
version can be found at <A
If you have any comments or patches to this document, please send them to
the author at the address below.
<P>
<HR>
<H1><A NAME="Who_are_the_perl_bugmongers_">Who are the perl bugmongers?</A></H1>
<P>
The perl bugmongers are the Perl Bug Adminstrators. Some of these people
are active Perl Porters, others are just interested in learning or helping
out.
<P>
<HR>
<H1><A NAME="What_do_the_bugmongers_do_">What do the bugmongers do?</A></H1>
<UL>
<LI><STRONG><A NAME="item_Clean">Clean up old bugs</A></STRONG>
<LI><STRONG><A NAME="item_Organize">Organize/categorize and assign new bugs</A></STRONG>
<LI><STRONG><A NAME="item_Discuss">Discuss better ways for dealing with perl bugs</A></STRONG>
</UL>
<P>
<HR>
<H1><A NAME="What_is_the_lifecycle_of_a_perl_">What is the lifecycle of a perl bug?</A></H1>
<OL>
<LI><STRONG><A NAME="item_A_Bug_report_is_submitted_with_p">A Bug report is submitted with perlbug (to perlbug@perl.org|perlbug@perl.com|macperlbug@perl.org|perl-win32-porters@perl.org|module-bug@perl.org)</A></STRONG>
<LI><STRONG><A NAME="item_A_tracking_number_is_automatical">A tracking number is automatically generated by the perlbugtron, and
the message is forwarded to p5p (or macperl-porters@macperl.org|perl-win32-porters@activestate.com)</A></STRONG>
<LI><STRONG><A NAME="item_A_discusion_hopefully_ensues_o">A discusion (hopefully) ensues on p5p regarding a solution for the
bug. (During this time the bug should be categorized, and possibly assigned.)</A></STRONG>
<LI><STRONG><A NAME="item_One_or_more_solutions_are_propos">One or more solutions are proposed, and one is approved by
consensus and/or the pumpking.</A></STRONG>
<LI><STRONG><A NAME="item_The_bug_is_marked_as_closed_">The bug is marked as closed.</A></STRONG>
</OL>
<P>
<HR>
<H1><A NAME="How_do_I_close_a_bug_">How do I close a bug?</A></H1>
<P>
This process varies depending on the age of the bug. There are many bugs in
the bug database dating back several years. Many of these bugs have already
been solved in recent version of perl. These are old bugs.
<P>
Everything else is a new bug.
<P>
(Another way to make this distinction is this: Anything that requires the
attention of p5p is a new bug.)
<P>
<HR>
<H2><A NAME="How_do_I_close_a_bug_if_I_am_not">How do I close a bug if I am not an administrator?</A></H2>
<P>
You can't do that directly.
<P>
You can send an email to <A
HREF="mailto:admins@bugs.perl.org">admins@bugs.perl.org</A> with your
suggestions, or to propose_close_<bugid>@bugs.perl.org
<P>
<HR>
<H2><A NAME="How_do_I_close_an_old_bug_">How do I close an _old_ bug?</A></H2>
<OL>
<LI><STRONG><A NAME="item_Perform_the_necessary_tests_to_p">Perform the necessary tests to prove it has been solved.</A></STRONG>
<LI><STRONG><A NAME="item_Make_an_entry_in_the_bug_databas">Make an entry in the bug database noting the reason you are
closing it. This can be as simple as "fixed in perl 5.6.0 (tested on
Jul 17 2000)".</A></STRONG>
<P>
The easiest way to make this entry is to send a message to
close_<bugid>@bugs.perl.org, where the content of the message is the
log entry.
</OL>
<P>
<HR>
<H2><A NAME="How_do_I_close_a_new_bug_">How do I close a _new_ bug?</A></H2>
<P>
If there has been a thread on p5p culminating in a patch (or some other
final looking statement), mark the bug as closed. You may wish to add a
comment along the lines of ``resolved in <msgid>''
<P>
<HR>
<H1><A NAME="When_do_I_delete_a_bug_">When do I delete a bug?</A></H1>
<P>
The short answer is <STRONG>NEVER</STRONG>.
<P>
There may be times when a bug should not be in the database, for example,
spam that may have gotten through, or an exact duplicate of another bug
report. (And in the duplicate case, it's probably better to link the bug to
the other copy, to make sure the threads keep properly.)
<P>
<HR>
<H1><A NAME="What_versions_of_perl_should_I_c">What versions of perl should I check for bugs to have been fixed in?</A></H1>
<P>
This depends greatly on when the bug was created. Generally, you should
check 5.00503, 5.6.0, perl-current, and perl-5.6.x-current. (Theoretically,
once it works in an earlier version, it will work in all future versions,
but it can't help to perform the regression test by hand.)
<P>
<HR>
<H1><A NAME="Web_Interface_Those_Checkboxes">Web Interface: Those Checkboxes</A></H1>
<P>
Discussed in bugmongers Message-id: <<A
HREF="mailto:397466D6.6F05E8B8@m.dasa.de">397466D6.6F05E8B8@m.dasa.de</A>>
<P>
The perlbugtron user interface has a lot of checkboxes. When you modify
items, you need to check the box for that item. Otherwise, when you click
update, nothing will happen and you will receive an error.
<P>
The page you get back after altering bugs will only have the bugs checked
on it. So if you have a list of 25 bugs, and you edit 3 of them, the page
you receive will have only these 3 bugs in it, for you to peruse/check. If
you edit all 25 of them at once, the same applies, it just may not look
vastly different to begin with.
<P>
<HR>
<H1><A NAME="Why_is_the_note_field_displayed_">Why is the note field displayed _outside_ of the textarea?</A></H1>
<P>
The note is displayed next to the text area, so you can add another one IN
the text area. If there's more than one, you get links to all the notes
instead.
<P>
<HR>
<H1><A NAME="What_is_the_abandoned_status_f">What is the _abandoned_ status for?</A></H1>
<P>
The Abandoned status means: ``This bug is no longer a priority or probably
cannot be fixed. We may come back to fix it after all the other bugs have
been resolved.''
<P>
Things are very rarely abandoned without good reason.
<P>
As of this writing, pre 5.6 install bugs are being abandoned. The
installation system changed a lot for 5.6, and many issues were resolved.
<P>
<HR>
<H1><A NAME="How_do_I_get_more_help_">How do I get more help?</A></H1>
<P>
To get more help on the email interface, send a message with the subject
'-h' to <A HREF="mailto:bugdb@perl.org.">bugdb@perl.org.</A> For more
detailed help, use '-H';
<P>
The definitive location for more help on the web interface is
<P>
<A
if you are an administrator
<P>
<A
for normal users
<P>
<HR>
<H1><A NAME="AUTHOR">AUTHOR</A></H1>
<P>
Robert Spier <rspier at cpan.org>
</BODY>
</HTML>