PowerAda Project Menu
For more information on projects and their purpose, see Chapter 3, "Basic PowerAda Concepts".
Contents
- 1 Create New Project
- 2 Open Project
- 3 Baseline Project
- 4 Delete Project
- 5 Current Project
- 6 Select Project
- 7 Project Info
- 8 Change Baseline
- 9 Environment
- 10 Environment Variables
- 11 Permissions Mask
- 12 Preferences
- 13 Editor
- 14 Terminal Emulator
- 15 Help Viewer
- 16 Ada File Suffix
- 17 Prompt before quitting
- 18 Always refresh views
- 19 Use icons on buttonbar
- 20 Show icons in browsers
- 21 Give write access to extracted files
- 22 Mark compiled files as Ada Source
- 23 Show Messages
- 24 New Shell Window
- 25 Edit File
- 26 Print File...
- 27 Save View to File
- 28 Refresh Window
- 29 Clone Window
- 30 Close Window
- 31 Quit
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.
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).
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.
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".
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.
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).
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.
Permissions Mask
Displays the file mode creation mask, and allows a new mask value to be set.
Preferences
Brings up the Preferences dialog, which controls a number of user-specific variables in powerada.
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.
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.