Using the graphical interface of debug

Selecting text

To select an area of text using your mouse, do the following:

Move the cursor to the beginning of the desired text area.
Press and hold the left mouse button.
Move the cursor to the end of the text area you want to change.

To select an area of text using your keyboard, do the following:

Use the arrow keys to move to the text area you want to change.
Press and hold <Shift> while you move the arrow keys to the left or right to highlight the desired text.
Release <Shift>.

To select a word using your mouse, double-click on the desired word to highlight the word.

To select a word using your keyboard, press and hold <Shift/Ctrl>, then press the right and left arrow keys to highlight the word.

Using the Edit menu

Use the options in the ``Edit menu'' to cut, copy, paste, or delete text. The Edit menu is available in the menu bar of the debugger's default configuration. These options are also available in the popup menu in the ``Source pane''.

NOTE: Use ``Cut'' to move text to a new location without retaining the original; use ``Copy'' to duplicate text in a new location without removing the original text from its location.

To cut or copy text and paste it in a new location, do the following:

Select the text to be cut or copied (see ``Selecting text'').
Click on ``Cut'' or ``Copy''. If you choose ``Cut'', the text moves into the clipboard, a temporary storage area. If you choose ``Copy'', a copy of the text moves into the clipboard, and the original text remains.
Click the left mouse button at the point where you want to "paste" the text.
Click on ``Paste''. The text appears in the new location.
Save your changes (see ``Saving text'').

To delete text, do the following:

Select the text you want to remove (see ``Selecting text'').
Click on ``Delete text''.
Save your changes (see ``Saving text'').

NOTE: If you made a mistake or just decide you don't want the changes to take effect, click ``Undo'' before saving the file.

Using the editing keys

You can use a combination of keyboard keys and menu selections to move around quickly within a text file. The following list describes the editing keys and how they work.

Arrow keys - Moves the cursor one space in the direction of the arrow (hold <Ctrl> to move one word in the direction of the arrow).
<Backspace> Moves the cursor backwards one space, erasing the previous character.
<Delete> Moves the cursor forward one space, erasing the next character.
<Home> Moves the cursor to the beginning of the paragraph (hold <Ctrl> to move to the beginning of the file).
<End> Moves the cursor to the end of the paragraph (hold <Ctrl> to move to the end of the file).
<Page Up> Displays the previous page of text.
<Page Down> Displays the next page of text.

Saving text

To save the changes to your source files you may use either the ``Save'' or ``Save As'' options. ``Save'' writes the current contents of the file over the original contents. ``Save As'' allows you to choose a different path name under which to save the current contents.

There are certain debugger actions that can cause the debugger to display a different source file without a specific request from the user: single stepping into a different function, hitting a breakpoint in a different function, changing the current frame. If any of these events occur when the file that is being displayed has unsaved changes, the debugger will attempt to save the current version of the file to a temporary file. When the display switches back to the changed file, the temporarily saved version will be used. If the debugger cannot save the file to a temporary for some reason, it brings up the ``Query File Save'' popup window to ask you how to deal with the changes to the file.

If you explicitly request to change the current file (see ``Open Source'') when the current file has unsaved changes, the debugger brings up the ``Query File Save'' popup window to ask you how to deal with the changes to the file.

If you have one or more files with unsaved changes when you attempt to exit the debugger, the debugger brings up the ``Save Open Source Files'' popup window to ask you how to deal with the changes to the files.

Query File Save

The Query File Save dialog is popped up automatically by the debugger when the current file has unsaved changes and you either explicitly request to change the current file (see ``Open Source'') or the debugger changes the current file because of some process event and cannot save the changes to a temporary file. You are given three choices for the disposition of the changes to the file:

Save: The debugger attempts to write the current contents of the file over the original contents.
Save As: The debugger brings up a file selection dialog to allow you to specify an alternate path name under which to save the current version of the file.
Discard Changes: The debugger discards any changes you have made and redisplays the original version of the file.