Status bar

The status bar is between the source pane and the command pane:

It displays various state information about the currently debugged program. To change the relative sizes of the source and command panes, drag the status bar up or down.

The status bar, from left to right, consists of the Status, the File drop-down list ("File:"), the Procedure drop-down list ("Proc:"), the Back button, and the Forward button.

Status

Messages about the state of the debugger appear in the Status section on the far left of the status bar. Different messages will appear based on the priority of the messages. Program state messages have the lowest priority, error messages are next, and informational messages have the highest priority.
Program state message Description
NO PROCESS
The program to debug has not started.
STOPPED
The program being debugged is stopped.
RUNNING
The program being debugged is currently executing.
DYING
The program being debugged is hung up and killed
FORKING
The debugged process is being forked (UNIX only).
EXEC'ING
The debugged program performs an exec.
CONTINUING
The program is preparing to begin execution.
Informational Message Description
SSrch: string
The source pane is being searched with the incremental search utility for the pattern string (see "Incremental search").

File drop-down list

The File drop-down list displays the base name of the current file:

If the file name is only partially displayed or you want to see the full name of the file, move the cursor over the drop-down list and the full name will appear in a tooltip after a short period of time.

To browse all the source files in the program:

  1. Open the File drop-down list (click the drop-down button).
  2. Choose "Browse all source files in program..."
  3. Choose from the "Source Files with Procedure" window that appears. See also "Browse window for source files".

The File drop-down list also contains up to ten of the most recently displayed files in the source pane. They are sorted according to the time they were loaded into the source pane, with the latest one at the top of the list. When you choose a file from this list, the debugger will load the file into the source pane, with the current line pointer at the position when the file was last in the source pane.

Procedure drop-down list

The Procedure drop-down list displays the name of the current procedure:

If the procedure name is only partially displayed, move the cursor over the drop-down list and the full name will appear in a tooltip after a short period of time.

To browse all the procedures in the program:

  1. Open the Procedure drop-down list (click the drop-down button).
  2. Choose "Browse procedures in program..."
  3. Choose from the "Procedures" window that appears.

To browse all the procedures in the current file:

  1. Open the Procedure drop-down list (click the drop-down button).
  2. Choose "Browse procedures in current file..."
  3. Choose from the "Procedures: current_file" window that appears, where current_file is the name of the current file.

See also "Browse window for procedures".

The Procedure drop-down list also contains up to ten of the most recently browsed procedures in the source pane. They are sorted according to the time they were loaded into the source pane, with the latest one at the top of the list. When you choose a file from this list, the debugger will load the file into the source pane, with the current line pointer at the position when the procedure was last in the source pane.

History navigation buttons

The debugger not only keeps a history of the objects shown in the source pane according to time, but it also keeps a history of procedures according to your browsing logic. To navigate the procedures according to your browsing logic, press the Back ( ) and Forward ( ) buttons on the status bar.

Let's use an example to illustrate the two different orders, time versus browsing logic, using the following program segment:
file1.c file2.c file3.c
current()
{
son();
daughter();
}
son()
{
grandchild();
}

grandchild()
{
foo();
}

daughter()
{
bar();
}

You do the following:

  1. You are viewing "current" in the source pane.
  2. Click "son" to examine it.
  3. Click "grandchild" to examine it.

Now, the top of the procedure drop-down list and the browsing logic history look like this:
Top of Proc drop-down list Browsing Logic History
grandchild
son
current
etc.
grandchild
son
current
etc.

So far, the two orders are the same.

Now, you do the following:

  1. Click the Back button ( ) to go from "grandchild" to "son".
  2. Click the Back button again to go from "son" to "current".
  3. Click "daughter" to examine it.

Now "daughter" is in the source pane. The two orders now look like this:
Top of Proc drop-down list Browsing Logic History
daughter
current
son
grandchild
etc.
daughter
current
etc.

They are different; "son" and "grandchild" have been pruned from the browsing logic list.

See also indexnext and indexprev.

Related topic:


Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.