[ptp-dev] PTP Debug UI Feature List and Test Plan

[Clement Chu <clement.chu@xxxxxxxxx>]

Hi,

   See if it is ok.  Thanks.

Regards,
Clement

PTP RELEASE STRATEGY FOR THE DEBUG UI COMPONENTS
----------------------------------------------------
FEATURES:
 1: Buttons and shortcuts to create, delete and modify the set by selecting elements in Debug Views.
 2: Ability to name a new set in Debug Views.
 3: Change set button to switch the set for examining the status of the elements in Debug Views.
 4: Parallel Debug view supports mulitple jobs run and ability to switch to specific job to display its processes.
 5: Parallel Debug view supports process registering or unregistering to and from the Standard Debug view.
 6: C/C++ Source Editor in Parallel Debug Perspective allows create, delete, enable and disable parallel breakpoint.
 7: Tooltip display to represent the multiple breakpoints on the same location with different jobs.
 8: Breakpoint represent its status in different sets in different colors.
 9: A set of buttons in the parallel debug view allows to resume, suspend, stop, step into, step over and step return all processes in the current set.
10: A set of buttons in the debug view allows to control the selected processes in this view.
11: Parallel Breakpoint Set view in Standard Breakpoint view which groups multiple sets of breakpoints.
12: Array view allows examining the array type's variable selected in Standard Debug view.

PTP RELEASE STRATEGY FOR THE DEBUG UI COMPONENTS
----------------------------------------------------
TEST PLAN:
 1: Parallel Debug View displays the status of processes after launching a parallel program in debug mode.
 2: Debug icon of the job represent that it is in debug mode.
 3: Drag across a rectangular region to select some processes.  Hold down the left mouse button, move the mouse, and release the button when the desired process is selected.
 4: Click with the left mouse button while holding down the Shift key will extent selection.
 5: Click with the left mouse button while holding down the Ctrl key will continue selection.
 6: A dialog box will popup when press the Create set button.  After enter set name, the view will change from root set to created set.  
 7: There is a validation to check whether a new set name already exist or not. If exists, the ok button will be disabled.
 8: Only set can be created after the job is launched.
 9: Press Ctrl-A key can select all the processes.
10: Press Page-up key can go up one page.
11: Press Page-down key can go down one page.
12: Auto scrolling while dragging further up or down the views.
13: The parallel breakpoint is created when double click on ruler of the C/C++ source editor.  The green breakpoint will appear on the ruler.  
14: Tooltips displaying details of breakpoint (file name and line number) will appear when mouse hovers on the breakpoint.
15: When the job runs, apart from the existing details, the job name and set name will also appear on the tooltip.  
16: Color of a breakpoint will change to green when it is created in the current set's process.
17: Color of a breakpoint will change to yellow when it does not exist in any of the set's process.
18: Color of a breakpoint will change to blue when it exists in one of the process in the current set but is not created in this set.
19: All breakpoints will be displayed ordered by the set name when clicking the drop down menu in the breakpoint view and then the parallel breakpoint set.
20: Double click on the process in parallel debug view and the process will be registered into the debug view. A registered process is presented by a black rectangle.
21: Selecting multiple processes in the parallel debug view and then click the register button will register all of them in the debug view.
22: If more than 10 process has been selected to register, a dialog will popup and ask for confirmation.
23: Double click on the registered process will unregister it from the debug view.  The black rectangle representing the registration will be removed.
24: The debug view will only display registered processes that can be found in the current set.
25: Selecting multiple registered processes in the parallel debug view and then click the unregister button will unregister all of them in the debug view.
26: If a breakpoint location contains multiple markers, annotations for both these markers will be overlapped when the breakpoint is hit.  The registered process marker should appear on top.  Tooltips will display process task id of each marker set in this location, grouped by its marker.  
27: The annotation will change to another color(not created) when switch to another set.
28: The process icon appears in yellow process is in suspended mode.  
29: The process icon appears in green when in running mode.
30: The process icon appears in red when in terminate mode.
31: The resume button and all step buttons in the parallel debug view will only be enabled when one of the processes is suspended. 
32: The suspend button in the parallel debug view will only be enabled when one of the processes is running.
33: The terminate button in the parallel debug view will only be enabled when one othe processes is either running or suspended.
34: Resume button in the parallel debug view resumes all suspended processes in the current set.
35: Suspend button in the parallel debug view pauses all running processes in the current set.
36: Terminate button in the parallel debug view stops all suspended and running processes in the current set.
37: Step buttons in the parallel debug view can step into, step over and step return all suspended processes in the current set.
38: Resume button in the debug view can resume selected suspended process(es).
39: Suspend button in the debug view can pause selected running process(es).
40: Terminate button in the parallel debug view can stop any suspended or running process(es).
41: Step buttons in the debug view can step into, step over and step return any suspended process(es).