cgit.sxemacs.org Git - packages/blob - xemacs-packages/gnats/texi/states.texi

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