12.11.4. Project context menus

You can perform project-level operations using context menus available from the Process Control pane. Right-click on the Project, Settings, or Sources entries, shown in Figure 12.16, to display the context menus. For details on these operations see:


If you have several projects open, any unbound projects are usually inaccessible from the Process Control pane by definition. See Project binding for details on how to work on these projects.

Build operations

These operations are available on all the project context menus, unless it is a no-build project or an auto-project:


Builds the application.

Rebuild All

Rebuilds the application.


Cleans the project.

Update Dependencies

Updates all dependencies for the project makefile.


Displays a text box showing information about the project. The box details a subset of the PROJECT group defined at creation.

These operations are also available from the main menu bar. See Using the Project and Tools menus for details.

Project and Settings operations

These options are available, in addition to the build operations, when you right-click on the Project or Settings entry in the Process Control pane:


Closes the project. The action depends on whether the project is a user-defined project or an auto-project:

  • For a user-defined project, if the image is loaded when you close the project, you are prompted to unload the image. If you choose not to unload the image, RealView Debugger closes your user-defined project, and creates an in-memory auto-project for the image. Otherwise, RealView Debugger unloads the image and closes the project.

  • For an auto-project, RealView Debugger closes the project even if the image is loaded.

If the Project Properties window is visible, and you have any unsaved changes, RealView Debugger gives you the option to save the changes before the project closes.

Closing a project automatically unbinds it from the connection.


Saves the in-memory settings for the auto-project to a file called image_name.axf.apr, and places it in the same location as the image file. This option is available only for in-memory auto-projects, that is the Settings entry indicates <Not Saved> and no auto-project settings file exists.

Delete Auto-Project File

Deletes the settings file, image_name.axf.apr, for the auto-project. The Settings status in the Process Control pane changes to <Not Saved>. Delete the auto-project settings file to force RealView Debugger to create a new in-memory auto-project when you next load the image.

This option is only available for a saved auto-project.

Project Properties...

Displays the Project Properties window that enables you to edit the settings for the project.

Source file operations

The Process Control pane displays a list of source files for the current project. Right-click on the Sources entry to specify how RealView Debugger collects this list to populate this pane. The operations available, in addition to the build operations, depend on the type of project:

Collect from Project

Where selected, this indicates that the list of source files shown is derived from the project. The sources are listed in the appropriate COMPILE and ASSEMBLE groups.

This is selected by default for a Standard project.

Collect from Makefile

Select this option if you want to use a project makefile to define which source files are shown.

This is selected by default for a Custom project.

Collect from Image

Select this option if you want to use the image to define which source files are shown. The image must be loaded for the sources to be shown.

This is the only option for an auto-project.


Files might be listed that are not included in the list of files for your project. This is because the file list comes from the image, and so the source paths might be unknown, or unavailable. For example, standard C or C++ library files might be listed.

You must load the image before you change the way that source files are collected if you want to collect from the image.

Working on a source file

You can work on a source file directly from the Process Control pane. Right-click on a file, for example dhry_1.c. and then choose the required option from the context menu. The options available depend on how RealView Debugger collects the list of files (see Source file operations):

Open File

Opens a new tab in the File Editor pane in the default Code window and displays the chosen file for editing. If the selected file is already in the File Editor pane, then the tab is brought to the top for editing.

This option is available when sources are collected from either the project or makefile.

Scope to File

Scopes to the chosen file.

This option is available only when sources are collected from the image.

You can also scope to a specified file by double-clicking on the filename in the Process Control pane.


Displays a text box showing details about the source file.

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