X-Git-Url: http://lists.indexdata.com/cgi-bin?a=blobdiff_plain;f=doc%2Fbook.xml;h=7a67a114ecc0c3f9073c34230db4e2a8f5ca9246;hb=4b4784cf0c2958bc4a4172d2ff8935b6b3c6e5d3;hp=5ca2e6260a761d6897c3c43df546acf35b62f1b3;hpb=dac0c39ac77d0ed84af695020fa49dde6dd2940b;p=metaproxy-moved-to-github.git diff --git a/doc/book.xml b/doc/book.xml index 5ca2e62..7a67a11 100644 --- a/doc/book.xml +++ b/doc/book.xml @@ -1,4 +1,4 @@ - + Metaproxy - User's Guide and Reference @@ -74,7 +74,7 @@ Anything goes in! Anything goes out! - Cold bananas, fish, pyjamas, + Fish, bananas, cold pyjamas, Mutton, beef and trout! - attributed to Cole Porter. @@ -128,7 +128,7 @@ Installation - Metaproxy depends on the folloing tools/libraries: + Metaproxy depends on the following tools/libraries: YAZ++ @@ -141,14 +141,16 @@ This is an XSLT processor - based on Libxml2. Both Libxml2 and - Libxslt must be installed with the development components. + Libxslt must be installed with the development components + (header files, etc.) as well as the run-time libraries. Boost - The popular C++ library. + The popular C++ library. Initial versions of Metaproxy + was built with 1.33.0. Version 1.33.1 works too. @@ -248,9 +250,92 @@
Installation on Windows - ### To be written + Compilation of Metaproxy can be done using + Microsoft Visual Studio. + We know Version 2003 works. We expect Version 2005 should to + work as well. +
+ Boost + + Get Boost from its home page. + You also need Boost Jam (an alternative to make). + That's also available from this + home page. The files download are called something like: + boost_1_33-1.exe + and + boost-jam-3.1.12-1-ntx86.zip. + Unpack Boost Jam first. Put bjam.exe + in your system path. Make a command prompt and ensure + it can be found automatically. If not check the PATH. + The Boost .exe is a self-extracting exe with + complete source for Boost. Compile that source with + Boost Jam (An alternative to Make). + The compilation takes a while. + By default, the Boost build process puts the resulting + libraries + header files in + \boost\lib, \boost\include. + + + For more informatation about installing Boost refer to the + getting started + pages. + +
+ +
+ Libxslt + + Libxslt can be downloaded + for Windows from + here. + + + Libxslt has other dependencies, but thes can all be downloaded + from the same site. Get the following: + iconv, zlib, libxml2, libxslt. + +
+ +
+ YAZ + + YAZ can be downloaded + for Windows from + here. + +
+ +
+ YAZ++ + + Get YAZ++ as well. + Version 1.0 or later is required. For now get it from + Index Data's + Snapshot area. + + + YAZ++ includes NMAKE makefiles, similar to those found in the + YAZ package. +
+ +
+ Metaproxy + + Metaproxy is shipped with NMAKE makfiles as well - similar + to those found in the YAZ++/YAZ packages. Adjust this Makefile + to point to the proper locations of Boost, Libxslt, Libxml2, + zlib, iconv, yaz and yazpp. + + + After succesful compilation you'll find + metaproxy.exe in the + bin directory. + +
+ +
@@ -822,6 +907,11 @@ Hold on tight - this may get a little hairy. + + + +
+ Virtual databases with the <literal>virt_db</literal> filter In the general course of things, a Z39.50 Init request may carry with it an otherInfo packet of type VAL_PROXY, @@ -891,6 +981,33 @@ through it.
+ +
+ A picture is worth a thousand words (but only five hundred on 64-bit architectures) + + + + + + + + + + + + Diagram showing the progress of packages through the filters + during a simple virtual-database search and a multi-database + search. + + + + + +