2.1.2. Menu options

The Project menu (shown in Figure 2.1) contains project control commands to create projects, redefine project settings, and control access to projects during your debugging session. Some options in the Project menu are not available unless at least one project is open or a source file is visible in the File Editor pane.

Figure 2.1. Project menu

Project menu

The options available are:

New Project...

Displays the Create New Project dialog box where you can create a new user-defined project. See Common steps for creating a user-defined project for details.

Open Project...

Displays the Select Project to Open dialog box where you can locate a user-defined project to open. A user-defined project is saved with the .prj extension.

You can also open a user-defined project by dragging the appropriate project settings file, with the .prj extension, from Windows Explorer and dropping it into the File Editor pane.

You can also open a project from the Recent Projects list.

Project Control...

Displays the Project Control dialog box where you specify actions to perform on one or more open projects. See Using the Project Control dialog box for details.

Close Project...

Closes an open project. When two or more projects are open, a list selection box is displayed for you to choose which project or projects to close.

Recent Projects

Displays a list of up to nine user-defined projects that you have used in this or previous debugging sessions. On first opening RealView Debugger, this option is grayed out. Each project you create is added to this list, and the list is saved in your start-up file.

Project Properties...

Displays the Project Properties window where you can view and change project settings.

You can also display the Project Properties window by selecting Debug ? Set Source Search Path....

The project properties are saved in the project settings file (*.prj or *.axf.apr). The entries are populated when you first create the project, but you can amend them as required. If you load an image directly, you can use this option to access project properties for the associated auto-project, created by RealView Debugger. See Chapter 5 Using the Project Properties Window for details.

Build-Tool Properties...

Displays the Build-Tool Properties window to enable you to specify the location of development tools accessible to RealView Debugger for building. This option is not used for auto-projects.

It is recommended that you define the build tools before creating your first project. See Managing your build tools for details.

Add This File to Project

Adds the source file that is currently selected in the File Editor pane to the active user-defined project. This option is enabled when a source file is selected in the File Editor pane and a user-defined Standard or Library project is open.

For Custom projects, you must edit your own makefile to add files.

Add Files to Project...

Displays the Select file(s) to Add dialog box to enable you to select one or more source files to add to the active user-defined project. You can also select files from your personal favorites list. This option is enabled when one or more user-defined Standard or Library projects are open.

For Custom projects, you must edit your own makefile to add files to the project.

Update Dependencies

Updates dependencies for the active user-defined project. This option is enabled when a user-defined project is open that contains a makefile.

View Project Source files...

Displays the Project Source View selection box. The display list shows those source files defined in the makefile for the active user-defined project. Select a source file from the list and click Edit to open the file in the File Editor pane. This option is enabled when a user-defined project is open that contains a makefile.

You can also view source files for a project using the Process Control pane. See Managing projects in the Process Control pane for details.

If you select certain options from the Project menu, for example Add Files to Project... or Update Dependencies, the project makefile is regenerated. When this happens, the Output pane switches to the Build tab and displays details about the makefile creation process, shown in Figure 2.2.

Figure 2.2. Rebuilding an application

Rebuilding an application

Do not try to add any files to your project until this process is complete and the results are visible in the Output pane.

Copyright © 2004, 2005 ARM Limited. All rights reserved.ARM DUI 0227C
Non-Confidential