Move material from bibframe/README to manual

diff --git a/bibframe/README b/bibframe/README
deleted file mode 100644 (file)
index d78fa6a..0000000
--- a/bibframe/README
+++ /dev/null
@@ -1,72 +0,0 @@
-BIBFRAME demo
-
-This directory includes files for using the XQuery module to convert
-MARCXML to BIBFRAME records within Metaproxy.
-
-In order for this to work, metaproxy and the mp-xquery software modules
-must be installed. The conversion uses the marc2bibframe software available
-from here: https://github.com/lcnetdev/marc2bibframe
-
-Installation
-------------
-
-Before these files can used, Metaproxy and the XQuery module must be
-installed.
-
-Metaproxy and XQuery package depend on other packages: libmetaproxy6,
-libyaz5, zorba, etc.
-
-These packages can be auto-fetched by adding the Index Data YUM repository.
-Refer to http://ftp.indexdata.dk/pub/yaz/redhat/centos/6/README
-for more information.
-
-When this repository is enabled, the following command should suffice:
-  sudo yum install mp-xquery metaproxy
-
-
-config.xml
-----------
-
-config.xml is a complete Metaproxy configuration file. It includes
-a standalone configuration that makes Metaproxy offer Z39.50 and SRU support
-on port 9070. The modules in use are http_file (to serve XSL files),
-sru_z3950 (SRU service), cql_rpn (CQL to RPN conversion), xquery (to convert
-MARCXML to BIBFRAME), record_transform (to convert MARC21 to MARCXML), virt_db
-(for database rewrite), log (to perform backend logging) and, finally,
-z3950_client to interface a Z39.50 target.
-
-It is important that the "xquery" module comes before the "record_transform"
-so that the "xquery" moduel sees XML _only_ and not ISO2709-records. If it
-does, they will be ignored (passed through) by the "xquery" module.
-
-The xquery'module script name points to the full path of zorba3-0.xqy part
-of marc2bibframe . Do not move zorba3-0.xqy from its place within the
-marc2bibframe directory as other files are referred to and their relative
-location must be preserved.
-
-cql2pqf.txt
------------
-Contains a simple DC/CQL profile for driving a CQL to RPN conversion.
-It is referred to from the cql_rpn filter in config.xml .
-
-explain.xml
------------
-
-SRU explain sample configuration. It is referred to from the sru_z3950
-filter in config.xml .
-
-xsl/..
-------
-
-Client side XSL for brief - and full display. These must be located
-so that the http_file filter can fetch them. For example, if these
-files are located in /usr/share/bibframe/xsl , then http_file would hold
-
-      <filter type="http_file">
-        <area>
-          <documentroot>/usr/share/bibframe/xsl</documentroot>
-          <prefix></prefix>
-          <passthru>true</passthru>
-        </area>
-      </filter>
-

diff --git a/doc/book.xml b/doc/book.xml
index c6e8f08..9dd568c 100644 (file)
--- a/doc/book.xml
+++ b/doc/book.xml
@@ -151,6 +151,80 @@
     </para>
    </note>
   </sect1>
+  <sect1>
+   <title>BIBFRAME</title>
+   <para>
+    The MARC to BIBFRAME was the primary purpose of the XQuery
+    module for Metaproxy, but generally the module is a just an alternative
+    to record_transform filter of Metaproxy which primarily performs XSLT.
+   </para>
+   <para>
+    The <filename>bibframe directory</filename> of the source tar
+    contains sample file for performing MARC to BIBFRAME conversions.
+    Upon <literal>make install</literal> these are installed to directory
+    <filename>/usr/share/mp-xquery/bibframe</filename> and they are also
+    part of the package <literal>mp-xquery</literal>.
+   </para>
+   <para>
+    <literal>config.xml</literal> is a complete Metaproxy configuration file.
+    It includes a standalone configuration that makes Metaproxy offe
+    Z39.50 and SRU support on port 9070. The modules in use are http_file
+    (to serve XSL files), sru_z3950 (SRU service), cql_rpn (CQL to RPN
+    conversion), xquery (to convert MARCXML to BIBFRAME), record_transform
+    (to convert MARC21 to MARCXML), virt_db (for database rewrite), log
+    (to perform backend logging) and, finally, z3950_client to interface
+    a Z39.50 target.
+   </para>
+   <para>
+    It is important that the XQuery module comes before the
+    "record_transform" so that the XQuery module sees XML
+    <emphasis>only</emphasis> and not ISO2709-records.
+    If it does, they will be ignored (passed through) by the XQuery module.
+   </para>
+   <para>
+    The XQuery module script name points to the full path of
+    <filename>zorba3-0.xqy</filename> part
+    of marc2bibframe . Do not move <filename>zorba3-0.xqy</filename>
+    from its place within the
+    marc2bibframe directory as other files are referred to and their relative
+    location must be preserved.
+   </para>
+   <para>
+    File <filename>cql2pqf.txt</filename> contains a simple DC/CQL profile
+    for driving a CQL to RPN conversion.
+    It is referred to from the cql_rpn filter in config.xml .
+   </para>
+   <para>
+    File <filename>explain.xml</filename> is SRU explain configuration.
+    It is referred to from the sru_z3950 filter in config.xml .
+   </para>
+   <para>
+    Directory <filename>xsl/..</filename> is client side XSL for brief -
+    and full display. These must be located so that the http_file filter
+    can fetch them. For example, if these files are located in
+    <filename>/usr/share/mp-xquery/bibframe/xsl</filename> , then
+    http_file would hold
+    <screen><![CDATA[
+      <filter type="http_file">
+        <area>
+          <documentroot>/usr/share/mp-xquery/bibframe/xsl</documentroot>
+          <prefix></prefix>
+          <passthru>true</passthru>
+        </area>
+      </filter>
+]]>
+    </screen>
+   </para>
+   <note>
+    <para>
+     Do not modify the files below <filename>/usr/share/mp-xquery</filename>.
+     They will be  overwritten by a package update and if
+     <literal>make install</literal> is executed.
+     Use them if they can be used as-is but copy them away if you want to
+     modify them (such as <filename>config.xml</filename>).
+    </para>
+   </note>
+  </sect1>
  </chapter>
  <reference id="reference">
   <title>Reference</title>