Elego ComPact Package Management

ComPact Development Team

This manual, as well as the software decribed in it, is furnished under license and may only be used or copied in accordance with the terms of such license. Basically, ComPact consists of some programs and manuals that are free for private and non-commercial use, and some that need to be purchased. The general license documents can be found in English and German at the end of this book.

For more information regarding the details of that license, ComPact itself, and other Elego products and services, contact us at:

      elego Software Solutions GmbH
       --- Elego ComPact Information 
      email: info@elego.de
      www: http://www.elego.de
      or: http://www.elego-software-solutions.com
      Cranachstraße 7
      D-12157
      Berlin
      Germany
      phone: +49.30.85 58 01 81
      fax:   +49.30.85 58 01 88
    



Direct Links: email: info@elego.de www: http://www.elego.de or: http://www.elego-software-solutions.com

This product includes software developed by John D. Polstra.

This product includes software developed by the University of California, Berkeley and its contributors.

This product includes software developed by the System Research Center of Digital Equipment Corporation, now owned by Compaq.

Note: This manual is still work in progress. It is considered to be fairly complete and correct, yet as with all continually developing software products, documentation efforts usually cannot keep pace with the current implementation. Therefore some features of the software that are described in the manual may have changed or become obsolete, while others that are more recent may not be described at all. We do our best to keep the manuals up-to-date, but we are sure that we do not succeed all the time. Thus said, error reports and corrections are of course greatly appreciated.


Table of Contents
I. Introduction
1. Foreword
1.1. Some words about Configuration Management
1.2. Small is beautiful
1.3. About this Manual
2. A Brief Walk Through ComPact
2.1. Getting Started
2.1.1. More on TPC's and TPC Names
2.1.2. Initialization Files
2.1.3. More on ComPact Commands
2.2. Basic Package Usage
2.2.1. Creating Collections and Packages
2.2.2. Package Structure
2.2.3. Building
2.2.4. Shipping
2.2.5. Importing
2.3. A First Impression of Version Control with ComPact
2.4. Summary
II. Package Management
3. Overview
3.1. Overview of the Remaining Chapters
3.2. Consistency Control
4. Packages
4.1. Package Content (C/C++)
4.2. Package Description (C/C++)
4.2.1. Basics
4.2.2. Declaring Source Code, Header, and Template Files
4.2.3. External Defines
4.2.4. Documentation File Declarations
4.2.5. Target Declarations
4.2.6. Import and Export Declarations
4.2.6.1. Import Declarations
4.2.6.2. Export Declarations
4.2.7. Test Sections
4.2.8. File Extension Overrides
4.3. Summary (C/C++)
4.4. Java Packages
4.4.1. Java Package Structure
4.4.2. Java Package Description Language
4.4.3. Java Package Build Management
4.5. Further Package Kinds
5. Build Management
5.1. Building and Shipping
5.2. Further Commands
5.3. Special Options
5.4. Using External Hooks
5.5. Build Management Using Makefiles
5.6. Summary
6. Target/Platform Configuration Management
6.1. TPC-dependent Build Management
6.2. Configuration Files
6.2.1. The Basic Concept
6.2.2. Kinds of package elements in CBCL
6.2.3. Derivations in CBCL
6.2.4. Imported Variables
6.2.5. String and List Manipulation
6.2.6. Exported Variables and Actions
6.2.7. Some words on the selection of actions
6.2.8. A Complete Example
6.2.9. The complete CBCL Syntax
7. Version Management
7.1. The General Development Model
7.2. General Technicalities
7.3. Getting Hold of Collections and Package Versions
7.4. Announcing Additions and Removals of Version-controlled Package Elements
7.5. Committing and Releasing New Package Versions
7.6. Examining the Version Tree
7.7. Version-oriented Shipping and Importing
7.7.1. Shipping
7.7.1.1. Installing Binaries and Documentation
7.7.2. Importing
7.8. Summary
8. Templates
9. Package Management using the Graphical User Interface
List of Tables
2-1.
2-2.
2-3.
2-4.
4-1.
4-2.
5-1.
5-2.
5-3.
6-1.
6-2.
6-3.
6-4.
6-5.
6-6.
6-7.
7-1.
List of Figures
9-1. GUI Package Management Page