1bdemostabs
2===========
3
4The utility bdemostabs calculates the current state of all bugs
5and reports the summary tables.
6
7The input data of bdemostabs are as follow.
8
9  arg1 - the first multi-result directory
10  arg2 - the second multi-result directory
11  arg3 - ALLBUGS file which is a manually prepared description of all bugs,
12         those features of current state of bugs which could not be obtained
13         automatically. NOTE: it should be kept up to date regularly.
14  arg4 - kernel bugzilla Bug List file
15  arg5 - local bugzilla Bug List file
16
17
18Error opcodes in 'Errors' field of Table 1
19==========================================
20
21The 'Errors' field of the summary table (Table 1) contains the letter opcodes
22of errors which points out the inconsistences of the particular bug state which
23require working on them. See opcodes of errors enumerated in ERROR_OPCODES file.
24
25
26ALLBUGS file manual description of per-bug state
27================================================
28
29One new line is to be added into this file for each new bug.
30The contents of fields of the line are given below.
31COMP    - component the bug relates to:
32            I    - AML Interpreter
33            C    - iASL compiler
34            M    - simulation purposes (OS Layer insertions for simulation purposes only)
35            U    - utility
36            S    - specs
37            ML   - memory leak (additional information but not component)
38IID     - internal ID of bug
39LBZID   - local bugzilla ID
40KBZID   - kernel bugzilla ID
41PR      - priority for fixing the bug. Should be non-empty for each not fixed
42          bug and empty otherwise:
43            1 - will be fixed in the first turn
44            2 - will be fixed in the second turn..
45SUMMARY - summary. Short description of bug.
46
47STATE-MANUALLY - the state of bug set up/confirmed (if needed) manually:
48          FIXED      - bug is fixed. It is to be filled only when there is no
49                       ability to create the relevant bdemo test which shows
50                       the current state of the bug.
51          REJECTED   - no longer a bug. Each rejected bug should be confirmed
52                       by this entry here.
53          INTEGRATED - bug-fix is olready integrated. Each fixed bug should be
54                       confirmed by this entry here that its patch/update is
55                       integrated into ACPICA.
56
57Discipline of setting up INTEGRATED
58into STATE-MANUALLY of ALLBUGS file
59===================================
60
611. If bug fix is proposed by our side we check
62   manually through the code that bug fix is actually
63   integrated into ACPICA code.
64
652. If bug is fixed by other side we don't know where to look for
66   the relevant update and simply run the relevant bdemo test on
67   the obtained release to ensure the bug-fix is already integrated.
68
693. For bugs of internal bugzilla other side sets RESOLVED FIXED when
70   integrated the bug-fix update but doesn't close the relevant bug.
71   We run the bdemo test check the result of the test and set CLOSED
72   when the test results in PASS.
73
744. CLOSED but not INTEGRATED yet bug is considered as a wrong combination.
75
76<End>.
77
78
79
80
81
82
83
84
85
86
87
88
89
90