From: Adam Dickmeiss Date: Thu, 25 Apr 1996 10:21:53 +0000 (+0000) Subject: Makefile enhanced. Changed doc a bit. X-Git-Url: http://sru.miketaylor.org.uk/cgi-bin?a=commitdiff_plain;h=31c11342a54c8bf4eb004199d23a173343dfcecc;p=egate.git Makefile enhanced. Changed doc a bit. --- diff --git a/doc/Makefile b/doc/Makefile index 19aa500..d2f5cf2 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,17 +1,17 @@ -# $Id: Makefile,v 1.2 1996/01/18 16:07:57 adam Exp $ +# $Id: Makefile,v 1.3 1996/04/25 10:21:53 adam Exp $ all: egate.ps egate.txt egate.html egate.txt: egate.sgml sgml2txt egate.sgml egate.dvi: egate.sgml - sgml2ps -d zebra.sgml + sgml2ps -d egate.sgml egate.ps: egate.sgml - sgml2ps zebra.sgml + sgml2ps egate.sgml egate.html: egate.sgml - sgml2html zebra.sgml + sgml2html egate.sgml clean: rm -f [0-9]* *.bak diff --git a/doc/egate.sgml b/doc/egate.sgml index 7eac1a5..72963b6 100644 --- a/doc/egate.sgml +++ b/doc/egate.sgml @@ -1,13 +1,13 @@
Email/Z39.50 gateway guide <author>Europagate, 1995 -<date>$Revision: 1.8 $ +<date>$Revision: 1.9 $ <abstract> This document describes a Email server that provides access to the Z39.50 protocol. @@ -34,13 +34,13 @@ The ES can use either CNIDR's Zdist package or the YAZ package from Index Data to interface the Z39.50 protocol. So you need to obtain one of these first. -The Zdist package can be found in: +The zdist package can be found in: <htmlurl url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z" name="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z"> -The Zdist package doesn't support result-set references. Also, it has a few +The zdist package doesn't support result-set references. Also, it has a few bugs. Therefore we've included a patch <tt/zdist.patch/ which fixes some of these bugs. Run patch in the directory above <tt/zdist102b1-1/: @@ -49,12 +49,12 @@ $ patch <zdist.patch </verb></tscreen> The ES server only depends on <tt>libz3950.a</tt> so you only need -to build the Zdist software in the directory <tt/libz3950/. +to build the zdist software in the directory <tt/libz3950/. YAZ can be found at the FTP host: -<htmlurl url="ftp://130.225.252.168/index/yaz" - name="ftp://130.225.252.168/index/yaz"> +<htmlurl url="ftp://ftp.indexdata.dk/index/yaz" + name="ftp://ftp.indexdata.dk/index/yaz"> The ES also use GNU's regex package to parse regular expressions. The ES has been tested with regex-0.12. Some systems, such as Linux, @@ -62,25 +62,26 @@ come with the regex package preinstalled. Unpack <tt>egate.tar.gz</tt> and edit the top level <tt/Makefile/. Specify where the GNU regex package is located and specify whether you use -YAZ or Zdist. One some systems, you may have to set the <tt/NETLIB/ as +YAZ or zdist. One some systems, you may have to set the <tt/NETLIB/ as well. The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the <tt/Makefile/ so you may modify these before compiling. -Now, type <tt/make/. +Now, type <tt/make email/. <sect>Installation <p> -If the compilation succeeds, you should install the software. -Edit the <tt/Makefile/ and set the LIBDIR to the installation +If the compilation succeeds, you should install the software in some +system location. +Edit the <tt/Makefile/ and set EMAILLIBDIR to the installation directory. Since, the ES is executed by the mail system, and not by a user, this directory shouldn't be globally executable. -When satisfied, type <tt/make install/. +When satisfied, type <tt/make install.email/. -Three executables are installed in LIBDIR: +Three executables are installed in EMAILLIBDIR: <descrip> <tag/eti/ The email transport interface. This program receives incoming mail, identifies the user, and delivers the mail request @@ -99,7 +100,7 @@ The <tt/sendmail/ or a similar program delivers the mail to the you create a special user and group for the ES software. In this case you should use <tt/chmod/ to and set the 'set user ID on execution' bits on the executable files and give that user read/write/execute -permissions in LIBDIR. +permissions in EMAILLIBDIR. The mail system needs to know about the ES. Pick some name that serves as the ES user and edit <tt/aliases/ used by your mail system (usually @@ -107,7 +108,7 @@ as the ES user and edit <tt/aliases/ used by your mail system (usually <tt>es:"|/usr/local/lib/es/eti </tt><em>options</em><tt>"</tt> -In this example the mail user name is <tt/es/ and the LIBDIR is +In this example the mail user name is <tt/es/ and the EMAILLIBDIR is <tt>/usr/local/lib/es</tt>. The ES system can operate with or without the monitor. When using