Project

General

Profile

1
 #
2
 #  '$RCSfile$'
3
 #  Copyright: 2000 Regents of the University of California 
4
 #
5
 #   '$Author: harris $'
6
 #     '$Date: 2005-09-28 14:06:04 -0700 (Wed, 28 Sep 2005) $'
7
 # '$Revision: 2601 $' 
8
 # 
9
 # This program is free software; you can redistribute it and/or modify
10
 # it under the terms of the GNU General Public License as published by
11
 # the Free Software Foundation; either version 2 of the License, or
12
 # (at your option) any later version.
13
 #
14
 # This program is distributed in the hope that it will be useful,
15
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
16
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17
 # GNU General Public License for more details.
18
 #
19
 # You should have received a copy of the GNU General Public License
20
 # along with this program; if not, write to the Free Software
21
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
22
 #
23

    
24
Metacat.pm -- perl client to the Metacat XML database
25
-----------------------------------------------------
26

    
27
Version: 0.0 Alpha 1 Release
28

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

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

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

    
40
INSTALLATION
41
------------
42
perl Makefile.PL
43
make
44
make test
45
make install
46

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

    
51
USAGE
52
-----
53
Use "perldoc Metacat" after installation for detailed documentation.
54

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

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

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

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

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