From 30cfc59b71c25923e2e9cfb63c310c095bb3b6c1 Mon Sep 17 00:00:00 2001 From: Adam Dickmeiss Date: Thu, 2 Dec 1999 13:54:56 +0000 Subject: [PATCH] Updated information about YAZ. --- CHANGELOG | 17 +++++++++++++++++ README | 27 ++++++++++++--------------- windows.txt | 14 +++++++------- 3 files changed, 36 insertions(+), 22 deletions(-) diff --git a/CHANGELOG b/CHANGELOG index 71b7951..fd9deb2 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,5 +1,22 @@ Possible compatibility problems with earlier versions marked with '*'. +On UNIX, the generated makefile now supports a proper 'make install'. +The prefix can be set via GNU configure to set the install location +(default is /usr/local). + +* YAZ programs client and ztest were renamed to yaz-client and +yaz-ztest to avoid conflicts when users install YAZ in "standard" +locations, such as /usr/bin,/usr/local/bin,etc. + +* YAZ Header files were moved from include to include/yaz. YAZ Header +files are referred to as include rather than . +The YAZ include path (-I ..) is therefore the same as before. Programmers +should update their #include statements or use -Ipath/include/yaz +instead. The main motivation for doing this change is that YAZ header files +can be installed in "standard" locations /usr/include,/usr/local/include +without introducing conflicts, since ALL YAZ header files are stored +in subdirectory yaz (under /usr/include for example). + Compilation of YAZ for WIN32 is now handled by an nmake-style makefile rather than project/workspace files. We switched because project files are incompatible between Visual C++ 5 and 6. Refer to windows.txt for diff --git a/README b/README index 4b7b088..a400589 100644 --- a/README +++ b/README @@ -1,10 +1,9 @@ - * Copyright (C) 1995-1999, Index Data ApS. - * See the file LICENSE for details. - * Sebastian Hammer, Adam Dickmeiss +Copyright (C) 1995-1999, Index Data ApS. +See the file LICENSE for details. -Compilation and installation for YAZ - $Id: README,v 1.27 1999-08-27 09:40:31 adam Exp $ +Compilation and installation instructions for YAZ + $Id: README,v 1.28 1999-12-02 13:54:56 adam Exp $ The primary output of the source here is the lib/libyaz.a library, which contains support functions for implementing the server or client @@ -17,18 +16,18 @@ On Unix, GNU configure is used to configure YAZ and generate Makefiles. Type "./configure", then "make" to build YAZ. Two test-programs of interest are generated when you type 'make' at the -top level: ztest/ztest and client/client. Ztest is a dummy database -server which returns canned responses to all queries. It's good for -verifying that the protocol works ok, and ztest.c shows an +top level: ztest/yaz-ztest and client/yaz-client. Ztest is a dummy +database server which returns canned responses to all queries. It's good +for verifying that the protocol works ok, and ztest.c shows an implementation of a 'backend' interface. -Client is a linemode Z39.50 client. It supports a fair amount of the +yaz-client is a linemode Z39.50 client. It supports a fair amount of the functionality of Z39.50v2/SR, but some things you need to enable or disable by recompilation. Its primary purpose is to excersise the package, and verify that the protocol works OK. It can be started by typing - client tcp::[/] + yaz-client tcp::[/] at the UNIX prompt, to connect to a Z39.50 server. @@ -80,7 +79,7 @@ The directories: doc - Documentation. util - Various little utility functions. Logging, memory debugging, - primitive ISO 2709 presentation for the client, etc. You'll + primitive ISO 2709 presentation for the yaz-client, etc. You'll find the ASN.1 Compiler for YAZ here as well (yc.tcl). odr - Open Data Representation. This module implements the BER @@ -128,10 +127,8 @@ ztest - A demonstration server that implements a backend. include - The various header files. -makelib - This is a simple utility that gathers the libraries from the - previous modules into libyaz.a. - -lib - The libraries. Primarily libyaz.a. +lib - The libraries. Primarily libyaz.a. The makefile gathers the + libraries from previous modules into libyaz.a. To get more information or assistance, send mail to yaz-help@indexdata.dk. diff --git a/windows.txt b/windows.txt index 751384a..708b4f1 100644 --- a/windows.txt +++ b/windows.txt @@ -1,5 +1,5 @@ YAZ Compilation guidelines for winNT/95. - $Id: windows.txt,v 1.2 1999-08-27 09:40:31 adam Exp $ + $Id: windows.txt,v 1.3 1999-12-02 13:54:56 adam Exp $ This distribution of YAZ includes makefiles that works with Visual C++ version 5 and 6. The makefile is located in sub directory 'win'. @@ -31,13 +31,13 @@ server.lib - The server library, which includes the source from 'server'. Unlike the UNIX version, the server library is multi-threaded. -client.exe - A Z39.50 client console application. It links with the - import library yaz.lib. This application searches for yaz.dll +yaz-client.exe - A Z39.50 client console application. It is linked with + the import library yaz.lib. This application searches for yaz.dll during runtime. -ztest.exe - The Z39.50 test server as a console application. It links - with the import library yaz.lib and the regular library - server.lib. When running ztest make sure it is able to find +yaz-ztest.exe - The Z39.50 test server as a console application. It is + linked with the import library yaz.lib and the regular library + server.lib. When running yaz-ztest make sure it is able to find the record test files dummy-records, dummy-grs, and dummy-words in the current directory. @@ -48,7 +48,7 @@ ztest.exe - The Z39.50 test server as a console application. It links \winnt\system32, it's probably a good idea to use the option '-w' to change to some other directory. For example - ztest -install -w d:\proj\yaz\ztest -l ztest.out tcp:@:210 + yaz-ztest -install -w d:\proj\yaz\ztest -l ztest.out tcp:@:210 which specifies both working directory (d:\proj\yaz\ztest) and a log file (ztest.out). The server is started on port 210. -- 1.7.10.4