[ptp-dev] Updated Test Plan

[Clement Chu <clement.chu@xxxxxxxxx>]

Please see the attachment.  Thanks.

Clement

PTP RELEASE STRATEGY FOR THE DEBUG UI COMPONENTS
----------------------------------------------------
SETUP:
 1. Create a C/C++ Project named as "TestC"
 2 Create a file called "main.c"
 3. Open it and write any coding
 4. Switch to Debug Parallel Perspective
 5. Add any breakpoint on "main.c" file by double click on ruler.  OR double click anywhere on source editor and then double click on ruler again.
 6. Click launch button to create parallel configuration and then adding the project name, filename and the number of processes.
 7. Click debug button to launch this program.


TEST PLAN:
 - Starting:
 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: The new job will be selected at the start up and the all processes of this job will be displayed.
 4: Unselected the job, the process view will be cleared.

 - View:
 5: 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.
 6: Click with the left mouse button while holding down the Shift key will extent selection.
 7: Click with the left mouse button while holding down the Ctrl key will continue selection.
 8: 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.  
 9: There is a validation to check whether a new set name already exist or not. If exists, the ok button will be disabled.
10: Only set can be created after the job is launched.
11: Press Ctrl-A key can select all the processes.
12: Press Page-up key can go up one page.
13: Press Page-down key can go down one page.
14: Auto scrolling while dragging further up or down the views.

 - Breakpoint:
15: The parallel breakpoint is created when double click on ruler of the C/C++ source editor.
16: If the parallel breakpoint is created in the condition that is no job running or unselected all the jobs, this breakpoint will belong to be global for all the jobs and there is an additional overlayered image on the breakpoint.
17: Tooltips displaying details of breakpoint (job name, set name, file name and line number) will appear when mouse hovers on the breakpoint.
18: Color of a breakpoint will change to green when it is created in the current set's process.
19: Color of a breakpoint will change to yellow when it does not exist in any of the set's process.
20: 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.
21: Double on the created breakpoint on ruler, the breakpoint will be removed.
22: The global breakpoint only can be created or removed when there is no job selected.
23: Multiple breakpoints can be created in the same source file and the same line number with different jobs.

 - Breakpoint view:
24: 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.
25: Unchecked the breapoint in Breakpoint View, the breakpoint will be disabled.  Check it again, it will be enabled again.
26: Right click on the breakpoint in Breakpoint View and select Goto Set action, the parallel debug view will change to the job and the set indicated in the selected breakpoint.

 - Register / Unregister:
27: 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.
28: Selecting multiple processes in the parallel debug view and then click the register button will register all of them in the debug view.
29: If more than 10 processes have been selected to register, a dialog will popup and ask for confirmation.
30: Double click on the registered process will unregister it from the debug view.  The black rectangle representing the registration will be removed.
31: Selecting multiple registered processes in the parallel debug view and then click the unregister button will unregister all of them in the debug view.
32: The debug view will only display registered processes which is according to the current job and current set.

 - Annotation
33: 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.  
34: The annotation will change to another color(not created) when switch to another set.
35: The process icon appears in yellow process is in suspended mode.  
36: The process icon appears in green when in running mode.
37: The process icon appears in red when in terminate mode.
38: The resume button and all step buttons in the parallel debug view will only be enabled when one of the processes is suspended. 
39: The suspend button in the parallel debug view will only be enabled when one of the processes is running.
40: The terminate button in the parallel debug view will only be enabled when one othe processes is either running or suspended.
41: Resume button in the parallel debug view resumes all suspended processes in the current set.
42: Suspend button in the parallel debug view pauses all running processes in the current set.
43: Terminate button in the parallel debug view stops all suspended and running processes in the current set.
44: Step buttons in the parallel debug view can step into, step over and step return all suspended processes in the current set.
45: Resume button in the debug view can resume selected suspended process(es).
46: Suspend button in the debug view can pause selected running process(es).
47: Terminate button in the parallel debug view can stop any suspended or running process(es).
48: Step buttons in the debug view can step into, step over and step return any suspended process(es).

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.