bd19ead875f94976a72bca0c2ff98c2932ffe1f5
[yaz-moved-to-github.git] / doc / yaz-man.xml
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" 
2     "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" [
3 <!ENTITY % common SYSTEM "common/common.ent">
4 <!-- $Id: yaz-man.xml,v 1.6 2006-04-24 12:41:00 marc Exp $ --><!-- Index Data software --><!ENTITY url.indexdata "http://www.indexdata.com/">
5 <!ENTITY url.yaz "http://www.indexdata.com/yaz/">
6 <!ENTITY url.yaz.download "http://ftp.indexdata.com/pub/yaz/">
7 <!ENTITY url.yaz.download.win32 "http://ftp.indexdata.com/pub/yaz/win32/">
8 <!ENTITY url.yaz.mailinglist "http://lists.indexdata.dk/cgi-bin/mailman/listinfo/yazlist">
9 <!ENTITY url.yaz.mail "mailto:yaz-help@indexdata.dk">
10 <!ENTITY url.yazplusplus "http://www.indexdata.com/yazplusplus/">
11 <!ENTITY url.yazproxy "http://www.indexdata.com/yazproxy/">
12 <!ENTITY url.idzebra "http://www.indexdata.com/zebra/">
13 <!ENTITY url.idzebra.mailinglist "http://lists.indexdata.dk/cgi-bin/mailman/listinfo/zebralist">
14 <!ENTITY url.metaproxy "http://www.indexdata.com/metaproxy/">
15 <!-- Specifications and Standards --><!ENTITY url.w3c "http://www.w3.org/">
16 <!ENTITY url.xml "http://www.w3.org/XML/">
17 <!ENTITY url.sru "http://www.loc.gov/standards/sru/">
18 <!ENTITY url.sru.diagnostics "http://www.loc.gov/standards/sru/diagnostics.html">
19 <!ENTITY url.sru.diagnostics.list "http://www.loc.gov/standards/sru/diagnostics-list.html">
20 <!ENTITY url.srw "http://www.loc.gov/standards/sru/srw/">
21 <!ENTITY url.soap "http://www.w3.org/TR/soap/">
22 <!ENTITY url.z39.50 "http://www.loc.gov/z3950/agency/">
23 <!ENTITY url.z39.50.doc "http://www.loc.gov/z3950/agency/markup/toc.html">
24 <!ENTITY url.z39.50.asn.1 "http://www.loc.gov/z3950/agency/asn1.html">
25 <!ENTITY url.z39.50.diagnostics "http://www.loc.gov/z3950/agency/defns/bib1diag.html">
26 <!ENTITY url.z39.50.attset.bib1 "http://www.loc.gov/z3950/agency/defns/bib1.html">
27 <!ENTITY url.z39.50.charneg "http://www.loc.gov/z3950/agency/defns/charneg-3.html">
28 <!ENTITY url.z39.50.proximity "http://www.loc.gov/z3950/agency/markup/09.html#3.7.2">
29 <!ENTITY url.z39.50.proximity.asn1 "http://www.loc.gov/z3950/agency/asn1.html#ProximityOperator">
30 <!ENTITY url.z39.50.oids "http://www.loc.gov/z3950/agency/defns/oids.html">
31 <!ENTITY url.asn.1.tutorial "http://asn1.elibel.tm.fr/en/introduction/">
32 <!ENTITY url.asn.1.standards "http://asn1.elibel.tm.fr/en/standards/">
33 <!ENTITY url.cql "http://www.loc.gov/standards/sru/cql/">
34 <!ENTITY url.cql.intro "http://zing.z3950.org/cql/intro.html">
35 <!ENTITY url.xcql "http://www.loc.gov/standards/sru/xml-files/srw-types.xsd">
36 <!ENTITY url.zoom "http://zoom.z3950.org/">
37 <!ENTITY url.marc21 "http://www.loc.gov/marc/">
38 <!ENTITY url.marc8 "http://www.loc.gov/marc/specifications/speccharmarc8.html">
39 <!ENTITY url.marcxml "http://www.loc.gov/standards/marcxml/">
40 <!ENTITY url.ill "http://www.nlc-bnc.ca/iso/ill/">
41 <!ENTITY url.ber.over.tcpip "http://www.faqs.org/rfcs/rfc1729.html">
42 <!ENTITY url.http "http://www.w3.org/Protocols/">
43 <!ENTITY url.http.1.1 "http://www.w3.org/Protocols/rfc2616/rfc2616.html">
44 <!-- External libraries + tools --><!ENTITY url.apache "http://httpd.apache.org/">
45 <!ENTITY url.apache.directive.proxypass "http://httpd.apache.org/docs/mod/mod_proxy.html#proxypass">
46 <!ENTITY url.bison "http://www.gnu.org/software/bison/">
47 <!ENTITY url.libxml2 "http://xmlsoft.org/">
48 <!ENTITY url.libxml2.api "http://www.xmlsoft.org/html/index.html">
49 <!ENTITY url.libxml2.api.tree "http://www.xmlsoft.org/html/libxml-tree.html">
50 <!ENTITY url.libxslt "http://xmlsoft.org/XSLT/">
51 <!ENTITY url.libxml2.download.win32 "http://www.zlatkovic.com/libxml.en.html">
52 <!ENTITY url.autoconf "http://www.gnu.org/software/autoconf/">
53 <!ENTITY url.automake "http://www.gnu.org/software/automake/">
54 <!ENTITY url.libtool "http://www.gnu.org/software/libtool/">
55 <!ENTITY url.libiconv "http://www.gnu.org/software/libiconv/">
56 <!ENTITY url.tcl "http://www.tcl.tk/">
57 <!ENTITY url.perl "http://www.perl.com/">
58 <!ENTITY url.gcc "http://gcc.gnu.org/">
59 <!ENTITY url.vstudio "http://msdn.microsoft.com/vstudio/">
60 <!ENTITY url.boost "http://www.boost.org/">
61 <!ENTITY url.boost.compilers.status "http://www.boost.org/status/compiler_status.html">
62 <!ENTITY url.openssl "http://www.openssl.org/">
63 <!ENTITY url.unxutils "http://unxutils.sourceforge.net/">
64 <!ENTITY url.tcpwrapper "ftp://ftp.porcupine.org/pub/security/index.html">
65 <!-- Operating Systems --><!ENTITY url.linux.kernel "http://www.kernel.org/">
66 <!ENTITY url.debian "http://www.debian.org/">
67 <!ENTITY url.redhat "http://www.redhat.com/">
68 <!ENTITY url.gentoo "http://www.gentoo.org/">
69 <!ENTITY url.freebsd "http://www.freebsd.org/">
70 <!ENTITY url.macosx "http://www.apple.com/macosx/">
71 <!ENTITY url.solaris "http://www.sun.com/software/solaris/">
72 <!ENTITY url.windows2000 "http://www.microsoft.com/windows2000/">
73 <!ENTITY url.windows2003server "http://www.microsoft.com/windowsserver2003/default.mspx">
74 <!ENTITY url.netbsd "http://www.netbsd.org/">
75 <!ENTITY url.openbsd "http://www.openbsd.org/">
76 <!ENTITY url.ubunto "http://www.ubuntu.com/">
77 ]>
78 <!-- $Id: yaz-man.xml,v 1.6 2006-04-24 12:41:00 marc Exp $ -->
79 <refentry id="yaz">
80  <refmeta>
81   <refentrytitle>yaz</refentrytitle>
82   <manvolnum>7</manvolnum>
83  </refmeta>
84  
85  <refnamediv>
86   <refname>YAZ</refname>
87   <refpurpose>Z39.50 toolkit.</refpurpose>
88  </refnamediv>
89  
90  <refsynopsisdiv>
91   <cmdsynopsis>
92    <command>YAZ</command>
93   </cmdsynopsis>
94  </refsynopsisdiv>
95  
96  <refsect1><title>DESCRIPTION</title>
97   <para>
98    YAZ is a C/C++ programmer's toolkit supporting the development
99    of Z39.50v3 clients and servers. The YAZ toolkit offers
100    several different levels of access to the ISO23950/Z39.50, SRW/SRU
101    and ILL protocols. The level that you need to use depends
102    on your requirements, and the role (server of client) that you want
103    to implement.
104   </para>
105  </refsect1>
106
107  <refsect1><title>COPYRIGHT</title>
108   <para>
109    Copyright (c) 1995-2006, Index Data.
110   </para>
111   <para>
112    Permission to use, copy, modify, distribute, and sell this software and
113    its documentation, in whole or in part, for any purpose, is hereby granted,
114    provided that:
115   </para>
116   <para>
117    1. This copyright and permission notice appear in all copies of the
118    software and its documentation. Notices of copyright or attribution
119    which appear at the beginning of any file must remain unchanged.
120   </para>
121   <para>
122    2. The names of Index Data or the individual authors may not be used to
123    endorse or promote products derived from this software without specific
124    prior written permission.
125   </para>
126   
127   <para>
128    THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
129    EXPRESS, IMPLIED, OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
130    WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
131    IN NO EVENT SHALL INDEX DATA BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
132    INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES
133    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR
134    NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
135    LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
136    OF THIS SOFTWARE.
137   </para>
138  </refsect1>
139  
140  <refsect1><title>SEE ALSO</title>
141   <para>
142     <citerefentry>
143      <refentrytitle>yaz-client</refentrytitle>
144      <manvolnum>1</manvolnum>
145     </citerefentry>,
146     <citerefentry>
147      <refentrytitle>yaz-ztest</refentrytitle>
148      <manvolnum>8</manvolnum>
149     </citerefentry>,
150     <citerefentry>
151      <refentrytitle>yaz-config</refentrytitle>
152      <manvolnum>8</manvolnum>
153     </citerefentry>,
154     <citerefentry>
155      <refentrytitle>zoomsh</refentrytitle>
156      <manvolnum>1</manvolnum>
157     </citerefentry>
158   </para>
159   <para>YAZ manual (
160    <filename><replaceable>prefix</replaceable>/share/doc/yaz</filename>)
161   </para>
162   <para>
163    <ulink url="http://www.indexdata.com/yaz/">YAZ home page</ulink>.
164   </para>
165   <para>
166    <ulink url="http://www.loc.gov/z3950/agency/">Z39.50 Maintenance Agency Page</ulink>.
167   </para>
168  </refsect1>
169 </refentry>
170 <!-- Keep this Emacs mode comment at the end of the file
171 Local variables:
172 mode: nxml
173 End:
174 -->