-## $Id: Makefile.am,v 1.33 2002-09-16 18:45:13 adam Exp $
+## $Id: Makefile.am,v 1.34 2002-09-17 20:17:44 adam Exp $
docdir=$(datadir)/doc/@PACKAGE@
doc_DATA = $(DOCFILES)
man_MANS = $(MANFILES)
-yaz-client.1: yaz-client.sgml
+yaz-client.1: yaz-client.sgml yaz-client-commands.xml
cd $(srcdir); docbook2man yaz-client.sgml
-yaz-ztest.8: yaz-ztest.sgml
+yaz-ztest.8: yaz-ztest.sgml ztest-options.xml
cd $(srcdir); docbook2man yaz-ztest.sgml
yaz-config.1: yaz-config.sgml
-<!-- $Id: frontend.xml,v 1.14 2002-09-16 14:16:31 adam Exp $ -->
+<!-- $Id: frontend.xml,v 1.15 2002-09-17 20:17:44 adam Exp $ -->
<chapter id="server"><title>Generic server</title>
<sect1><title>Introduction</title>
<sbr/>
<arg choice="opt"><option>-k <replaceable>kilobytes</replaceable></option></arg>
<arg choice="opt"><option>-d <replaceable>daemon</replaceable></option></arg>
- <arg choice="opt"><option>-ziST1</option></arg>
<arg choice="opt"><option>-w <replaceable>dir</replaceable></option></arg>
+ <arg choice="opt"><option>-ziST1</option></arg>
<arg choice="opt" rep="repeat">listener-spec</arg>
</cmdsynopsis>
<para>
For UNIX, the address is the filename of socket.
</para>
-
+
<para>
- Examples
+ For TCP/IP and SSL, the special hostname "@" is mapped to
+ the address <literal>INADDR_ANY</literal>, which causes the
+ server to listen on any local interface.
</para>
-
+
+ <para>
+ Examples:
<screen>
- tcp:dranet.dra.com
+ tcp:@:210
- ssl:ssl.enterprise.com:3000
+ ssl:@:3000
unix:/tmp/yaz
</screen>
-
- <para>
- For TCP/IP and SSL, the special hostname "@" is mapped to
- the address <literal>INADDR_ANY</literal>, which causes the
- server to listen on any local interface.
</para>
</sect1>
-<!-- $Id: future.xml,v 1.6 2001-10-26 20:13:44 adam Exp $ -->
+<!-- $Id: future.xml,v 1.7 2002-09-17 20:17:44 adam Exp $ -->
<chapter id="future"><title>Future Directions</title>
<para>
<para>
&yaz; is a BER toolkit and as such should support all protocols
out there based on that. We'd like to see running ILL applications.
- It shouldn't be that hard. Another thing that would be intersting is
+ It shouldn't be that hard. Another thing that would be interesting is
LDAP. Maybe a generic framework for doing IR using both LDAP and
Z39.50 transparently.
</para>
<para>
- Other than that, YAZ generally moves in the directions which appear to
+ Other than that, &yaz; generally moves in the directions which appear to
make the most people happy (including ourselves, as prime users of the
software). If there's something you'd like to see in here, then drop
us a note and let's see what we can come up with.
-<!-- $Id: installation.xml,v 1.12 2002-08-17 07:55:51 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.13 2002-09-17 20:17:44 adam Exp $ -->
<chapter id="installation"><title>Compilation and Installation</title>
<sect1><title>Introduction</title>
<itemizedlist>
<listitem><para>Apple Macintosh (using the Codewarrior programming
environment and the GUSI socket libraries)</para></listitem>
- <listitem><para>MS Windows 95/98/NT/W2K (Win32)</para></listitem>
+ <listitem><para>MS Windows 95/98/NT/2K/XP (Win32)</para></listitem>
<listitem><para>IBM AS/400</para></listitem>
</itemizedlist></listitem>
</itemizedlist>
TCP wrapper library</ulink>. It allows you to allow/deny
clients depending on IP number. The TCP wrapper library is
often used in Linux/BSD distributions.
+ See
+ <citerefentry>
+ <refentrytitle>hosts_access</refentrytitle>
+ <manvolnum>5</manvolnum>
+ </citerefentry>
+ and
+ <citerefentry>
+ <refentrytitle>tcpd</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>.
</para></listitem>
</varlistentry>
<varlistentry><term><literal>--enable-threads</literal></term>
<screen>
make
</screen>
-
</para>
<para>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!ENTITY yaz-client-commands SYSTEM "yaz-client-commands.xml">
]>
-<!-- $Id: yaz-client.sgml,v 1.1 2002-09-16 14:16:31 adam Exp $ -->
+<!-- $Id: yaz-client.sgml,v 1.2 2002-09-17 20:17:44 adam Exp $ -->
<refentry id="yaz-client">
<refmeta>
</para>
</refsect1>
<refsect1><title>SEE ALSO</title>
- <para>yaz(7)</para>
+ <para>
+ <citerefentry>
+ <refentrytitle>yaz</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </para>
<para>
Section "The YAZ Client" in the YAZ manual.
</para>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
-<!-- $Id: yaz-man.sgml,v 1.2 2002-09-16 18:45:13 adam Exp $ -->
+<!-- $Id: yaz-man.sgml,v 1.3 2002-09-17 20:17:44 adam Exp $ -->
<refentry id="yaz">
<refmeta>
<refentrytitle>yaz</refentrytitle>
</refsect1>
<refsect1><title>SEE ALSO</title>
- <para><command>yaz-client(1)</command>,
- <command>yaz-ztest(8)</command>,
- <command>yaz-config(1)</command>,
- <command>zoomsh(1)</command>
+ <para>
+ <citerefentry>
+ <refentrytitle>yaz-client</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>yaz-ztest</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>yaz-config</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>zoomsh</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
</para>
<para>YAZ manual (
<filename><replaceable>prefix</replaceable>/share/yaz/doc</filename>)
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!ENTITY ztest-options SYSTEM "ztest-options.xml">
]>
-<!-- $Id: yaz-ztest.sgml,v 1.1 2002-09-16 14:16:31 adam Exp $ -->
+<!-- $Id: yaz-ztest.sgml,v 1.2 2002-09-17 20:17:44 adam Exp $ -->
<refentry id="yaz-ztest">
<refmeta>
<arg choice="opt"><option>-t <replaceable>minutes</replaceable></option></arg>
<arg choice="opt"><option>-k <replaceable>kilobytes</replaceable></option></arg>
<arg choice="opt"><option>-d <replaceable>daemon</replaceable></option></arg>
- <arg choice="opt"><option>-ziST1</option></arg>
<arg choice="opt"><option>-w <replaceable>dir</replaceable></option></arg>
+ <arg choice="opt"><option>-ziST1</option></arg>
<arg choice="opt" rep="repeat">listener-spec</arg>
</cmdsynopsis>
<para>
<command>yaz-ztest</command> is a Z39.50 test server.
The server acts as a real Z39.50 server but does not use a database.
- It returns a random hit count and returns a subset of a few build-in
+ It returns a random hit count and returns a subset of a few built-in
records.
</para>
<para>
The <replaceable>listener-spec</replaceable> consists of a transport
mode followed by a colon, followed by a listener address. The
transport mode is either <literal>tcp</literal>, <literal>unix</literal>,
- or <literal>ssl</literal>.
+ or <literal>ssl</literal> (<command>yaz-ztest-ssl</command> only).
</para>
<para>
For TCP and SSL, an address has the form:
</refsect1>
<refsect1><title>SEE ALSO</title>
<para>
- yaz(7)
+ <citerefentry>
+ <refentrytitle>yaz</refentrytitle>
+ <manvolnum>1</manvolnum></citerefentry>
</para>
<para>
Section "Generic server" in the YAZ manual.
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!ENTITY zoomsh-commands SYSTEM "zoomsh-commands.xml">
]>
-<!-- $Id: zoomsh.sgml,v 1.1 2002-09-16 18:45:13 adam Exp $ -->
+<!-- $Id: zoomsh.sgml,v 1.2 2002-09-17 20:17:44 adam Exp $ -->
<refentry id="zoomsh">
<refmeta>
</refsect1>
<refsect1><title>SEE ALSO</title>
- <para>yaz(7), <command>yaz-ztest(8)</command></para>
+ <para>
+ <citerefentry>
+ <refentrytitle>yaz</refentrytitle>
+ <manvolnum>7</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>yaz-ztest</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>,
+ </para>
<para>
Section "Building clients with ZOOM" in the YAZ manual.
</para>
<!--
- $Id: ztest-options.xml,v 1.1 2002-09-16 14:16:31 adam Exp $
+ $Id: ztest-options.xml,v 1.2 2002-09-17 20:17:44 adam Exp $
Options for generic frontend server and yaz-ztest.
Included in both manual and man page for yaz-ztest
-->
<varlistentry><term><literal>-c </literal>
<replaceable>config</replaceable></term>
<listitem><para>A user option that serves as a specifier for some
- sort of configuration, e.g. a filename.
+ sort of configuration, usually a filename.
The argument to this option is transferred to member
<literal>configname</literal>of the
<literal>statserv_options_block</literal>.
Maximum record size/message size, in kilobytes.
</para></listitem>
</varlistentry>
+
+ <varlistentry><term><literal>-d </literal>
+ <replaceable>daemon</replaceable></term>
+ <listitem><para>
+ Set name of daemon to be used in hosts access file.
+ See
+ <citerefentry>
+ <refentrytitle>hosts_access</refentrytitle>
+ <manvolnum>5</manvolnum>
+ </citerefentry>
+ and
+ <citerefentry>
+ <refentrytitle>tcpd</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>.
+ </para></listitem>
+ </varlistentry>
</variablelist>