Building and installing the HEPInventor package

Getting the code

The HEPInventor package is stored in a CVS repository. The repository contains directories for code, documentation/examples, scripts and test programs.
To access the repository define the CVSROOT variable as:

setenv CVSROOT /afs/cern.ch/sw/lhcxx/share/cvsroot

Use cvs co to checkout the repository.

Compiling the code

This step will produce the library libHEPInventor.a.

cd HEPINVENTOR/

gmake

Testing the code

The examples are called Exnnn (where nnn is a number). To install all the examples just type

gmake examples

To install one given example just type:

gmake Exnnn

To run the first test program just type:

Ex001

Not that the HEPInventor package uses the HistOOgrams package, so this package should be installed before starting the HEPInventor package installation.

Documentation

The package is documented via the DOC++ system. One script file is provided to generated the html and the LaTex version of the documentation. It is called doc.mk. Edit this file to defined in which directory you want to install the html pages.

Installing the package

The package has to be installed in the proper location in the share and specific trees. Installation is performed by a gmake using HEPINVENTOR/GNUmakefile.
The GNUmakefile must be updated every time a new release is foreseen: just update the VERSION variable in GNUmakefile. The environment variables LHCXXTOP, PLATF.

Some targets are provided to install the various package components. Directories for the corresponding VERSION are automatically created.This is the list of all targets:

• libinstall installs the shared library in the specific tree
• headerinstall installs eader files in the specific tree
• install installs all of the above mentioned components
• docinstall runs doc.mk.

E.g. to install the library:

gmake libinstall