Do not include IDMETA in distribution.
[simpleserver-moved-to-github.git] / README
1 Net::Z3950::SimpleServer - Simple Perl API for building Z39.50 servers.
2
3 The SimpleServer module is a tool for constructing Z39.50 "Information
4 Retrieval" servers in Perl. The module is easy to use, but it does
5 help to have an understanding of the Z39.50 query structure and the
6 construction of structured retrieval records.
7
8 Z39.50 is a network protocol for searching remote databases and
9 retrieving the results in the form of structured "records". It is
10 widely used in libraries around the world, as well as in the US
11 Federal Government. In addition, it is generally useful whenever you
12 wish to integrate a number of different database systems around a
13 shared, asbtract data model.
14
15 The model of the module is simple: It implements a "generic" Z39.50
16 server, which invokes callback functions supplied by you to search for
17 content in your database. You can use any tools available in Perl to
18 supply the content, including modules like DBI and WWW::Search.
19
20 The server will take care of managing the network connections for you,
21 and it will spawn a new process (or thread, in some environments)
22 whenever a new connection is received.
23
24 AUTHORS
25         Anders Sønderberg <sondberg@indexdata.dk>
26         Sebastian Hammer <quinn@indexdata.dk>
27         Mike Taylor <mike@indexdata.com>
28
29 COPYRIGHT AND LICENCE
30
31 Copyright (C) 2000-2009 by Index Data.
32
33 This library is free software; you can redistribute it and/or modify
34 it under the same terms as Perl itself, either Perl version 5.8.4 or,
35 at your option, any later version of Perl 5 you may have available.
36
37 CONVERSION FROM CVS
38
39 This module was originally maintained under CVS, and was converted to
40 git as follows:
41
42 $ cd /usr/local/src/git/git-tools/id-cvs-to-git/
43 $ CVSROOT=:ext:mike@bagel.indexdata.com:/home/cvsroot ./id-cvs-to-git.sh CVS simpleserver "Simple Perl API for building Z39.50 servers."