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>>Number</TT>: The PR's number, as given to <TT>edit-pr</TT>
! 47: <LI> <TT>>Synopsis</TT>: One-line summary of the problem
! 48: <LI> <TT>>State</TT>: The current state of affairs, see below.
! 49: <LI> <TT>>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>>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 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>