Contents of this directory are copyright (C) Kevin B. McCarty, 2001-2006,
except where noted otherwise.  They are licensed under the GNU General
Public License, version 2 or later, at your choice.

A copy of the GNU GPL may be found on Debian systems at:
/usr/share/common-licenses/GPL
or on the Web at: http://www.gnu.org/copyleft/gpl.html

This directory contains numerous patches and additions to the canonical version
of the GEANT 3.21 libraries supplied by CERN.  To compile them accordingly,
copy the Makefile in this directory to the top-level geant321 source directory
and run make with whatever variables you like.  (You will first need to have
installed the main CERNLIB and PAW libraries from my packaging of those.)

This packaging of the CERNLIB GEANT 3.21 libs adds support for:

- shared libraries (Linux only)
- Mac OS X compilation
- Filesystem Hierarchy Standard: run make with these variables set:
	"make prefix=/usr sysconfdir=/etc mandir=/usr/share/man"
- recursive dependency checking with a rewritten "cernlib" script
- common GNU Makefile directories, e.g. $prefix, $datadir
- automatic generation of CERNLIB documents included with the source
- various other bug fixes

Note that unlike the upstream version of CERNLIB, which installs to
$CERN/$CERN_LEVEL (e.g. /opt/cern/2003), this packaging of CERNLIB GEANT 3.21
libraries will install them to /usr/local/lib.  Or change this by specifying
$prefix with the "make" command.

Things NOT included in this packaging of GEANT 3.21:

- GEANT-FLUKA code; see http://www.fluka.org/Faq.html

These are omitted for licensing reasons (i.e. I am not convinced that it
is permissible for me to distribute them under the terms of the GPL).
See http://people.debian.org/~kmccarty/cernlib/ for more information.

--Kevin McCarty, 29 June 2006

