The ZEUS Scheme of Modern Software Management involves a complex hierarchical directory structure of the maintained software, which groups the various libraries into categories according to functionality.
It also employs several Industry standard tools: the Concurrent Version System (CVS), GNU Make, and the C-preprocessor.
Previously, ZEUS software was being maintained using CMZ. However, this is no longer freely distributed by CERN, and they have converted all of their software distribution to a hierarchical directory structure, with the versioning performed by CVS and the conditionalization handled by the C-preprocessor. They have a nice web-page on this process.
People who want to work should read the User's Guide. This details how to set up the appropriate environment, which is the most important part. Then, it leads the reader through a conversion of a simple EAZE job.
For converting old Patchy Card files to the new system, there is a program: "patchy_to_dirs.exe". This is what makes converting trivial. This runs on the Suns and the SGIs, and it is on the PATH, once the environment is setup. For simple projects, the "--help" command to the program should be enough. For more complicated projects, the user should read the document, Patchy to Directories Convertor.
The full, gory details of the inner workings of the system can be found in the Reference Manual. This is mainly important for managers of the system itself; users will only need to look in here when they start getting really sophisticated.
For a vision of the doors that have been opened, ask one of the young people already using the system. Or buy me a beer....
Good Luck -
The Release Notes document the recent changes to the files and the system. These notes may be found in the directory:
$ZPROJ_ROOT/Documentation/Release_NotesThere are some hints for solving the most common problems with getting started with the new system. These notes may be found in the troubleshooting document
Introduction to the ZEUS Scheme of Modern Software Management
(ZEUS Note 97-045) (dvi) (ps)
This document contains a brief description of the new software management scheme for the ZEUS software environment. It is meant as a ``gentle'' introduction, defining the acronyms of the products and explaining why the products are useful, and pointing to more detailed descriptions available in other documents.
The Reference Manual for the ZEUS Scheme of Modern Software Management
(ZEUS Note 97-046) (dvi) (ps)
This document is the reference manual for the ZEUS Scheme of Modern Software Management. It contains a detailed description of the scheme. It describes the directory structure, the required environment variables, and some of the conventions that define the scheme. It describes the handling of the version management using CVS, including some step-by-step examples. It covers the building of libraries and executables using GNU Make. It outlines the recommended usage of the system. It also describes the functionality of all the system-level makefiles. If it has to do with the Management Scheme, it's in this manual.
The User's Guide to
the ZEUS Scheme of Modern Software
Management
(ZEUS Note 97-047)
(dvi)
(ps)
(html)
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.
The Manager's Guide to the ZEUS Scheme of Modern Software Management
(ZEUS Note 97-048) (dvi) (ps)
This document contains a description of the software management scheme for the ZEUS software environment, as seen from the perspective of a Manager of software projects. It describes the handling of the version management using CVS, including some step-by-step examples. It covers the building of libraries and executables using GNU Make
Patchy to Directories Convertor
(ZEUS Note 97-044) (dvi) (ps)
This document contains a description of the Patchy-to-Directories Convertor. This program parses a Patchy Card-file and builds a directory structure containing files extracted from the Decks of the Patchy file. It converts Patchy conditionalization and inclusion of sequences to the corresponding C-preprocessor commands in the extracted files.
Adamo-windows Generation under the ZEUS Scheme of Modern Software Management
(ZEUS Note 97-049) (dvi) (ps)
This document contains a description of the handling of Adamo under the ZEUS scheme of Modern Software Management. It describes the step-by-step generation of the ``windows'' common blocks and the initialization ``crexxx'' routines from the ddl-specifications.
Projects of the ZEUS Modern Software Management
The list of all the projects defined under ZSMSM and the definitions
of their Make macros can be found in the
Project Definitions document .
How to Get Started
Transparencies from a tutorial can be found here
(
in HTML )
(
in PostScript ).
This document contains a description of the GNU version of Make. It is the manual distributed with the product.
CVS Manual
(ps)
This document contains a description of the Concurrent Version System (CVS). It is the manual distributed with the product.
CVS Quick Reference
(ascii)
This document contains a brief tutorial on using the Concurrent Version System (CVS).
CVS Manpage
(ps)
This is a PostScript form of the manpage for the Concurrent Version System (CVS).
Please send a mail to jryan@retrograde.desy.de
Last Update : 7 Oct 1997 (John J. Ryan)