The User's Guide to the
ZEUS Scheme of Modern Software Management

John J. Ryan
Version 1.5
ZEUS-Note: 97-047

June 23, 1997

Abstract:

This document contains a description of the software management scheme for the ZEUS software environment, as seen from the perspective of a user of the software projects. It describes the basic project directory structure, the required environment variables, and some of the conventions that define the scheme. It also covers the building of libraries and executables using GNU Make. It includes a description of an example job.

• Contents
• Introduction
• User's Environment
  • Introduction
  • Environment Variables
  • Shell Resource Files
• Build Control
  • Introduction to the Build Control
  • Internal Conditionalization, CPP
• Setting up for Build Control
  • Typical Project Structure
  • File Extensions
  • Architecture Support
  • Make Procedure
• Example EAZE job
  • Preparing a Project
  • The Project layout
  • Building the Project
  • Job Submission
• From Patchy to Directories
  • Preparing the Project area
  • Converting the CAR-file
• Project Makefiles
  • Command Directory
  • Component Details
    • makefile
    • Makefile.preamble, Makefile.postamble
    • Project Dependencies
• ZEUS Directory Layout
  • Description of the Structure
  • ``Released'' Project Structure
    • Documentation Sub-Tree
    • Support Sub-Tree
    • The zeus Sub-Tree
  • The ZEUS Sub-Tree
    • BField Structure
    • Monte Carlo Structure
    • Programs Structure
    • ZeusAdamo Structure
    • ZeusUtil Structure
    • recon Structure
  • Project Version Support
• References
• About this document ...