Symtab version 0.1
==================

  Symtab reads a table of key/data pairs in a flat-text file
  and generates a symbol table in C.  This provides a
  function which takes a key value as argument and returns
  the corresponding data value.  If the given key is not in
  the symbol table, the function returns -1 or NULL
  depending on whether the data is composed of integers or
  strings respectively.

  Three symbol table mechanisms are provided: list, trie and
  hash.  Each are described at length along with their
  advantages and disadvantages in the perldoc. Note that
  the generated data structures are static, meaning it is
  not possible to insert and remove entries from the table
  after it has been generated.


INSTALLATION

To install this module type the following:

  perl Makefile.PL
  make
  make install


COPYRIGHT AND LICENCE

  Copyright (C) 2001 Marc Tardif

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License
  as published by the Free Software Foundation; either version 2
  of the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  02111-1307, USA.
