X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Fintroduction.xml;h=f531c749cab6f4dbce4a087b8602d4254f52b3fa;hp=4ddb58ffd1def73697c49289c58abd2c0dd441f8;hb=bd7e251dac1b07c54884d26295f66b90cfb23131;hpb=ab0fd2f75e554d1c9c0e722abf073f9840f7739b diff --git a/doc/introduction.xml b/doc/introduction.xml index 4ddb58f..f531c74 100644 --- a/doc/introduction.xml +++ b/doc/introduction.xml @@ -1,4 +1,4 @@ - + Introduction @@ -13,18 +13,19 @@ It is, by far, the easiest way to develop clients in C. Server implementers should consider the generic frontend server. - None of those high-level API's support the whole protocol, but - they support most facilities used in existing Z39.50 + None of those high-level APIs support the whole protocol, but + they do include most facilities used in existing Z39.50 applications. - If you're developing non-standard extensions to Z39.50 or you're + If you're using 'exotic' functionality (meaning anything not included in + the high-level APIs), developing non-standard extensions to Z39.50 or you're going to develop an ILL application you'll have to learn the lower - level API's of &yaz;. + level APIs of &yaz;. - The basic low level modules, which is independent of the role, - consists of three primary interfaces: + The basic low level modules, which are independent of the role + (client or server), consist of three primary interfaces: &asn;, which provides a C representation of the Z39.50 @@ -47,7 +48,7 @@ provided by the &odr; (Open Data Representation) subsystem. - &odr; is a basic mechanism for representing an + &odr; is a basic mechanism for representing an ASN.1 type in the C programming language, and for implementing BER encoders and decoders for values of that type. The types defined in the &asn; module generally have the prefix Z_, and @@ -118,7 +119,7 @@ sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:"yaz.xml" - sgml-local-catalogs: "../../docbook/docbook.cat" + sgml-local-catalogs: nil sgml-namecase-general:t End: -->