Aegis

A Project Change Supervisor

How To

This document describes Aegis version 4.22 and was prepared 11 April 2006.

This document describing the Aegis program, and the Aegis program itself, are

Copyright © 1991-2006 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.


Table of Contents

1. Introduction
1. Assumed Knowledge
2. Howto Install Aegis
3. Howto Contribute
2. Cheat Sheet
1. Common Commands
2. Developer Commands
3. Reviewer Commands
4. Integrator Commands
5. Project Administrator Commands
3. How to Start Using Aegis
1. First, Create The Project
2. Second, Use a Template Project
3. Second, Copy a Template Project
4. How to Recreate Old Versions
1. aecp
2. Finding Delta Numbers
3. ${version}
4. Out Of Date
5. How to Create a New Project
1. Single User Project
2. Two User Project
3. Multi User Project
4. Project Visibility
4.1. Creating Projects
4.2. Web Visibility
5. Changing The Project Owner
6. How to Move a Project
1. Relocating a Project
1.1. From within Aegis
1.2. From outside Aegis
2. Renaming a Project
2.1. From within Aegis
2.2. From outside Aegis
2.3. Project Aliases
7. Working in Teams
1. Local
1.1. Single User, Single Machine
1.2. Multi User, Single Machine
1.3. Multi User, Multi Machine
1.4. Known Problems
2. Distributed
2.1. Multiple Single-User Sites
2.2. Multiple Multi-User Sites
2.3. Telecommuting
8. How to use Aegis with Python
1. Handling Aegis search paths
1.1. The Aegis model vs. the Python model
1.2. The solution
1.3. Why setting PYTHONPATH to the Aegis search path will not work
2. The build step
3. Testing
4. Running your programs
9. Howto End A Branch
10. How to Become an Aegis Developer
1. Required Software
2. Create The Aegis Project
3. The Download
4. The Bleeding Edge
5. Undiscovered Country
6. Sending Changes
7. Guidelines
7.1. What You Can Do
7.2. What You Can't Do
8. Coding Style
9. Writing Tests
10. Debugging
11. The To-Do List
11.1. aecvsserver
11.2. Geographically Distributed Development
11.3. Documentation
11.4. More Reports
11.5. Core Enhancements
11.6. GUI
11.7. Release and Build and Install
11.8. Database