7.5.4. Saving watches as favorites

When you first run RealView Debugger after installation, all favorites lists, stored in your exphist.sav file, are empty. You can create watches and then add them directly to this list or you can add watches that you have been using in the current debugging session. This section explains the steps to follow to do both.

Creating a watch favorite

To create a Watch favorite, right-click inside a blank entry of the Watch pane to display the Name menu, and then select Add from Favorites.... This displays the Favorites Chooser/Editor dialog box. If this is the first time you have used watches in RealView Debugger, the display list is empty.

To create a new watch and add it to your favorites list:

  1. Click New to display the New/Edit Favorite dialog box shown in Figure 7.11.

    Figure 7.11. New/Edit Favorite dialog box

    New/Edit Favorite dialog box
  2. Enter the expression to be watched, for example Ptr_Comp.

  3. Enter a short text description to help you to identify the watch for future use, for example my watch favorite.

    This is optional.

  4. Click OK to confirm the entries and close the New/Edit Favorite dialog box.

    The Favorites Chooser/Editor dialog box is displayed with the newly-created watch shown in the display list.

    Duplicate entries are not permitted in the favorites list.

The Favorites Chooser/Editor dialog box contains the controls:

New

Displays the New/Edit Favorite dialog box shown in Figure 7.11 where you can create a second watch.

Edit

Highlight a watch in the display list and select this option to display the New/Edit Favorite dialog box already populated with the watch details ready for editing.

Delete

Highlight a watch in the display list and select this option to delete the chosen watch from your favorites list.

Add to List

Adds an existing watch to your favorites list. See Saving existing watches as favorites for details on using this button.

Set

Sets the specified watch on your current debug target.

Close

Closes the Favorites Chooser/Editor dialog box without setting a watch, or changing the displayed list.

Help

Displays the online help for this dialog box.

Saving existing watches as favorites

With several watches already set, RealView Debugger lets you choose which to add to your favorites list so that they are available for re-use in future debugging sessions or with other target configurations of your application program.

To add existing watches to your favorites list:

  1. Highlight an expression in the Watch pane that you want to add to your favorites list.

  2. Right-click on the Name and select Add from Favorites... from the Name menu. This displays the Favorites Chooser/Editor, shown in Figure 7.12.

    Figure 7.12. Existing watches in the Favorites Chooser/Editor

    Existing watches in the Favorites Chooser/Editor

    The display list shows any watches already saved in your favorites list. The data field now shows the chosen expression.

  3. Click Add to List to add the specified expression to your favorites list. This displays the New/Edit Favorite dialog box shown in Figure 7.13.

    Figure 7.13. Adding a new favorite

    Adding a new favorite

    The Expression field contains the chosen watch and you can enter a short text description to help you identify the watch favorite. This is optional.

  4. Click OK to confirm the watch details and close the dialog box.

The Favorites Chooser/Editor dialog box is displayed showing the new watch in the display list. Because this watch is already set, click Close to close the dialog box. If required, set another watch from your favorites list before closing the dialog box.

The edited favorites list is saved to your exphist.sav file when you close RealView Debugger.

Saving data values as favorites

With several watches already set, you can right-click on the Value for a specified expression and display the Value menu. This context menu includes the option Set from Favorites... to specify a data value to be set.

Select this option to display the Favorites Chooser/Editor dialog box where you can:

  • save an existing data value as an entry in your favorites list so that it can be re-used later in this debugging session

  • take a data value already saved and use it to set the starting value for the specified watch.

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential