document `make newdb'
[irspy-moved-to-github.git] / README
diff --git a/README b/README
index 6bb120b..24c577b 100644 (file)
--- a/README
+++ b/README
@@ -1,7 +1,6 @@
-$Id: README,v 1.1 2006-04-13 14:53:17 mike Exp $
 
-Net-Z3950-IRSpy
-===============
+ZOOM::IRSpy
+===========
 
 This module exists to implement the IRspy program, which discovers,
 analyses and monitors IR servers implementing the Z39.50 and SRU/W
@@ -9,6 +8,37 @@ protocols.  It is a successor to the ZSpy program.
 
 INSTALLATION
 
+for debian/ubuntu:
+-------------------
+
+DEBIAN DEPENDENCIES
+
+If you have a Debian-based operating system, you can get what you need
+by installing the following packages from the operating system's
+package store, using apt-get:
+
+sudo apt-get install \
+       libnet-z3950-zoom-perl \
+       libxml-libxml-common-perl \
+       liburi-perl \
+       libxml-libxml-perl \
+       libapache2-mod-perl2 \
+       libhtml-mason-perl \
+       libapache2-request-perl \
+       libapache2-mod-apreq2 \
+       libxml-libxslt-perl \
+       idzebra-2.0 \
+
+you may need one of the following packages for development:
+
+sudo apt-get install \
+       make perl-doc libxml2-utils
+
+and may enable mod_apreq
+
+sudo a2enmod apreq
+
+
 To install this module type the following:
 
    perl Makefile.PL
@@ -21,14 +51,22 @@ DEPENDENCIES
 This module requires these other modules and libraries, in addition to
 those specified in Makefile.PL:
 
-  Zebra, release 1.4.0 or later: see http://indexdata.com/zebra/
+  Zebra, release 2.0 or later: see http://www.indexdata.com/zebra/
 
 COPYRIGHT AND LICENCE
 
-Copyright (C) 2006 by Index Data ApS.
+Copyright (C) 2006-2010 by Index Data ApS.
 
 This library is free software; you can redistribute it and/or modify
 it under the same terms as Perl itself, either Perl version 5.8.7 or,
 at your option, any later version of Perl 5 you may have available.
 
+--
+
+Notes to self: everyone else please ignore these
+
+$ cd /usr/local/src/cvs/irspy && YAZ_LOG=irspy,irspy_test,irspy_debug,pod perl -I lib bin/irspy.pl -t "bagel.indexdata.dk/gils foo.bar.baz:12345/fish z3950.loc.gov:7090/Voyager" localhost:8018/IR-Explain---1
+
+To get a list of all Danish domains in the database:
+.../ZOOM-Perl/samples/zoom/zselect -t q localhost:8018/IR-Explain---1 'net.host = *.dk' //zeerex:host