Scroll to navigation

tkaegis(1) tkaegis(1)

NAME

tkaegis - GUI interface for Aegis, using TCL/TK

SYNOPSIS

tkaegis

DESCRIPTION

The tkaegis command is used to provide a GUI interface to Aegis. Its use should be self-evident to anyone familiar with Aegis.

There are some areas where tkaegis is still missing functionality; these are primarily related to project and change attributes that are not yet included in the dialogs, and also issues such as configuring the change and history tools, the architectures, and so on.

INSTALLATION

First, you will need Tcl/Tk installed, and will need to modify the path in the first line of tkaegis to reflect the path of your Tk wish interpreter. Hopefully, the ./configure script took care of this.

Next, you may need to modify some important variables that occur immediately below these comments, to specify the architecture, project base directory, and the editor you are using (if you leave that blank, tkaegis will try to determine the editor to use from the EDITOR environment variable; if that fails, it will fall back to emacs or vi).

NAVIGATION

When you run tkaegis, a window will appear with a menu at the top. The window is used to display the output of aegis commands and some other feedback. The menu will initially have only two items, Project and Help. At this stage the Help menu only has an About dialog box.

The Project menu will allow you to create new projects, select from your existing projects, clear the contents of the feedback window, or exit the program. If you create a new project, a dialog box will appear allowing you to enter the project name, directory, and initial branch number. When you press OK the project will be created and should then appear in the Project menu.

If you select an existing project, a new option will be added to the Project menu, allowing you to delete the project. A Branch menu will also appear. This is similar to the Project menu, but allows you to create, delete, or select project branches.

If you select a branch in the branch menu, a Role menu will appear. This will allow you to choose the role that you will be playing, namely one of administrator, developer, reviewer, or integrator. tkaegis uses your UNIX login name and the names of the roleplayers associated with the project and branch, to determine which of the roles it will allow you to choose. If you create a new project, only the administrator role will appear.

Selecting a role will put you in a `mode', which will determine what other menus appear and what you can do next. Each mode will now be described in turn, by giving a brief description of the role-specific menu hierarchy. Following the name of each menu item is the corresponding aegis command, where applicable.

ADMINISTRATOR MODE

In this mode, you can modify the staff and roles associated with the branch, and create, remove, and change the attributes of change requests, and view all the change requests.

Change the attributes for the branch
Add an administrator for the branch
View the administrators for the branch
Remove an administrator for the branch
Add a developer for the branch
View the developers for the branch
Remove a developer for the branch
Add a reviewer for the branch
View the reviewers for the branch
Remove a reviewer for the branch
Add an integrator for the branch
View the integrators for the branch
Remove an integrator for the branch
Add a new change request
Undo the addition of a change request
Modify the attributes of a change request
View the set of changes

DEVELOPER MODE

This mode is used by developers. When entering this mode, the Develop menu will appear, but no others. A change must be selected after which the other menus will appear. If there is only one change awaiting development, this will be auto-selected.

View all the change requests
Start work on a new change
Continue work on a change in development
Show all the diffs for this change
Abort working on the change
(Attempt to) end working on the change
Resume work on a change awaiting review
Allow files to be loaded into an editor
Add a new file to the project
Discard a newly added file
Discard a previously existing file
Undo discard of a previously existing file
Allow an existing file to be edited
Lose changes to an existing file
Attempt to build the project
Add a new test script to the project
Remove a new test script
Run the new tests
Run the old tests
Run the baseline test

REVIEWER MODE

In this mode you are able to review changes.

View all the changes
Start reviewing a change
Abort reviewing a change
Pass a change review
Fail a change review
Undo a previously passed review

INTEGRATOR MODE

In this mode you can perform integration activities.

View all the changes
Start integrating a change
Resume an integration in progress
Cancel an integration
Show the file differences for the change
Build the project
Run the new tests
Run the baseline test
Run the regression tests
Pass the integration
Fail the integration

SEE ALSO

GUI interface for the aeca(1) command.
GUI interface for the aenc(1) command.
GUI interface for the aepa(1) command.

COPYRIGHT

tkaegis version 4.24.3
Copyright © 1995, 1999 Graham Wheeler

AUTHOR

Graham Wheeler <gram@cdsec.com>
Citadel Data Security

Aegis Reference Manual