gnu/usr.bin/send-pr/doc/states.texi

   1 @c $FreeBSD: src/gnu/usr.bin/send-pr/doc/states.texi,v 1.1.12.1 2001/03/05 10:44:05 kris Exp $
   2 @c $DragonFly: src/gnu/usr.bin/send-pr/doc/Attic/states.texi,v 1.2 2003/06/17 04:25:49 dillon Exp $
   3
   4 @node States
   5 @section States of Problem Reports
   6
   7 @cindex life-cycle of a Problem Report
   8 @cindex states of Problem Reports
   9 @cindex Problem Report states
  10 @cindex automatic notification
  11
  12 Each PR goes through a defined series of states between origination and
  13 closure.  The originator of a PR receives notification automatically of
  14 any state changes.
  15
  16 Unless your site has customized states (see @pxref{states
  17 file,,,gnats}), @sc{gnats} uses these states:
  18
  19 @table @dfn
  20 @cindex @emph{open} state
  21 @cindex initial state (@dfn{open})
  22 @cindex state---@dfn{open}
  23 @item open
  24 The initial state of a Problem Report.  This means the PR has been filed
  25 and the responsible person(s) notified.
  26
  27 @cindex @emph{analyzed} state
  28 @cindex state---@dfn{analyzed}
  29 @item analyzed
  30 The responsible person has analyzed the problem.  The analysis should
  31 contain a preliminary evaluation of the problem and an estimate of the
  32 amount of time and resources necessary to solve the problem.  It should
  33 also suggest possible workarounds.
  34
  35 @cindex @emph{feedback} state
  36 @cindex state---@dfn{feedback}
  37 @item feedback
  38 The problem has been solved, and the originator has been given a patch
  39 or other fix.  The PR remains in this state until the originator
  40 acknowledges that the solution works.
  41
  42 @cindex @emph{closed} state
  43 @cindex state---@dfn{closed}
  44 @cindex final state (@dfn{closed})
  45 @item closed
  46 A Problem Report is closed (``the bug stops here'') only when any
  47 changes have been integrated, documented, and tested, and the submitter
  48 has confirmed the solution.
  49
  50 @cindex @emph{suspended} state
  51 @cindex state---@dfn{suspended}
  52 @item suspended
  53 Work on the problem has been postponed.  This happens if a timely
  54 solution is not possible or is not cost-effective at the present time.
  55 The PR continues to exist, though a solution is not being actively
  56 sought.  If the problem cannot be solved at all, it should be closed
  57 rather than suspended.
  58 @end table
  59