.\"
.\"	aegis - project change supervisor
.\"	Copyright (C) 1991, 1992, 1993, 1995, 1998, 1999 Peter Miller;
.\"	All rights reserved.
.\"
.\"	This program is free software; you can redistribute it and/or modify
.\"	it under the terms of the GNU General Public License as published by
.\"	the Free Software Foundation; either version 2 of the License, or
.\"	(at your option) any later version.
.\"
.\"	This program is distributed in the hope that it will be useful,
.\"	but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"	GNU General Public License for more details.
.\"
.\"	You should have received a copy of the GNU General Public License
.\"	along with this program; if not, write to the Free Software
.\"	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: User Guide, Introduction, How to use this manual
.\"
.bp
.nh 2 "How to use this manual"
.LP
This manual assumes the reader is already familiar with the
.UX
operating system,
and with developing software using the
.UX
operating system
and the tools available;
terms such as
.I RCS
and
.I SCCS
and
.I make (1)
are not explained.
.LP
There is also the assumption that the reader is familiar with the issues surrounding team development of software;
coordination and multiple version issues, for example, are not explained.
.LP
This manual is broken into a number of sections.
.IP "Chapter 2"
describes
how aegis works and
some of the reasoning behind the design and
implementation of the aegis program.
Look here for answers to "Why does it..." questions.
.IP "Chapter 3"
is a worked example of how particular users
interact with the aegis program.
Look here for answers to "How do I..." questions.
.IP "Chapter 4"
is a discussion of how aegis interacts
with the History Tool,
and provides templates and suggestions
for history tools known to work with aegis.
.IP "Chapter 5"
is a discussion of how aegis interacts
with the Dependency Maintenance Tool (DMT),
and provides templates and suggestions for DMTs known to work with aegis.
.IP "Chapter 6"
is a discussion of how aegis interacts
with the Difference Tools,
and provides templates and suggestions for difference tools
known to work with aegis.
.IP "Chapter 7"
describes the project attributes
and how the various parameters may be used for particular projects.
.IP "Chapter 8"
describes managing tests and testing with Aegis.
.IP "Chapter 9"
describes the branching mechanism used in Aegis.
.IP "Chapter 10"
is a collection of helpful hints on how to use aegis effectively,
based on real-world experience.
This is of most use when initially placing projects under the supervision
of the aegis program.
.IP "Chapter 11"
describes how to manage geographically distributed development using Aegis.
.IP "Appendix A"
is a quick reference for placing an existing project under aegis.
.IP "Appendix B"
is a glossary of terms.
.IP "Appendix D"
is a description of why Aegis must be set-uid-root,
for system administrators who are concerned about the security issues.
.IP "Appendix I"
is a brief look at internationalization and localization if Aegis.
.br
.ne 2i
.nh 2 "GNU GPL"
.LP
Aegis is distributed under the terms and conditions of
the GNU General Public License.
Programs which are developed using Aegis are not automatically
subject to the GNU GPL.
Only programs which are derivative works based on GNU GPL code
are automatically subject to the GNU GPL.
We still encourage software authors to distribute their work under
terms like those of the GNU GPL,
but doing so is not required to use Aegis.