1(Reference Manual) 1(Reference Manual)
NAME
- project change supervisor
SYNOPSIS
function [ option... ]
-Help
DESCRIPTION
The program is a transaction base software configuration management
system. It is used to supervise the development and integration of
changes into projects.
FUNCTIONS
The following functions are available:
-Build
The -Build command is used to build a project. See aeb(1) for
more information.
-Change_Attributes
The -Change_Attributes command is used to modify the
attributes of a change. See aeca(1) for more information.
-Change_Directory
The -Change_Directory command is used to change directory.
See aecd(1) for more information.
-Change_Owner
The -Change_Owner command is used to facilitate reassignment
of the developer of a change in(1,8) the being developed state. See
aechown(1) for more information.
-CLone
The -CLone command is used to exactly replicate a change, usu-
ally on another branch. See aeclone(1) for more information.
-CoPy_file
The -CoPy_file command is used to copy a file(1,n) into a change.
See aecp(1) for more information.
-CoPy_file_Undo
The -Copy_File_Undo command is used to remove a copy of a file(1,n)
from a change. See aecpu(1) for more information.
-DELta_NAme
The -DELta_NAme command is used to add a symbolic name to a
project delta. See aedn(1) for more information.
-Develop_Begin
The -Develop_Begin command is used to begin development of a
change. See aedb(1) for more information.
-Develop_Begin_Undo
The -Develop_Begin_Undo command is used to cease development
of a change. See aedbu(1) for more information.
-Develop_End
The -Develop_End command is used to complete development of a
change. See aede(1) for more information.
-Develop_End_Undo
The -Develop_End_Undo command is used to recall a change for
further development. See aedeu(1) for more information.
-DIFFerence
The -DIFFerence command is used to find differences between
development directory and baseline. See aed(1) for more infor-
mation.
-Integrate_Begin
The -Integrate_Begin command is used to begin integrating a
change. See aeib(1) for more information.
-Integrate_Begin_Undo
The -Integrate_Begin_Undo command is used to cease integrating
a change. See aeibu(1) for more information.
-Integrate_Fail
The -Integrate_Fail command is used to fail a change integra-
tion. See aeifail(1) for more information.
-Integrate_Pass
The -Integrate_PASS command is used to pass a change integra-
tion. See aeipass(1) for more information.
-List
The -List command is used to list interesting things. See
ael(1) for more information.
-MoVe_file
The -MoVe_file command is used to change the name of a file(1,n) as
part of a change. See aemv(1) for more information.
-MoVe_file_Undo
The -MoVe_file_Undo command is used to undo a change to the
name of a file(1,n) as part of a change. See aemvu(1) for more
information.
-New_Administrator
The -New_Administrator command is used to add new administra-
tors to a project. See aena(1) for more information.
-New_BRanch
The -New_BRanch command is used to add a new branch to a
project. See aenbr(1) for more information.
-New_BRanch_Undo
The -New_BRanch_Undo command is used to remove a new branch
from a project. See aenbru(1) for more information.
-New_Change
The -New_Change command is used to add a new change to a
project. See aenc(1) for more information.
-New_Change_Undo
The -New_Change_Undo command is used to remove a new change
from a project. See aencu(1) for more information.
-New_Developer
The -New_Developer command is used to add new developers to a
project. See aend(1) for more information.
-New_File
The -New_File command is used to add new files to a change.
See aenf(1) for more information.
-New_File_Undo
The -New_File_Undo command is used to remove new files from a
change. See aenfu(1) for more information.
-New_Integrator
The -New_Integrator command is used to add new integrators to
a project. See aeni(1) for more information.
-New_Project
The -New_Project command is used to create a new project to be
watched over by . See aenpr(1) for more information.
-New_Project_Alias
The -New_Project_Alias command is used to create a new project
alias. See aenpa(1) for more information.
-New_ReLeaSe
The -New_ReLeaSe command is used to create a new project from
an existing project. See aenrls(1) for more information.
-New_ReViewer
The -New_ReViewer command is used to add new reviewers to a
project. See aenrv(1) for more information.
-New_Test
The -New_Test command is used to add a new test to a change.
See aent(1) for more information.
-New_Test_Undo
The -New_Test_Undo command is used to remove new tests from a
change. See aentu(1) for more information.
-Project_Attributes
The -Project_Attributes command is used to modify the
attributes of a project. See aepa(1) for more information.
-Remove_Administrator
The -Remove_Administrator command is used to remove adminis-
trators from a project. See aera(1) for more information.
-Remove_Developer
The -Remove_Developer command is used to remove developers
from a project. See aerd(1) for more information.
-ReMove_file
The -ReMove_file command is used to add files to be deleted to
a change. See aerm(1) for more information.
-ReMove_file_Undo
The -Remove_File_Undo command is used to remove files to be
deleted from a change. See aermu(1) for more information.
-Remove_Integrator
The -Remove_Integrator command is used to remove integrators
from a project. See aeri(1) for more information.
-ReMove_PRoject
The -ReMove_PRoject command is used to remove a project. See
aermpr(1) for more information.
-Remove_Project_Alias
The -Remove_Project_Alias command is used to remove a project
alias. See aerpa(1) for more information.
-Remove_ReViewer
The -Remove_ReViewer command is used to remove reviewers from
a project. See aerrv(1) for more information.
-RePorT
The -RePorT command is used to generate reports from ' data-
base. These reports may be written by users(1,5), or be distributed
with .
-Review_Fail
The -Review_Fail command is used to fail a change review. See
aerfail(1) for more information.
-Review_Begin
The -Review_Begin command is used to begin to review a change.
See aerb(1) for more information.
-Review_Begin_Undo
The -Review_Begin_Undo command is used to stop reviewing a
change. See aerbu(1) for more information.
-Review_Pass
The -Review_PASS command is used to pass a change review. See
aerpass(1) for more information.
-Review_Pass_Undo
The -Review_Pass_Undo command is used to rescind a change
review pass. See aerpu(1) for more information.
-Test
The -Test command is used to run tests. See aet(1) for more
information.
-VERSion
The -VERSion command is used to get copyright and version(1,3,5)
details. See aev(1) for more information.
All function selectors are case insensitive. Function selectors may be
abbreviated; the abbreviation is the upper case letters. Function
selectors must appear as the first command line argument.
Notification
Many aegis commands are capable of notification that they have been
run. The individual commands document those specific to them. For
documentation on the various configurable notifications, see aepconf(5)
and aepattr(5) for more information.
OPTIONS
The following options are available to all functions. These options
may appear anywhere on the command line following the function selec-
tors.
The following options are available to most functions. These options
may appear anywhere on the command line following the function selec-
tors.
-Change number
This option may be used to specify a particular change within a
project. When no -Change option is specified, the AEGIS_CHANGE
environment variable is consulted. If that does not exist, the
user's $HOME/.aegisrc file(1,n) is examined for a default change
field (see aeuconf(5) for more information). If that does not
exist, when the user is only working on one change within a
project, that is the default change number. Otherwise, it is
an error.
-Change project.Cnumber
As a shortcut, it is possible to combine the -Project and
-Change options into a single option.
-Change branch.Cnumber
Several functions accept(2,8) a -BRanch option; it is possible to
combine the -BRanch and -Change options in(1,8) a single option.
(This intentinally has the same form as the ${version(1,3,5)} substi-
tution output for incomplete changes.)
-Change branch.Dnumber
Several functions accept(2,8) both the -BRanch and -Delta options
(or -BRanch and -Change-From-Delta options); it is possible to
combine them in(1,8) a single option. (This intentinally has the
same form as the ${version(1,3,5)} substitution output for completed
changes.)
-Change project.Dnumber
It is possible to combine the -Project and -Change-From-Delta
options as a single option.
Listings
The following options are available to all listings. These options may
appear anywhere on the command line following the function selectors.
Abbreviations
EXIT STATUS
The command will exit(3,n,1 builtins) with a status of 1 on any error. The command
will only exit(3,n,1 builtins) with a status of 0 if(3,n) there are no errors.
ENVIRONMENT VARIABLES
The command understands the following environment variables:
AEGIS_PATH
A colon-separated list of library directories. See the
-LIBrary option for a description how this environment variable
is used.
AEGIS_PROJECT
Names a default project. See the -Project option for a
description how this environment variable is used.
AEGIS_CHANGE
Specifies a default change. See the -Change option for a
description how this environment variable is used.
AEGIS_FLAGS
This environment variable is used to hold aeuconf(5) informa-
tion, and over-rides the settings in(1,8) the users(1,5) .aegisrc file.
This is intended to be used within the tests distributed with
aegis, but can also be of use within some shell scripts.
AEGIS_THROTTLE
Specifies the number of seconds to delay execution within com-
mands which set(7,n,1 builtins) time(1,2,n) stamps. This is intended to be used
within the tests distributed with aegis, but can also be of use
within some shell scripts.
AEGIS_AUTOMOUNT_POINTS
A colon-separated list of directories which the automounter may
use to mount(2,8) file(1,n) systems. Use with extreme care, as this dis-
torts Aegis' idea of the shape of the filesystem.
This feature assumes that paths below the automounter's mount(2,8)
directory are echoes of paths without it. E.g. When /home is
the trigger, and /tmp_mnt/home is where the on-demand NFS mount(2,8)
is performed, with /home appearing to processes to be a sym-
link.
This is the behavior of the Sun automounter. The AMD auto-
mounter is capable of being configured in(1,8) this way, though it
is not typical of the examples in(1,8) the manual. Nor is it typi-
cal of the out-of-the-box Linux AMD configuration in(1,8) many dis-
tributions.
COLS Specifies the page width for errors and listings. See the
-Page_Width option for a description how this environment vari-
able is used.
EDITOR Specifies the program use to edit files when the -Edit or
-Edit_BackGround options are used. (See also the VISUAL envi-
ronment variable.) Defaults to vi if(3,n) not set. See the
editor_command fields in(1,8) aeuconf(1) for how to override this
specifically for Aegis.
LINES Specifies the page length for listings. See the -Page_Length
option for a description how this environment variable is used.
PAGER Specifies the program to use to view listings and help. Not
used if(3,n) output is to a file(1,n) or a pipe. Defaults to more if(3,n) not
set.
VISUAL Specifies the program use to edit files when the -Edit option
is used. (See also the EDITOR environment variable.) Defaults
to vi if(3,n) not set. See the visual_command fields in(1,8) aeuconf(1)
for how to override this specifically for Aegis.
SEE ALSO
aegis(5)
file(1,n) format syntax
aecattr(5)
change attributes file(1,n) format
aecstate(5)
change state file(1,n) format
aedir(5)
directory structures
aegstate(5)
state file(1,n) format
aepattr(5)
project attributes file(1,n) format
aepconf(5)
project configuration file(1,n) format
aepstate(5)
project state file(1,n) format
aer(1,5)(5) report script language definition
aesub(1,5)(5)
available command substitutions
aeuconf(5)
user configuration file(1,n) format
aeustate(5)
user state file(1,n) format
1(Reference Manual)