Required (External) Software for B-Factory Simulation Project
-------------------------------------------------------------
(External means NOT supplied by B-Factory simulation group)

Native Software
  Fortran (77) Compiler
  cpp (C preprocessor)
  lex 

GNU software (available from prep.ai.mit.edu:pub/gnu)
  make  (version 3.69 or greater, gmake -v displays the version number)
  gawk
  cvs (also rcs if it is not included in cvs)
  gcc
  emacs

SLAC software (available from ftp.slac.stanford.edu:pub/sources)
  rcvs
  rdist

CERN software (available from asis01.cern.ch)
  bin/pawX11
  bin/cmz
  lib    (version 93c or greater, entire directory = 60 Mbytes)

Required Environment Variables
------------------------------
All users must have the following variables defined in their
log in. (see file: profile in this directory for an example)

BFROOT       top of directory tree that contains all B-Factory software
BFLIB        directory containing object libraries for B-Factory software
CERN         top of CERN library tree
CERN_ROOT    current version of CERN library (e.g. /cern/pro) this variable
             is required for FLUKA 

Required components of the $BFROOT/ tree
----------------------------------------
N.B. 'copy contents' means tar the whole tree (see example under archiving).

bin            copy contents (this must be done first, 
                              and must be in your search path to proceed)
src/dbin       copy contents, type 'gmake clean' and 'gmake'
src/pam2unix   copy contents
src/beget      copy contents, type 'gmake clean' and 'gmake'
src/stdhep     copy contents
src/euclid **  copy contents, type 'gmake clean' and 'gmake'
src/CLHEP  **  copy contents; if not on an IBM, recompile
               CLHEP/src/Strings
lib.aix6000/ (if your machine is an RS6000):
  libbeget.a     libdbin.a      libeuclid_f.a  libstdhep.a
  libbeget.o     libeuclid_c.a  libgeanx315.a                 
  (all but geanx are links to libraries in dirs under src)

** = needed only for C++ components

Note about Fortran Compiling
----------------------------
The shell script f77bb (found in $BFROOT/bin) is used as a machine
independent interface to the fortran compiler. Most B-Factory software
packages use it for compiling, so f77bb must be installed before
anything else. Type 'f77bb' for a summary of the options and a list
of supported unix machines. If your machine OS is not listed or you
detect a problem with the settings, try to fix it and notify the
simulation developers to update the SLAC master copy.

Archiving example
-----------------

To 'tar' (create an archive of) the 'dbin' directory, type:

cd $BFROOT/src
tar cfv ~/dbin.tar dbin

The latter command will create an archive of 'dbin' and all of its 
subdirectories. Then binary ftp the file 'dbin.tar' in your home directory 
to your remote platform. On your remote platform, assuming you have
an area called $BFROOT/src, type

cd $BFROOT/src
tar xfv dbin.tar

The latter command will unarchive dbin & its subdirectories below
$BFROOT/src.