Annotation of htdocs/developers/PR.html, revision 1.2

1.1       hubertf     1: <html>
                      2: <head>
                      3: <!-- Copyright (c) 1998 The NetBSD Foundation, Inc.
                      4:      ALL RIGHTS RESERVED. -->
1.2     ! hubertf     5: <link rev="made" href="mailto:hubertf@NetBSD.ORG">
1.1       hubertf     6: <title>NetBSD Developer Documentation: Handling Problem Reports</title>
                      7: </head>
                      8: <body bgcolor="#FFFFFF" text="#000000">
                      9: 
                     10: <h1>NetBSD Developer Documentation: Handling Problem Reports</h1>
                     11: 
                     12: New developers often ask how to handle bug reports sent in by people
                     13: via <TT>send-pr</TT>. This document is intended to give some
                     14: information on the topic:
                     15: 
1.2     ! hubertf    16: <OL>
        !            17: <LI> <A HREF="#1">Accessing the PR Database</A>
        !            18: <LI> <A HREF="#2">Closing a PR</A>
        !            19: <LI> <A HREF="#3">States of a PR</A>
        !            20: </OL>
        !            21: 
        !            22: 
        !            23: <HR>
        !            24: 
        !            25: <A NAME="1"><H2>1. Accessing the PR Database</H2></A>
        !            26: 
        !            27: Login in to <TT>gnats.netbsd.org</TT> and make sure you have
        !            28: <TT>/usr/local/bin</TT> in your $PATH.
        !            29: <P>
        !            30: 
        !            31: For accessing a PR, you need
        !            32: it's number. You can either get that via the <A
        !            33: HREF="../MailingLists/index.html#netbsd-bugs">netbsd-bugs</A> mailing
        !            34: list, or via browsing the <A HREF="/Gnats">online database</A>.
        !            35: The database is accessed and manipulated using the <TT>edit-pr</TT>
        !            36: command, handing a PR-number:
        !            37: 
        !            38: <PRE>
        !            39: % edit-pr 6048
        !            40: </PRE>
        !            41: 
        !            42: A editor (usually vi, customisable via the EDITOR/VISUAL environment
        !            43: variable) is started, displaying the full PR with all it's fields like
        !            44: 
1.1       hubertf    45: <UL>
1.2     ! hubertf    46: <LI> <TT>&gt;Number</TT>: The PR's number, as given to <TT>edit-pr</TT>
        !            47: <LI> <TT>&gt;Synopsis</TT>: One-line summary of the problem
        !            48: <LI> <TT>&gt;State</TT>: The current state of affairs, see below.
        !            49: <LI> <TT>&gt;Description</TT>: Detailed description of the problem
1.1       hubertf    50: </UL>
                     51: 
1.2     ! hubertf    52: There are more fields in a PR, described in <A
        !            53: HREF="../Misc/pr-fields.html">another place</A>. 
        !            54: <P>
        !            55: 
        !            56: Edit whatever field you think needs modifying - usually only the
        !            57: <TT>&gt;State</TT>-field - then save and exit the editor. You will be
        !            58: asked for a reason the PR's state was changed, which you have to type
        !            59: in, ending with ^D. This reason is then send (via mail) to everyone
        !            60: who has something to do with the PR.
        !            61: <P>
        !            62: 
        !            63: 
        !            64: <A NAME="2"><H2>2. Closing a PR</H2></A>
        !            65: 
        !            66: If you've committed a fix for a problem (stating the PR number the
        !            67: commit addresses in the commit message), you can close the
        !            68: accompanying PR. To do this, start <TT>edit-pr</TT> on the appropriate
        !            69: PR, then set the <TT>State</TT>-field to ``<TT>closed</TT>''. Exit the
        !            70: editor and state the reason why you closed the PR.
        !            71: <P>
        !            72: 
        !            73: 
        !            74: <A NAME="3"><H2>3. States of a PR</H2></A>
        !            75: 
        !            76: If a PR can't be closed for whatever reason like more user feedback
        !            77: needed or the problem needs some in-depth thoughts, this can be
        !            78: reflected by setting the PR's <TT>State</TT>-field accordingly.
        !            79: Please see the <A HREF="../Misc/pr-states.html">documentation of the
        !            80: PR states</A> for valid values. Be careful about typos, as there is no
        !            81: further check on the spelling, but e.g. the <A HREF="/Gnats">PR-database's Web
        !            82: interface</A> rely on certain spellings. 
        !            83: <P>
1.1       hubertf    84: 
                     85: 
                     86: <hr>
                     87: <table><tr>
                     88:   <td>
1.2     ! hubertf    89:     <a href="../index.html">
1.1       hubertf    90:     <img src="../images/NetBSD-banner.gif" alt="NetBSD&nbsp;Home"></a>
                     91:   </td><td>
1.2     ! hubertf    92:     <a href="../index.html">Home Page</a>
1.1       hubertf    93:   </td>
                     94: </tr></table>
                     95: 
                     96: <hr>
                     97: <address>
1.2     ! hubertf    98:   hubertf@NetBSD.ORG<br>
        !            99:   $NetBSD$<br>
        !           100:   <a href="../Misc/disclaimer.html">Copyright (c) 1998
1.1       hubertf   101:     The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED.</a>
                    102: </address>
                    103: </body>
                    104: </html>

CVSweb <webmaster@jp.NetBSD.org>