annotate man/gnats/states.texi @ 167:85ec50267440 r20-3b10

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