 #
 #  '$RCSfile$'
 #  Copyright: 2000 Regents of the University of California 
 #
 #   '$Author$'
 #     '$Date$'
 # '$Revision$' 
 # 
 # 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
 #

Metacat.pm -- perl client to the Metacat XML database
-----------------------------------------------------

Version: 0.0 Alpha 1 Release

Feedback and bugs to: knb-software@nceas.ucsb.edu

Contributors: Matt Jones (jones@nceas.ucsb.edu)
              Chris Jones (cjones@lifesci.ucsb.edu)

This is a Metacat Client library that allows access to Metacat, a flexible 
database storage system for XML formatted documents. The client library
provides facilities for inserting, updating, and deleting XML documents
from metacat, as well as querying metacat using the Metacat pathquery 
query syntax.

INSTALLATION
------------
perl Makefile.PL
make
make test
make install

If you want the tests to work, you'll need to edit the metacatUrl, username,
and password parameters in the test script and set them to real values for
a working Metacat database.

USAGE
-----
Use "perldoc Metacat" after installation for detailed documentation.

Details of the Metacat architecture can be found on the website for 
the Knowledge Network for Biocomplexity (KNB):

  http://knb.ecoinformatics.org/software/metacat.html

Contributions to this work are welcome.  Please see the above web site
for details on how to contribute.

This software is copyrighted by The Regents of the University of California
and the National Center for Ecological Analysis and Synthesis
and licensed under the GNU GPL; see the 'LICENSE' file for
details.

This material is based upon work supported by the 
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
Any opinions, findings and conclusions or recomendations expressed in this
material are those of the author(s) and do not necessarily reflect 
the views of the National Science Foundation (NSF).
