# HG changeset patch # User fturovic # Date 1251914092 18000 # Node ID bb1095fec5b316a1c989baa11d18d3447a29c76c # Parent 255538df147afef3296b2a386505622815ab0745 removed unused pages and images for watchpoints, variables, and expressions diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/reference/view_expressions.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_expressions.htm Wed Sep 02 11:38:14 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_expressions.htm Wed Sep 02 12:54:52 2009 -0500 @@ -1,79 +1,78 @@ - - - - - - -Expressions Window - - - -

Expressions View

-

The Expressions view helps you monitor and manipulate these items:

- -

The Expressions view displays these columns:

- -

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

-

-

Figure 1 - Expressions view

-
Table 1. Expressions view —items
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ItemIconsExplanation
Show Type Names
Toggles the display of type names in the Expressions view.
Show Logical Structure
Not available in C/C++ yet.
Collapse All
Collapses all expanded expressions into the top level.
Remove Selected Expression
Click to remove all currently selected expressions from the expressions list.
Remove All Expressions
Click to remove all expressions from the expressions list.
-

Opening the Expressions View

-

Use the Expressions view to inspect frequently used variables as their values change during a debugging session.

-
-

Opening an Expressions view

- -
-
Related tasks
- - - - - + + + + + + +Expressions Window + + + +

Expressions View

+

The Expressions view helps you monitor and manipulate these items:

+ +

The Expressions view displays these columns:

+ +

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

+

+

Figure 1 - Expressions view

+
Table 1. Expressions view —items
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ItemIconsExplanation
Show Type Names
Toggles the display of type names in the Expressions view.
Show Logical Structure
Not available in C/C++ yet.
Collapse All
Collapses all expanded expressions into the top level.
Remove Selected Expression
Click to remove all currently selected expressions from the expressions list.
Remove All Expressions
Click to remove all expressions from the expressions list.
+

Opening the Expressions View

+

Use the Expressions view to inspect frequently used variables as their values change during a debugging session.

+
+

Opening an Expressions view

+ +
+
Related tasks
+ + + + + diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_adding.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_adding.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,68 +0,0 @@ - - - - - - -Adding Expressions - - - -

Adding Expressions

-

You can add adding expressions for inspection using a variety of views, including Expressions, Variables, and editor views .

-

You can enter any valid C/C++ expression, for example:

-
-

2 + 2
- myVariable + 8
- &myVariable
- myClass.myMemberVar
- etc.

-
-

Are all valid expressions that the Expression view can monitor and display. However, the expression cannot call a function or execute code. The following example will not work:

-
-

std:strlen("Hello");

-
-
-

Adding Expressions

- -
-
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_editing.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_editing.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,37 +0,0 @@ - - - - - - -Editing Expressions - - - -

Editing Expressions

-

You can edit any valid C/C++ expression in the Expressions view using Edit Watch Expression.

-
-

Editing Expressions

-
    -
  1. Right-click an expression and select Edit Watch Expression
    2. -

    The Edit Watch Expression window (Figure 1) appears.

    -

    -

    Figure 1 - Edit Watch Expression window

    -
  2. Modify the expression in the Expression text box.
    3. -
  3. Click OK.
    4. -

    The modified expression appears in the Expressions view.

    -
-
-
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_removing.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/expressions/expr_removing.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,51 +0,0 @@ - - - - - - -Removing Expressions - - - -

Removing Expressions

-

The Expressions view handles various ways of removing expressions that no longer require inspection.

-
-

Removing an Expression from the Expressions view

- -
-

or

-
- -
-
-

Removing All Expressions from the Expressions view

- -
-

or

-
- -
-
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/set_variable_formats.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/set_variable_formats.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,93 +0,0 @@ - - - - - - -Setting Variable Formats - - - -

Setting Variable Formats

-

You can change the way the Variables view displays data. For example, you can add labels to variable data so that those labels appear in the Variables view and clarify the displayed data.

-

For example, suppose you have the structure defined in Listing 1.

-
-
Listing 1 Sample structure definition
-

struct Rect {
- short top;
- short left;
- short bottom;
- short right;
- };

-
-

The Variables view might show an instance of the Rect structure like this:

-

myRect 0x000DCEA8

-

You can create an XML file that defines a new way to display the structure, as shown in Listing 2.

-
-
Listing 2 Sample variable format definition
-

<variableformats>
-<variableformat>
-<osname>osWin32</osname>
-<runtimename>runtimeWin32</runtimename>
-<typename>Rect</typename>
-<expression>
-"{T: " + ^var.top +
-" L: " + ^var.left +
-" B: " + ^var.bottom +
-" R: " + ^var.right +
-"}{H: " + (^var.bottom - ^var.top) +
-" W: " + (^var.right - ^var.left) + "}"
-</expression>
-</variableformat>
-</variableformats>

-
-

Given this new variable format definition, the Variables view now shows the same myRect instance like this:

-

myRect {T: 30 L: 30 B: 120 R: 120}{H: 90 W: 90}

-

To manipulate variable formats, you place an XML file that defines the new format inside the VariableFormats directory at

-
-

<CARBIDE>\plugins\com.nokia.carbide.cpp.support_2.0.0.xxx\Debugger\Plugins\Support\VariableFormats

-
-

where Carbide is the path to your Carbide installation.

-

The IDE reads the XML files in this directory to determine how to display variable data. Table 1 explains the main XML tags that the IDE recognizes.

-
Table 1 Variable formats—XML tags
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TagExplanation
variableformatsA group of variable format records.
variableformatAn individual variable format record.
osnameThe operating system that defines the scope of this record.
runtimenameThe runtime that defines the scope of this record.
typenameThe name of the Type that this record will format.
expressionThe expression that reformats the variable display. The IDE evaluates this expression to determine the format that it applies to the variable. The IDE replaces all occurrences of the ^var placeholder with the name of the variable.
-
Related references
- - - - - \ No newline at end of file diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/show_global_variables.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/show_global_variables.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,35 +0,0 @@ - - - - - - -Showing Global Variables - - - -

Showing Global Variables

-

The Variables view can also display global variables used by the program. Use the Add Global Variables command to select which global variables are displayed in the Variables view.

-

-

Figure 1 - Select global variables window

-
-

To show global variables

-
    -
  1. Right-click in the Variables view, then select Add Global Variables from the context menu, or click the Add Global Variables button ()
    2. -

    The Global Variables dialog box appears (Figure 1).

    -
  2. Select one or more global variables from the Select Variables list
    3. -
  3. Click OK
    4. -

    The selected global variables are added to the Variables view.

    -
-
-
Related references
- - - - - \ No newline at end of file diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/show_variables_view.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/variables/show_variables_view.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,28 +0,0 @@ - - - - - - -Opening the Variables View - - -

Opening a Variables View

-

Use the Variables view to show a single variable or variable hierarchy used in source code.

-
-

To open a Variables view

- -
-
Related references
- - - - - \ No newline at end of file diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_disabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_disabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_enabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_enabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_disabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_disabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_enabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_enabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_enabled_resolved.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_rw_enabled_resolved.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_disabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_disabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_enabled_resolved.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_enabled_resolved.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_resolved.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_resolved.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/watchpoint_disabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/watchpoint_disabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/watchpoint_enabled.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/watchpoint_enabled.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/wnd_add_watchpoint.png Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/wnd_add_watchpoint.png has changed diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_watchpoints.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_watchpoints.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,29 +0,0 @@ - - - - - - -Watchpoints - - - -

Watchpoints

-

This section describes how to setup and use watchpoints to monitor memory locations. The topics include:

- -

NOTE Watchpoints are only available for emulator build configurations.

-
Related concepts
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_clearing.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_clearing.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,42 +0,0 @@ - - - - - - -Clearing Watchpoints - - - -

Clearing Watchpoints

-

Use the Toggle Watchpoint menu item to clear a watchpoint.

-
-

Clearing a Watchpoint

- -
-
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_conditional.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_conditional.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,52 +0,0 @@ - - - - - - -Setting a Conditional Watchpoint - - - -

Setting Conditional Watchpoints

-

Use the Properties view to set a conditional watchpoint. A conditional watchpoint has an associated conditional expression. The debugger evaluates the expression to determine whether to halt program execution at that watchpoint.

-

A conditional watchpoint behaves in two different ways:

- - -
-

To set a Conditional Watchpoint

-
    -
  1. Find the watchpoint that you want to associate with a conditional expression in the Breakpoints view
    2. -
  2. Right-click the watchpoint, then select the Properties menu item
    3. -

    The Properties view appears.

    -
  3. Enter an expression in the Condition text box
    4. -

    During subsequent debugging sessions, the debugger evaluates the expression to determine whether to halt program execution at the conditional watchpoint. -

    -
  4. Click OK
    5. -

    The watchpoint's Proeprties window closes.

    -
-
-
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_disable.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_disable.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,44 +0,0 @@ - - - - - - -Disabling a Watchpoint - - - -

Disabling a Watchpoint

-

Disable a watchpoint to prevent it from affecting program execution. The disabled watchpoint remains at the memory location at which you set it, so that you can enable it later.

-

-

Figure 1. Disabled watchpoint example in Breakpoints view

-
-

Disabling Watchpoints

- -
    -

    An empty checkbox () next to the watchpoint indicates the watchpoint is disabled.

    -
-
- -
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_enable.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_enable.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,44 +0,0 @@ - - - - - - -Enabling a Watchpoint - - - -

Enabling a Watchpoint

-

Enable a watchpoint to have it halt program execution when its associated memory location changes value. Enabling a watchpoint that you previously disabled is easier than clearing it and re-creating it from scratch.

-

-

Figure 1. Enabled watchpoint example in Breakpoints view

-
-

Enabling Watchpoints

- -
    -

    A checkmark in the checkbox () next to the watchpoint indicates the watchpoint is enabled.

    -
-
- -
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_setting.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_setting.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,84 +0,0 @@ - - - - - - -Setting a Watchpoint - - - -

Setting a Watchpoint

-

Use the Toggle Watchpoint command to set a watchpoint on a global variable in a C/C++ editor view. A watchpoint suspends program execution when the memory location that you specify is accessed with a write or read operation and it's based on the access setting. Watchpoints can also be added directly in the Variables, Breakpoints, Outline, and the Memory Rendering views.

-

The debugger halts program execution on the line of source code that triggered the watchpoint. This is different than a breakpoint, which halts program execution prior to executing the line of source code on which the breakpoint is set.

-
    -

    -

    Figure 1. Add Watchpoint window

    -
-
Table 1. Add Watchpoint options
- - - - - - - - - - - - - - - - - -
NameDescription
Expression to watch
If not already entered, you can enter any arbitrary memory location for watching.
UnitsDefine the size of the units to monitor. This setting defaults to the size of the variable to watch. If an arbitrary memory address is entered, then the default unit size is set to 1 byte. Once you enable the units checkbox, you're must enter a value for it.
Access: Write/Read Check the appropriate access type to trigger the watchpoint for the specified memory location.
-
-

Setting a Watchpoint

-

The following steps work with C/C++ editor views, as well as the Variables, Breakpoints, and Outline views:

-

NOTE Watchpoints are shown in the Outline view, while breakpoints are not.

-
    -
  1. Right-click any global variable in the view
    2. -

    The global variable is highlighted in the source file.

    -
  2. Select the Toggle Watchpoint menu item
    3. -

    The Add Watchpoint window appears (Figure 1).

    -
  3. Select the Access type for the watchpoint (write, read, or select both)
    4. -

    Click to set a checkmark in the Write, Read, or both checkboxes at once.

    -
  4. Click OK
    5. -

    The Add Watchpoint window closes, the new watchpoint appears in the Breakpoints view list, and the appropriate watchpoint status icon appears in the marker bar next to the global variable.

    -
-
-
-

Setting a Watchpoint in Memory Rendering Views

-
    -
  1. Right-click any global variable address previously added to the Memory Rendering view
    2. -

    The global variable is highlighted in the source file.

    -
  2. Select the Add Watchpoint (C/C++) menu item
    3. -

    The Add Watchpoint window appears (Figure 1).

    -
  3. Select the Access type for the watchpoint (write, read, or select both)
    4. -

    Click to set a checkmark in the Write, Read, or both checkboxes at once.

    -
  4. Click OK
    5. -

    The Add Watchpoint window closes, the new watchpoint appears in the Breakpoints view list, and the appropriate watchpoint status icon appears in the marker bar next to the global variable.

    -
-
-
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_view_props.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/pgm_wpt_view_props.htm Wed Sep 02 11:38:14 2009 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,39 +0,0 @@ - - - - - - -Viewing Watchpoint Properties - - - -

Viewing Watchpoint Properties

-

After you set a watchpoint, you can view and modify its properties.

-
-

To view properties for a watchpoint

-
    -
  1. Select its name in the Breakpoints view
    2. -
  2. Click Breakpoints > Breakpoint Properties
    3. -
-
-
Related concepts
- -
Related tasks
- -
Related references
- - - - - diff -r 255538df147a -r bb1095fec5b3 core/com.nokia.carbide.cpp.doc.user/index.xml --- a/core/com.nokia.carbide.cpp.doc.user/index.xml Wed Sep 02 11:38:14 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/index.xml Wed Sep 02 12:54:52 2009 -0500 @@ -36,17 +36,15 @@ - - - - - - - - - - - + + + + + + + + + - - - - - - - + + + +