<!doctype linuxdoc system>
<!--
- $Id: ir-tcl.sgml,v 1.30 1999-03-22 06:48:58 adam Exp $
+ $Id: ir-tcl.sgml,v 1.31 1999-12-10 10:36:13 adam Exp $
-->
<article>
<title>IrTcl User's Guide and Reference
<author><htmlurl url="http://www.indexdata.dk/" name="Index Data">,
<tt><htmlurl url="mailto:info@indexdata.dk" name="info@indexdata.dk"></tt>
-<date>$Revision: 1.30 $
+<date>$Revision: 1.31 $
<abstract>
This document describes IrTcl -- an information retrieval toolkit for
Tcl and Tk that provides access to the Z39.50/SR protocol.
needed unless you wish to communicate within an OSI environment.
See [ref 2] for more information about the XTI/mOSI implementation.
-<sf/IrTcl/ is usually build as a <it/dynamic/ library (Windows)
+<sf/IrTcl/ is usually build as a <it/dynamic/ library (WIN32)
or shared Object (Unix) which is dynamically loaded by using the Tcl's
<tt/load/ command. However, <sf/IrTcl/ can be compiled as a
traditional <it/static/ library as well.
<sect>Compilation and installation
<p>
-In order to compile you need:
+<sect1>UNIX
+<p>
+In order to compile the software on UNIX you need:
<itemize>
<item> An ANSI C compiler such as GNU C.
<item> <htmlurl url="http://www.scriptics.com" name="Tcl">.
- Version 7.5, 7.6 and 8.0 has been tested.
+ Version 8.0 and 8.2 has been tested.
<item> <htmlurl url="http://www.indexdata.dk/yaz/" name="YAZ">
version 1.5 or higher.
</itemize>
As an option you may want:
<itemize>
<item> <htmlurl url="http://www.scriptics.com" name="Tk">.
-Version 4.1, 4.2 and 8.0 has been tested.
+Version 8.0 and 8.2 has been tested.
<item> XTI/mOSI
</itemize>
The <tt>configure</tt> command tries to locate the file <tt/tclConfig.sh/
which should be generated by Tcl's installation script. Configure
-looks for your Tcl shell in order to locate this file. For example
-if <tt/tclsh/ is located in <tt>/home/joe/bin</tt>, configure will
+looks for ther Tcl shell on your system in order to locate this file.
+For example if <tt/tclsh/ is located in <tt>/home/joe/bin</tt>, configure will
assume that <tt>tclConfig.sh</tt> is installed in <tt>/home/joe/lib</tt>,
in which case the prefix is <tt>/home/joe</tt>. If you have
more than one Tcl version installed on your system, or if configure
-cannot find the Tcl shell in your path, you can specify the prefix
-by adding <tt>--prefix=</tt>prefix to the configure command, i.e.
+cannot find the <tt/tclConfig.sh/, you can specify in which directory
+it is, by supplying option <tt>--with-tclconfig</tt> - for example:
<tscreen><verb>
-$ ./configure --prefix=/home/joe
+$ ./configure --with-tclconfig=/home/joe/lib
</verb></tscreen>
-The prefix is also used to determine where <sf/IrTcl/ is installed.
The <sf/IrTcl/ executables are installed in prefix/bin and libraries
and support files are installed in prefix/irtcl.
in <tt>IRTCLDIR</tt> -- defaults to <tt>/usr/local/lib/irtcl</tt>.
</descrip>
-<sect1>Using Tcl
-
<p>
Basic Tcl is handled by the program <tt/tclsh/. The script
must use the <tt/load/ command to load the <sf/IrTcl/ dynamic
%
</verb></tscreen>
+<sect1>WIN32
+<p>
+
+<sf/IrTcl/ is shipped with a "makefile" for the NMAKE tool that comes
+with Visual C++.
+
+Start an MS-DOS prompt and switch the sub directory <tt>WIN</tt> where
+the file <tt>makefile</tt> is located. Customize the installation
+by editing the <tt>makefile</tt> file (for example by using wordpad).
+
+The following summarises the most important settings in that
+file.
+
+<descrip>
+<tag><tt>YAZDIR</tt></tag> Specifies where YAZ is located.
+<tag><tt>DEBUG</tt></tag> If set to 1, the software is
+compiled with debugging libraries. If set to 0, the software
+is compiled with release (non-debugging) libraries.
+</descrip>
+
+When satisfied with the settings in the makefile type
+<tscreen><verb>
+nmake
+</verb></tscreen>
+
+If compilation was successful the executables <tt>irtcl.dll</tt>
+is put in directory <tt>BIN</tt>.
+
+To start the test client that comes with <sf/IrTcl/ make sure
+both <tt/YAZ.DLL/ and <tt/IRTCL.DLL/ are in current directory
+or in your PATH. Go to the top-level directory of <sf/IrTcl/
+and type "wish -f client.tcl". You might want to make a
+short-cut to start this.
+
<sect1>Using Tk
<p>
<sect>License
<p>
-Copyright © 1995-1998, Index Data.
+Copyright © 1995-1999, Index Data.
Permission to use, copy, modify, distribute, and sell this software and
its documentation, in whole or in part, for any purpose, is hereby granted,
projects / ir-tcl-moved-to-github.git / blobdiff