eh-0.4.readme
*************

Overview
========

eh is an Error Handler.  It provides an error handling framework
that is designed to make developing C and C++ software more
efficient.

The Error Handler provides the following features:

   1. resource tracking - built-in tracking of ANSI resources
        ANSI C: malloc(), calloc(), realloc(), free(), fopen(), fclose(), tmpfile(), fclose
        ANSI C++: operators new and delete

   2. function tracing - emit messages upon function entry and exit
        messages can be controlled at runtime

   3. error log files - send error messages to stderr or a log file
        destination of error messages can be dynamically changed at runtime

   4. error message management - error messages can be sent to one of four error "channels"
        volume of messages on each channel can be controlled at runtime

   5. exception handling - integrated with function tracing to provide a dynamic
        stack trace as the exception is being thrown

   6. control-C (user interrupt) handling - will cleanly and transparently handle
        user interrupt requests

   7. testing - built-in support for simulating exceptions

Disclaimer
==========

This alpha version (v 0.4) should compile and run in a C++
BeOS environment.  It has not been tested with C only.
It has been tested in the Posix environment.  It has not
been tested in a native BeOS environment.  It is not yet
fully thread safe (coming soon!)

Installation
============

After gunziping and untarring the file, you'll have the following
directory structure:

  eh
  eh/src
  eh/examples

Change to the eh directory.  Then decide where you want the library
and headers installed.  Type:

   ./configure --prefix=/my/installation/location
   make
   make install

This will build the library in the src directory, the examples in the
examples directory, and install the library and headers in 
/my/installation/location/lib, /my/installation/location/include.

Each example comes with an extensive README.  More examples are on
the way as well as full documentation.

Have fun!

Christopher Cobb
Cobb Software Engineering Guild, Inc.
ccobb@cseg.com