Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
tkaegis(1)							    tkaegis(1)

	tkaegis	- GUI interface	for Aegis, using TCL/TK


	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.

	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 imme-
	diately	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	envi-
	ronment	variable; if that fails, it will fall back to emacs or vi).

	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 ap-
	pear 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 as-
	sociated 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 corre-
	sponding aegis command,	where applicable.

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


	    Edit Branch	Attributes (aepa) -
		    Change the attributes for the branch



		Add (aena) -
			Add an administrator for the branch

		View (ael a) -
			View the administrators	for the	branch

		Remove (aera) -
			Remove an administrator	for the	branch


		Add (aend) -
			Add a developer	for the	branch

		View (ael d) -
			View the developers for	the branch

		Remove (aerd) -
			Remove a developer for the branch


		Add (aenrv) -
			Add a reviewer for the branch

		View (ael r) -
			View the reviewers for the branch

		Remove (aerrv) -
			Remove a reviewer for the branch


		Add (aeni) -
			Add an integrator for the branch

		View (ael i) -
			View the integrators for the branch

		Remove (aeri) -
			Remove an integrator for the branch


		Add New	Change (aenc) -
			Add a new change request

		New Change Undo	(aencu)	-
			Undo the addition of a change request

		Edit Change Attributes (aeca) -
			Modify the attributes of a change request

		View Changes (ael c) -
			View the set of	changes

	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	await-
	ing development, this will be auto-selected.


	    View Changes (ael c) -
		    View all the change	requests

	    Begin Change (aedb)	-
		    Start work on a new	change

	    Continue Change -
		    Continue work on a change in development

	    View Differences (aediff) -
		    Show all the diffs for this	change

	    Abort Change (aedbu) -
		    Abort working on the change

	    End	Change (aede) -
		    (Attempt to) end working on	the change

	    Resume Change (aedeu) -
		    Resume work	on a change awaiting review


	    Edit Files -
		    Allow files	to be loaded into an editor

	    Add	New File (aenf)	-
		    Add	a new file to the project

	    Discard New	File (aenfu) -
		    Discard a newly added file

	    Remove Existing File (aerm)	-
		    Discard a previously existing file

	    Restore Existing File (aermu) -
		    Undo discard of a previously existing file

	    Change Existing File (aecp)	-
		    Allow an existing file to be edited

	    Undo Changes to Existing File (aecpu) -
		    Lose changes to an existing	file


	    Build Project (aeb)	-
		    Attempt to build the project


	    Add	New Test Script	(aent) -
		    Add	a new test script to the project

	    Discard New	Test Script (aentu) -
		    Remove a new test script

	    Run	New Tests (aet)	-
		    Run	the new	tests

	    Run	Regression Tests (aet -reg) -
		    Run	the old	tests

	    Run	Baseline Test (aet -bl)	-
		    Run	the baseline test

	In this	mode you are able to review changes.


	    View Changes (ael c) -
		    View all the changes

	    Begin Review (aerb)	-
		    Start reviewing a change

	    Abort Review (aerbu) -
		    Abort reviewing a change

	    Pass (aerpass) -
		    Pass a change review

	    Fail (aerfail) -
		    Fail a change review

	    Undo Pass (aerpu) -
		    Undo a previously passed review

	In this	mode you can perform integration activities.


	    View Changes (ael c) -
		    View all the changes

	    Start Integration (aeib) -
		    Start integrating a	change

	    Resume Integration -
		    Resume an integration in progress

	    Cancel Integration (aeibu) -
		    Cancel an integration

	    View Differences (aediff) -
		    Show the file differences for the change

	    Build (aeb)	-
		    Build the project

	    New	Tests (aet) -
		    Run	the new	tests

	    Baseline Test (aet -bl) -
		    Run	the baseline test

	    Regression Test (aet -reg) -
		    Run	the regression tests

	    Pass (aeipass) -
		    Pass the integration

	    Fail (aeifail) -
		    Fail the integration

		GUI interface for the aeca(1) command.

		GUI interface for the aenc(1) command.

		GUI interface for the aepa(1) command.

	tkaegis	version	4.25
	Copyright (C) 1995, 1999 Graham	Wheeler

	Graham Wheeler <>
	Citadel	Data Security

Reference Manual		     Aegis			    tkaegis(1)


Want to link to this manual page? Use this URL:

home | help