From d198a8df0eb138d75b8ca09734bfa0b368b80d43 Mon Sep 17 00:00:00 2001
From: Sebastian Hammer <quinn@indexdata.com>
Date: Tue, 10 Apr 2007 15:12:51 +0000
Subject: [PATCH] Work on non-standard servers

---
 doc/book.xml |   35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/doc/book.xml b/doc/book.xml
index 752e359..94f3458 100644
--- a/doc/book.xml
+++ b/doc/book.xml
@@ -9,13 +9,16 @@
      <!ENTITY % common SYSTEM "common/common.ent">
      %common;
 ]>
-<!-- $Id: book.xml,v 1.9 2007-04-10 08:59:35 adam Exp $ -->
+<!-- $Id: book.xml,v 1.10 2007-04-10 15:12:51 quinn Exp $ -->
 <book id="book">
  <bookinfo>
   <title>Pazpar2 - User's Guide and Reference</title>
   <author>
    <firstname>Sebastian</firstname><surname>Hammer</surname>
   </author>
+  <author>
+   <firstname>Adam</firstname><surname>Dickmeiss</surname>
+  </author>
   <releaseinfo>&version;</releaseinfo>
   <copyright>
    <year>&copyright-year;</year>
@@ -359,6 +362,36 @@
 	can be fetched using the 'record' command.
       </para>
     </section>
+
+    <section id="nonstandard">
+      <title>Connecting to non-standard resources</title>
+      <para>
+        Pazpar2 uses Z39.50 as its switchboard language -- i.e. as far as it
+	is concerned, all resources speak Z39.50. It is, however, equipped
+	to handle a broad range of different server behavior, through
+	configurable query mapping and record normalization. If you develop
+	configuration, stylesheets, etc., for a new type of resources, we
+	encourage you to share your work.
+      </para>
+
+      <para>
+        For a growing number of resources, Z39.50 is all you need. Over the
+	last few years, a number of commercial, full-text resources have
+	implemented Z39.50. These can be used through pazpar2 with little or
+	no effort. Resources that use non-standard record formats will
+	require a bit of XSLT work, but that's all.
+      </para>
+
+      <para>
+        But what about resources that don't support Z39.50 at all? The NISO
+	SRU protocol is slowly gathering steam. Other resources might
+	support OpenSearch, private, XML/HTTP-based protocols, or something
+	else entirely. Some databases exist only as web user interfaces and
+	  will require screen-scraping. Still others exist only as static
+	  files, or perhaps as databases supporting the OAI-PMH protocol.
+	  There is hope! Read on.
+      </para>
+    </section>
   </chapter> <!-- Using pazpar2 -->
 
  <reference id="reference">
-- 
1.7.10.4