           SPELL=coal
         VERSION=${VERSION:=0.2.4}
if [[ "${COAL_CVS}" = "y" ]]
then
if [[ "${COAL_CVS_AUTOUPDATE}" = "y" ]]
then
         VERSION=$(date +%Y%m%d)
else
         VERSION=cvs
fi
          SOURCE=$SPELL-cvs.tar.bz2
   SOURCE_URL[0]=cvs://:pserver:cvsanon:cvsanon@cvs.worldforge.org:/home/cvspsrv/worldforge:forge/libs/coal
  FORCE_DOWNLOAD=1
   SOURCE_IGNORE=volatile
SOURCE_DIRECTORY=$BUILD_DIRECTORY/$SPELL-cvs
else
          SOURCE=$SPELL-$VERSION.tar.bz2
   SOURCE_URL[0]=ftp://ftp.worldforge.org/pub/worldforge/libs/COAL/$SOURCE
   SOURCE_URL[1]=http://purple.worldforge.org/downloads/libs/${SPELL}/${SOURCE}
     SOURCE_HASH=sha512:0d5c34fbd9d51fc284b92c531534efca1ce34d4c9e879cd342da8151e42912526e5006d8437d84774cb62827a620b960cea3c5d0eca5cc2dc4b1b4e28d9c9485
SOURCE_DIRECTORY=$BUILD_DIRECTORY/$SPELL-$VERSION
fi
        WEB_SITE=http://www.worldforge.org/dev/eng/libraries/coal
         ENTERED=20020915
         UPDATED=20020915
      LICENSE[0]=GPL
       BUILD_API=1
           SHORT="C++ utility library for WorldForge developers"
cat << EOF
COAL is a C++ utility library for client and editor developers. It provides:
  * An abstract framework for storing and retrieving map data.
  * Facilities for converting 3D polygon regions into 2D tile grids (ported
    from Sal's libMIM).
  * Convenience functions for interfacing with Atlas.
  * Possibly CORBA wrappers, in the distant future.
  * More to follow...

Client developers can use COAL to handle data storage and to act as a layer
between the application and the Atlas libraries. As map updates come in from
the server, COAL will process them and update its internal database. The
client app can then query COAL as it needs, for map rendering and so forth.
COAL may eventually also handle character inventory data caching and other
useful object handling features.

COAL stores map data as 3D regions. If the client app enables COAL's 2D mode,
COAL will also translate the regions into a map of 2D tiles which a 2D client
can render as it sees fit, using whatever media repository it wants.

NOTE: COAL and related components like libAtlas and the map format are still
in flux, so the focus, goals, and dependencies of COAL may change in response
to its changing environment. If you see anything that's silly or downright
wrong with the code and its implementation, please let me know. The purpose
of COAL is to make life easier for client developers, so anything I can do to
make it more useful is a step in the right direction.
EOF
