Debug view

# HG changeset patch # User fturovic # Date 1286398657 18000 # Node ID 0a2167a80b64a2b0fc04454fbd764631d8ec784b # Parent f0b706fa897d2c299ddb75b2aefefa610867f28f minor edits on view pages to make them more similar diff -r f0b706fa897d -r 0a2167a80b64 core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm Wed Oct 06 14:30:50 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm Wed Oct 06 15:57:37 2010 -0500 @@ -18,7 +18,7 @@

Workspace Information

A workspace is the default place to store and create resources like projects, folders, and files. These are then presented to the user in a perspective which enables the presentation and manipulation of the stored resources.

When Carbide is launched it asks for a workspace to open (Figure 1). As you can have multiple workspaces, all independent from each other, choosing the workspace containing the projects to work on is important. Projects within a workspace are shown in the Carbide workbench within the Project Explorer and C/C++ Project views. When you create a new project it is automatically added to the currently open workspace. You can import existing projects into a workspace from INF files.

Workspace Launcher dialog

Figure 1. Workspace Launcher dialog

WARNING Bld.inf imported projects are not copied, so do not delete the contents when deleting the project.

diff -r f0b706fa897d -r 0a2167a80b64 core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/viewing_debug.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/viewing_debug.htm Wed Oct 06 14:30:50 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/viewing_debug.htm Wed Oct 06 15:57:37 2010 -0500 @@ -4,24 +4,25 @@ + Debug view

Debug view

The Debug view provides an overview of the debug session as it relates to the executing program. The target debugging information is shown in a tree hierarchy. The items that appear there include:

Launch instance () - launch configuration name and type
Debugger instance () - debugger name and state
Executable instances () - other executables called by the launch instance
Thread instance () - thread number and state
Thread instance () - thread number and state (Running, Suspended, etc.)
Stack frame reference () - displays stack frame number, function, filename, and file line number when symbols are available and stack frame number, memory address, and filename when symbols are not available

NOTE The number beside the thread label is a reference counter, not a thread identification number (TID).

The CDT displays stack frames as child elements. It displays the reason for the suspension beside the thread, (such as end of stepping range, breakpoint hit, and signal received). When a program exits, the exit code is displayed.

In addition to controlling the individual stepping of your programs, you can also control the debug session. You can perform actions such as terminating the session and stopping the program by using the debug launch controls available from Debug view. See Table 1 for details.

Figure 1 shows the Debug view. Table 1 explains the items in the view.

Figure 1 shows the Debug view. Table 1 explains the items in the view.

Figure 1 - Debug view

Table 1 Debug view—items

diff -r f0b706fa897d -r 0a2167a80b64 core/com.nokia.carbide.cpp.doc.user/html/debugger/variables/adding_variables.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/variables/adding_variables.htm Wed Oct 06 14:30:50 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/variables/adding_variables.htm Wed Oct 06 15:57:37 2010 -0500 @@ -9,11 +9,11 @@

Adding and Removing Global Variables

The Variables view can also display global variables used by the program. Right-click in the Variables view and select the Add Global Variables menu option to open the Global Variables dialog. There you can select one or more global variables to display in the Variables view, clickiing OK when done.

Global Variables window

Figure 1 - Global Variables selection dialog

Removing Global Variables

Right-click in the Variables view and select the Add Global Variables menu option to open the Global Variables dialog. Locate and uncheckmark the global variable to stop displaying, then click OK. This removes the selected global variable from the variables list.

Other references

Variables and Expressions Overview

Variables and Expressions Overview

Variables are symbols used in programs to store values or expressions that can change during the life of the program. Being able to view a variable's value is helpful when debugging a program. Expressions are the result of one or more variables being combined to produce a result based on the variable values and the way they are calculated. Variables are shown in the Variables view while expressions are shown in the Expressions view.

The following cover various variable and expression concepts and actions:

Viewing Variables -
- Adding and Removing Global Variables
-
Variables view

Viewing Expressions

Variables view

The Variables view allows manipulation of project variables and the variable hierarchy used in the source code. For example, you can change the variable format, change a variable value, add watch expressions, or add global variables.

Figure 1 shows the Variables view with Show Type Names option enabled. The default view shows the variables list and include the Name and Value for all the variables within scope. In addition, when you select a variable its value is also shown in a different pane within the view.

Figure 1 - Variables view

Variables view toolbar icons

The following commands appear on the Variables view toolbar:

Item	Icons	Explanation
Show Type Names		Toggles the display of type names in the Variables view.
Show Logical Structure		Not available in C/C++ yet.
Collapse All		Collapses all expanded variables into the top level.
Add Global Variables		Click to open the Global Variables dialog where you can select one or more global variables to display in the Variables view. Global variables appear at the top of the variables list. + NOTE Not yet implemented in C3, use View Menu > Show Globals Defined in this File menu option instead.
Remove Selected Global Variables		Click to remove all currently selected global variables from the variables list.
Remove All Global Variables		Click to remove all global variables from the variables list.
View Menu		Enables you to modifiy the Layout to change the view orientation between: horizontal, vertical, or variables pane only and customize the columns shown in the view. + + In addition, use Show All Variables to toggle between showing only those variables that are in scope and live or show all local variables, even if redundant. With this option on you will see all of the variables including the multiple defined variables like “i” for your loops and ones that may no longer have accurate values.

Variables view context menu options

Right-click in the Variables view to access the commands on the Variables view context menu.

Variables view context menu

Figure 2. Variables view context menu commands

The commands include:

Item	Explanation
Select All	Selects all the variables shown in the Variables view.
Copy Variables	Copies the selected variables to the clipboard. + NOTE Only the selected variables visible in the Variables view are copied. Variables listed outside the boundary of the view are not in memory and can't be copied at this time.
Enable	Enables the selected variable.
Disable	Disables the selected variable.
Cast To Type...	Opens the Cast to Type dialog where you can assign a new type to the variable. Enter the type and click OK. + All cast variables are then shown using the Restore Original Type menu option making them easy to identify and restore later. + +
Display As Array...	Opens the Display as Array dialog where you can set array parameters to show the variables. Enter the Start index and Length, then click OK to update how the variables are shown in the Variables view. +
View Memory	Opens a Memory view on the selected variable so you can examine it.
Format	Change the selected variable's display format. The default setting is Natural, or the format assigned when the variable is defined. For example, the decimal value of 256 would appear as: + + Binary (0b100000) + Natural (256) + Decimal (256) + Hexadecimal (0x100) +
Find...	Opens a Find dialog to search for variables. Enter the variable to search for and click OK. +
Change Value...	Opens the Set Value dialog where you can modify the value assigned to the selected variable. Change the value and click OK. +
Add Global Variables...	Select to open the Global Variables dialog where you can select one or more global variables to display in the Variables view. Global variables appear at the top of the variables list. + NOTE Not yet implemented in C3, use View Menu > Show Globals Defined in this File menu options instead.
Remove Global Variables	Remove the selected global variables from the Variables view. + NOTE Not yet implemented in C3, use View Menu > Show Globals Defined in this File menu options instead.
Remove All Global Variables	Remove all global variables from the Variables view.
Add Watchpoint (C/C++)...	Opens the Add Watchpoint dialog enabling you to define a watchpoint on the variable. +
Watch	Creates a watchpoint on the selected variable and displays it in the Watchpoint view.

Other references

Variables and Expressions Overview

Viewing Variables

Figure 1 - Variables view

Variables view toolbar icons

The following commands appear on the Variables view toolbar:

Item	Icons	Explanation
Show Type Names		Toggles the display of type names in the Variables view.
Show Logical Structure		Not available in C/C++ yet.
Collapse All		Collapses all expanded variables into the top level.
Add Global Variables		Click to open the Global Variables dialog where you can select one or more global variables to display in the Variables view. Global variables appear at the top of the variables list.
Remove Selected Global Variables		Click to remove all currently selected global variables from the variables list.
Remove All Global Variables		Click to remove all global variables from the variables list.
View Menu		Enables you to modifiy the Layout to change the view orientation between: horizontal, vertical, or variables pane only and customize the columns shown in the view. - - In addition, use Show All Variables to toggle between showing only those variables that are in scope and live or show all local variables, even if redundant. With this option on you will see all of the variables including the multiple defined variables like “i” for your loops and ones that may no longer have accurate values.

Variables view context menu options

Right-click in the Variables view to access the commands on the Variables view context menu.

Variables view context menu

Figure 2. Variables view context menu commands

The commands include:

Item	Explanation
Select All	Selects all the variables shown in the Variables view.
Copy Variables	Copies the selected variables to the clipboard. - NOTE Only the selected variables visible in the Variables view are copied. Variables listed outside the boundary of the view are not in memory and can't be copied at this time.
Enable	Enables the selected variable.
Disable	Disables the selected variable.
Cast To Type...	Opens the Cast to Type dialog where you can assign a new type to the variable. Enter the type and click OK. - All cast variables are then shown using the Restore Original Type menu option making them easy to identify and restore later. - -
Display As Array...	Opens the Display as Array dialog where you can set array parameters to show the variables. Enter the Start index and Length, then click OK to update how the variables are shown in the Variables view. -
View Memory	Opens a Memory view on the selected variable so you can examine it.
Format	Change the selected variable's display format. The default setting is Natural, or the format assigned when the variable is defined. For example, the decimal value of 256 would appear as: - - Binary (0b100000) - Natural (256) - Decimal (256) - Hexadecimal (0x100) -
Find...	Opens a Find dialog to search for variables. Enter the variable to search for and click OK. -
Change Value...	Opens the Set Value dialog where you can modify the value assigned to the selected variable. Change the value and click OK. -
Add Global Variables...	Select to open the Global Variables dialog where you can select one or more global variables to display in the Variables view. Global variables appear at the top of the variables list.
Remove Global Variables	Remove the selected global variables from the Variables view.
Remove All Global Variables	Remove all global variables from the Variables view.
Add Watchpoint (C/C++)...	Opens the Add Watchpoint dialog enabling you to define a watchpoint on the variable. -
Watch	Creates a watchpoint on the selected variable and displays it in the Watchpoint view.

Other references

Variables and Expressions Overview

Debug view - displays information about a suspended process during a debug session
Variables view - allows manipulation of variables used in source code
Breakpoints view - allows manipulation of breakpoints and watchpoints
Symbian OS Data view - shows kernel data in the Symbian running on the device being debugged
Symbian Data view - shows kernel data in the Symbian running on the device being debugged
Editor view - one or more source code editor windows
Outline view - displays an outline of a structured C/C++ file that is currently open in the editor view

Breakpoints View

Use the Breakpoints view to set, examine, enable, disable, and remove breakpoints and watchpoints in one or more build configurations. Table 1 explains items in the view.

Figure 1 - Breakpoints view

Table 1. Breakpoints view—items

Breakpoints view toolbar options

The following options are present on the Breakpoints toolbar:

Table 1. Breakpoints view toolbar options

Item	When enabled, the breakpoint shown in the editor view is also highlighted in the Breakpoints view. When disabled, the breakpoint selected in the Breakpoints view does not change.
Menu	View Menu		Click to display additional Breakpoint view options for paths and working sets.

Breakpoints view context menu options

The following options are present on the Breakpoints context menu:

Other references

Debug Perspective
Breakpoints
Setting Breakpoints

Disassembly Window