# ralcgm/cfg - "Build" settings for package

#---------------------------------------------------------------------

[technotes]

1. Laclin "ralcgm" is a  modified version of an  ancient package  from
1995 with the same name.  Several changes have been made. Most import-
antly:

      a. The new version installs a dynamic library  (i.e.,  a shared-
         object file)  instead of a static  library.

      b. Some Linux-related fixes have been made.  Note: Most of these
         fixes are  taken  from a PLD Linux version of  "ralcgm" dated
         2005.

      c. An "install" feature has been  added.  The  "install" conven-
         tions used are explained in note 3 below.

#---------------------------------------------------------------------

2. This  distro's  "ralcgm"  master resource tree includes  a copy  of
the original  "ralcgm" source tarball from 1995.  The  1995 tarball is
provided  for  reference purposes.  This distro doesn't use  it during
the "build" procedure.

The  old tarball is named  "ralcgm-3.50.tar.Z".  Note:  The tarball in
question was obtained originally from:

      http://www-eng-x.llnl.gov/files/programs/UNIX/ralcgm-3.50.tar.Z

#---------------------------------------------------------------------

3. This package  installs the  following items in the  following loca-
tions:

      [ "PREFIX" stands for the top-level package directory ]

      a. One program file is created. The associated pathname is:
         PREFIX/bin/ralcgm

      b. Library "include" files are placed in a directory named:
         PREFIX/include/libcgm

         The local "build" system creates the  following matching dir-
         ectory,  which contains symbolic links that point back to the
         "include" files:

         /usr/local/include/libcgm

      c. A shared-object library file is placed in a directory named:
         PREFIX/lib

         The library file has a name of the form: foo.so.#.#.#

      d. Appropriate symbolic links are  created in the same directory
         as the shared-object library file:
         PREFIX/lib

         The links have  names of the form:  foo.so.#.#, foo.so.#, and
         foo.so

      e. The local "build" system creates additional symbolic links in
         the standard directory "/usr/local/lib". The additional links
         point to the library files/links described above.

      f. License information is placed in "PREFIX/doc/license.txt".

Note:  You may  need to patch applications  that require the  "libcgm"
library to make them use these locations.

#---------------------------------------------------------------------

4. For more information,  unpack "ralcgm-060826.tar.bz2" and  read the
comments in the following file:

      ralcgm-060826/src/Makefile

#---------------------------------------------------------------------

[buildtimes]

00.00 hours (or 000.17 minutes) - HP EliteBook 8560w 32GB RAM
00.00 hours (or 000.18 minutes) - ThinkPad E540 i7 4x2 16GB RAM
00.00 hours (or 000.25 minutes) - Dell Inspiron 6400 2.0 GHz Intel Duo
                                  7200 2GB RAM
00.01 hours (or 000.70 minutes) - Compaq 1.7 GHz Intel Pentium 4 512MB
                                  RAM

#---------------------------------------------------------------------

[settings]
configure = none
exepack   = yes
license   = See "license.txt" in installed tree
setpath   = xorg
tmpsize   = 7M

#---------------------------------------------------------------------

[depends]
xorg

#---------------------------------------------------------------------

[build]
DOCDIR=$PKGDIR_PROD/doc
mkdir -p $DOCDIR
cp -p $PKGDIR_SPECIAL/license.txt $DOCDIR/

cd include
X="#define DATADIR"
sed -e "s|^$X *\".*|$X \"$PKGDIR_PROD/data\"|" -i mach.h
cd ../src
sed -e "s|^PREFIX *=.*|PREFIX = $PKGDIR_PROD|" -i Makefile

make
make install

#---------------------------------------------------------------------

# Original URLs. These URLs were valid at one point, but may have died
# since then. If you download newer versions of tarballs [etc.], don't
# delete  the  original versions,  as you may not  be able  to replace
# them.

[urls]
url_debian  = n/a
url_home    = http://www.agocg.ac.uk/train/cgm/ralcgm.htm
url_lfs     = n/a
url_tarball = n/a               # See "technotes" in "cfg" file