PowerAda Project Menu

From OC Systems Wiki!
Jump to: navigation, search


For more information on projects and their purpose, see Chapter 3, "Basic PowerAda Concepts".

Create New Project

Brings up the New Project dialog, which is used to create a new working project. This dialog contains two fields:

  • Project: This field should contain the name of the new working project.
  • Baseline: This optional field should contain the name of the baseline to use as the new project's parent. The Find button in this dialog brings up a list of known baselines, and information about the baselines.

newproj.gif

This can also be used to change the baseline of an existing project which is not the current project. These functions are available from the command line as aprojinit.

Open Project

Brings up a selection dialog, which lists all directories in the current path. Project directories are marked by the label (project).

open proj.gif

If the project to be opened has an invalid baseline, the user is given the opportunity to change the baseline.

Choosing OK will bring up the Change Baseline dialog, and a new (or no) baseline may then be selected. This mechanism is described later in this chapter. Cancel will return the user to the Open Project dialog.

Baseline Project

Changes the current working project into a baseline. This function is available from the command line with aprojbaseline. A baseline project may be "unbaselined" with "aprojbaseline -u" (not available in a menu).

Delete Project

Deletes a project root and all files, directories and sublibraries under it. This function is available from the command line with aprojrm. Delete Project consists of a cascaded menu with two items; Current Project and Select Project.

Current Project

Deletes the current working project and then brings up the Open Project dialog.

Select Project

Brings up a file selection dialog, with which an existing project can be selected for deletion.

delete project.gif

Project Info

Displays useful information about the current project. This function is available from the command line as aprojinfo.

Change Baseline

Allows the current working project to be "reparented" to a different baseline. As in the Create New Project dialog, the baseline is entered in the text field in this dialog. This function is available from the command line as "aprojinit -c".

change baseline.gif

The Find button in this dialog brings up a Find Baseline dialog which displays a list of known baselines for selection, and information about the baselines. This information is the same as that shown by Project Info above.

find baseline.gif

The Find... button in the Find Baseline dialog brings up a list of all of the projects and directories in the current path, and allows the user to change the current path and look for specific baselines. Baseline directories are marked by the label (baseline).

find baseline1.gif

Environment

This is a cascadeable menu used to bring up either the Environment Variables dialog or the Permissions Mask dialog.

Environment Variables

Displays the current environment variables and their values. The dialog allows several other operations; setting new values for existing variables, adding new variables, and deleting variables.

env vars.gif

Permissions Mask

Displays the file mode creation mask, and allows a new mask value to be set.

perm mask.gif

Preferences

Brings up the Preferences dialog, which controls a number of user-specific variables in powerada.

prefs.gif

Editor

Specifies the editor to be invoked when the Edit command is used. The available editors are XEmacs, vi, dtpad, and "other". Other allows an arbitrary command to be run when the Edit button is pushed. In this command, the following variables may be used: %FILENAME (the filename to be edited), %LINE (the line number to start at), and %TITLE (a title to be used in the editor's window).

Terminal Emulator

Specifies the command to run when New Shell Window is selected. Available choices are xterm, aixterm (on AIX only), and "other". Other allows an arbitrary command to be run. In this command, the following variable may be used: %TITLE (a title to be used in the shell window).

Help Viewer

Specifies the HTML browser to be invoked for displaying the online documentation. The available browsers are Xmosaic, Netscape, and "other". Other allows an arbitrary browser to be run when the online help is requested.

Ada File Suffix

Specifies the Ada file suffixes recognized by powerada. Suffixes may be added or deleted by specifying a list of suffixes separated by a blank space, comma or |. When no suffix is set, powerada uses '.ada', '.adb', and '.ads' as the default suffixes for Ada source files.

Prompt before quitting

If this option is selected (the default), a confirmation dialog is displayed when Quit is selected.

Always refresh views

Causes views to be updated if necessary when returning to them. This ensures that views will always be up-to-date, but may be slower than if the option is not selected.

Use icons on buttonbar

Specifies whether the Buttonbar has icon or text labels.

Show icons in browsers

Specifies whether File Views and Unit Views will display icons for each list item.

Give write access to extracted files

Gives write access to files created in the working project with the Extract Files CM operation or Edit Shadowed File dialog.

Mark compiled files as Ada Source

When selected, looks in the sublibrary to determine whether text files that don't end in any of the Ada File Suffix patterns are Ada files. Selecting this option may slow down transition to new File Views.

Show Messages

When this option is set, the message pane is visible.

New Shell Window

Brings up a window with a shell window running in the same directory as the current view. The type of window that comes up can be set in the Preferences dialog.

Edit File

Invokes the user's preferred editor on the file or files selected in the current view. This is also available on the Popup Menu and the Buttonbar. The editor is set in the Preferences dialog. If the file is shadowed or read-only, the Edit Shadowed File dialog prompts the user with several options.

Print File...

Prints either the current file, or all selected files, depending on the type of view. The Print dialog is shown, in which the command used to print the file(s) may be customized.

print.gif

Save View to File

Saves the contents of the current view to a text file. A file selection dialog is shown, in which the new filename should be entered.

Refresh Window

Recreates the contents of the current view. This is useful in circumstances where the contents may have changed.

Clone Window

Creates a new navigator window. This window will have the same history as the window from which it was cloned.

Close Window

Closes the current navigator window. If the current window is the only one in the powerada session, this is equivalent to quitting powerada.

Quit

Exits the current powerada session. If any compile jobs are running, a dialog is raised which says "Remove all active clients?". Choosing Yes in this dialog will cause any running compile jobs to be interrupted.