7.7 The Project Menu

The menu bar item Project contains several commands that generally act on the whole project hierarchy. If you only want to act on a single project, use the contextual menu in the project view.

Some of these menus apply to the currently selected project. This notion depends on what window is currently active in GPS: if it is the project view, the selected project is either the selected node (if it is a project), or its parent project (for a file, directory, ...). If the currently active window is an editor, the selected project is the one that contains the file.

In all cases, if there is no currently selected project, the menu will apply to the root project of the hierarchy.

These commands are:

New

This menu will open the project wizard (The Project Wizard), so that you can create new project. On exit, the wizard asks whether the newly created project should be loaded. If you select Yes, the new project will replace the currently loaded project hierarchy.

You will get asked what information you would like to create the project from. In particular, you can create a set of project files from existing Ada sources.

New from template

This menu will open the project template wizard, allowing you to create a new project using one of the project templates defined in GPS. See Adding project templates.

Open

This menu opens a file selection dialog, so that any existing project can be loaded into GPS. The newly loaded project replaces the currently loaded project hierarchy. GPS works on a single project hierarchy at a time.

Recent

This menu can be used to easily switch between the last projects that were loaded in GPS.

Edit Project Properties

This menu applies to the currently selected project, and will open the project properties dialog for this project.

Save All

This will save all the modified projects in the hierarchy.

Edit File Switches

This menu applies to the currently selected project. This will open a new window in GPS, listing all the source files for this project, along with the switches that will be used to compile them, See The Switches Editor.

Reload Project

Reload the project from the disk, to take into account modifications done outside of GPS. In particular, it will take into account new files added externally to the source directories. This isn't needed for modifications made through GPS.

Project View

Open (or raise if it is already open) the project view on the left side of the GPS window.