karoora Thu Jan 11 06:05:42 2001 EDT
Modified files:
/phpdoc/kr/functions yaz.xml
Log:
translation 90
Index: phpdoc/kr/functions/yaz.xml
diff -u phpdoc/kr/functions/yaz.xml:1.1 phpdoc/kr/functions/yaz.xml:1.2
--- phpdoc/kr/functions/yaz.xml:1.1 Tue Jan 9 17:05:48 2001
+++ phpdoc/kr/functions/yaz.xml Thu Jan 11 06:05:42 2001
@@ -1,40 +1,27 @@
- <reference id="ref.yaz">
- <title>YAZ functions</title>
- <titleabbrev>YAZ</titleabbrev>
- <partintro>
- <sect1 id="yaz.intro">
- <title>Introduction</title>
- <para>
- This extension offers a PHP interface to the
- <productname>YAZ</productname> toolkit that implements the Z39.50
- protocol for information retrieval. With this extension you can easily
- implement a Z39.50 origin (client) that searches Z39.50 targets
- (servers) in parallel.
+<reference id="ref.yaz">
+ <title>YAZ functions</title>
+ <titleabbrev>YAZ</titleabbrev>
+ <partintro>
+ <sect1 id="yaz.intro">
+ <title>Introduction</title>
+ <para>
+ 이 익스텐션은 정보검색을 위한 Z39.50 프로토콜을
+사용하는<productname>YAZ</productname>툴킷의 PHP 인터페이스를
+제공한다. 이 익스텐션은 Z39.50 origin(client)에게 쉽게 Z39.50 targets
+(servers)을 병렬 검색할 수 있는 도구를 제공한다.
</para>
- <para>
- <productname>YAZ</productname> is available at <ulink
- url="&url.yaz;">&url.yaz;</ulink>. You can find news information,
- example scripts, etc. for this extension at <ulink
- url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>.
+ <para>
+ <productname>YAZ</productname>는 <ulink
+url="&url.yaz;">&url.yaz;</ulink>서 만나볼 수 있다. 뉴스, 예제
+스크립트, 등등 이 익스텐션은 <ulink
+url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>여기서 구할 수 있다.
</para>
- <para>
- The module hides most of the complexity of Z39.50 so it should be
- fairly easy to use. It supports persistent stateless connections very
- similar to those offered by the various SQL APIs that are available
- for PHP. This means that sessions are stateless but shared amongst
- users, thus saving the connect and initialize phase steps in most cases.
+ <para>
+ 이 모듈은 Z39.50의 복잡성은 대부분 감추어져 있어서 매우
+사용하기 쉽다. 이것은 PHP가 이용할 수 있는 다양한 SQL APIs와
+매우 유사한 persistent stateless connections 을 제공한다. 이것은
+세션들이 stateless 하지만 사용자들에게 분배된다는 것을
+의미한다. 결국. 대부분의 경우 연결은 저장되고 상태의 진행은
+초기화 된다.
</para>
- </sect1>
- <sect1 id="yaz.install">
- <title>Installation</title>
- <para>
- Compile YAZ and install it. Build PHP with your favourite
- modules and add option --with-yaz. Your task is roughly the
- following:
+ </sect1>
+ <sect1 id="yaz.install">
+ <title>설치</title>
+ <para>
+ YAZ를 컴파일 하고 설치를 한다. PHP를 필요한 모듈과 빌드
+할때 --with-yaz 옵션을 추가한다. 작업은 대개 다음과 같다.:
</para>
- <para>
- <informalexample>
- <programlisting>
+ <para>
+ <informalexample>
+ <programlisting>
gunzip -c yaz-1.6.tar.gz|tar xf -
gunzip -c php-4.0.X.tar.gz|tar xf -
cd yaz-1.6
@@ -46,26 +33,24 @@
make
make install
</programlisting>
- </informalexample>
+ </informalexample>
+ </para>
+ </sect1>
+ <sect1 id="yaz.example">
+ <title>Example</title>
+ <para>
+ PHP/YAZ는 targets(Z-Associations)의 연결을 유지한다. positive integer는
+ID of a
+ particular를 나타낸다.
</para>
- </sect1>
- <sect1 id="yaz.example">
- <title>Example</title>
- <para>
- PHP/YAZ keeps track of connections with targets
- (Z-Associations). A positive integer represents the ID of a
- particular association.
- </para>
- <para>
- The script below demonstrates the parallel searching feature of
- the API. When invoked with no arguments it prints a query form; else
- (arguments are supplied) it searches the targets as given in in array
- host.
- </para>
- <para>
- <example>
- <title><function>YAZ</function></title>
- <programlisting role="php">
+ <para>
+ 아래의 예제 스크립트는 API의 parallel searching을 보여준다.
+독립변수 업시 불러낼때 query form을 출력하고 그렇지
+않은경우(독립변수가 주어질때) 주어진 배열에서 targets을
+찾아낸다
+ </para>
+ <para>
+ <example>
+ <title>
+ <function>YAZ</function>
+ </title>
+ <programlisting role="php">
$num_hosts = count ($host);
if (empty($term) || count($host) == 0) {
echo '<form method="get">
@@ -112,342 +97,334 @@
}
}
</programlisting>
- </example>
- </para>
- </sect1>
- </partintro>
-
- <refentry id="function.yaz-addinfo">
- <refnamediv>
- <refname>yaz_addinfo</refname>
- <refpurpose>Returns additional error information</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_addinfo</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns additional error message for target (last request). An
- empty string is returned if last operation was a success or if no
- additional information was provided by the target.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-close">
- <refnamediv>
- <refname>yaz_close</refname>
- <refpurpose>Closes a YAZ connection</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_close</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Closes a connection to a target. The application can no longer
- refer to the target with the given ID.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-connect">
- <refnamediv>
- <refname>yaz_connect</refname>
- <refpurpose>
- Returns a positive association ID on success; zero on failure
+ </example>
+ </para>
+ </sect1>
+ </partintro>
+ <refentry id="function.yaz-addinfo">
+ <refnamediv>
+ <refname>yaz_addinfo</refname>
+ <refpurpose>추가적인 error 정보를
+리턴한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_addinfo</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 부가적인 target (마지막 요청한)에 관한 정보를 리턴한다.
+만일 마지막 작업이 성공적으로 이루어지거나 target이 제공하는
+추가정보가 없는 경우 공백문자(A empty string)를 리턴한다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-close">
+ <refnamediv>
+ <refname>yaz_close</refname>
+ <refpurpose>YAZ의 연결을 닫는다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_close</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ target과의 연결을 닫는다. application은 주어진 ID로 target에
+조회할 수 없다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-connect">
+ <refnamediv>
+ <refname>yaz_connect</refname>
+ <refpurpose>
+ 성공한 경우 양의 association ID를 리턴한다 : 실패의 경우 "0"을
+리턴
</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_connect</function></funcdef>
- <paramdef>string <parameter>zurl</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Yaz_connect</function> prepares for a connection to a
- Z39.50 target. The zurl argument takes the form
- host[:port][/database]. If port is omitted 210 is used. If
- database is omitted Default is used. This function is
- non-blocking and doesn't attempt to establish a socket - it
- merely prepares a connect to be performed later when
- <function>yaz_wait</function> is called.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-errno">
- <refnamediv>
- <refname>yaz_errno</refname>
- <refpurpose>Returns error number</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_errno</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns error for target (last request). A positive value is
- returned if the target returned a diagnostic code; a value of
- zero is returned if no errors occurred (success); negative value
- is returned for other errors targets didn't indicate the error in
- question.
- </para>
- <para>
- <function>Yaz_errno</function> should be called after network
- activity for each target - (after <function>yaz_wait</function>
- returns) to determine the success or failure of the last
- operation (e.g. search).
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-error">
- <refnamediv>
- <refname>yaz_error</refname>
- <refpurpose>Returns error description</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_error</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns error message for target (last request). An empty string
- is returned if last operation was a success.
- </para>
- <para>
- <function>Yaz_error</function> returns a english message
- corresponding to the last error number as returned by
- <function>yaz_errno</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-hits">
- <refnamediv>
- <refname>yaz_hits</refname>
- <refpurpose>Returns number of hits for last search</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_hits</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Yaz_hits</function> returns number of hits for last
- search.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-range">
- <refnamediv>
- <refname>yaz_range</refname>
- <refpurpose>
- Specifies the maximum number of records to retrieve
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_connect</function>
+ </funcdef>
+ <paramdef>string <parameter>zurl</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Yaz_connect</function>은 Z39.50
+target과의 연결을 준비한다. zurl 변수는 host[:port][/database]형태를
+취한다.
+ 만일 port가 주어지지 않으면 "210"이
+사용되고, database가 주어지지 않으면 "Default"를 사용한다.
+non-blocking함수이고, socket을 만들려고 시도하지 않는다.
+ - 이것은 단지 마지막으로
+<function>yaz_wait</function>가 호출되었을때 수행된 연결을 준비한다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-errno">
+ <refnamediv>
+ <refname>yaz_errno</refname>
+ <refpurpose>error number를 리턴한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_errno</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ target (last request)에 관한 error을 리턴한다. target이
+진단코드(diagnostic code)를 리턴한 경우 양의 값을; 성공하여
+에러가 없는 경우는 "0"의 값을; 요청에 대한 에러를 나타내지
+못하는 경우 음의 값을 리턴한다.
+ </para>
+ <para>
+ <function>Yaz_errno</function>은 마지막 작업이
+success/failure가 결정된 target에 대한 네트워크가
+활성화(<function>yaz_wait</function>라 리턴된 후에) 된 다음에
+호출되어야 한다. (예. search)
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-error">
+ <refnamediv>
+ <refname>yaz_error</refname>
+ <refpurpose>error내용을 리턴한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_error</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ target (마지막 요청한)의 error 메세지를 리턴한다. 마지막
+행한 작업이 성공적인 경우 공백문자(empty string)을 리턴한다.
+ </para>
+ <para>
+ <function>Yaz_error</function>는
+<function>yaz_errno</function>에 의해 리터된 마지막 에러번호에
+일치하는 영문 메세지를 리턴한다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-hits">
+ <refnamediv>
+ <refname>yaz_hits</refname>
+ <refpurpose>마지막 검색에 대한 히트수를
+리턴한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_hits</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Yaz_hits</function> 마지막 검색에
+대한 히트수를 리턴한다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-range">
+ <refnamediv>
+ <refname>yaz_range</refname>
+ <refpurpose>
+ 검색결과를 나타낼 범위를 지정한다.
</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_range</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- <paramdef>int <parameter>start</parameter></paramdef>
- <paramdef>int <parameter>number</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- This function is used in conjunction with
- <function>yaz_search</function> to specify the maximum number of
- records to retrieve (number) and the first record position
- (start). If this function is not invoked (only
- <function>yaz_search</function>) start is set to 1 and number is
- set to 10.
- </para>
- <para>
- Returns true on success; false on error.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-record">
- <refnamediv>
- <refname>yaz_record</refname>
- <refpurpose>Returns a record</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_record</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- <paramdef>int <parameter>pos</parameter></paramdef>
- <paramdef>string <parameter>type</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Returns record at position or empty string if no record exists at
- given position.
- </para>
- <para>
- The <function>yaz_record</function> function inspects a record in
- the current result set at the position specified. If no database
- record exists at the given position an empty string is
- returned. The argument, type, specifies the form of the returned
- record. If type is "string" the record is returned in a string
- representation suitable for printing (for XML and SUTRS). If type
- is "array" the record is returned as an array representation (for
- structured records).
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-search">
- <refnamediv>
- <refname>yaz_search</refname>
- <refpurpose>Prepares for a search</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_search</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- <paramdef>string <parameter>type</parameter></paramdef>
- <paramdef>string <parameter>query</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>yaz_search</function> prepares for a search on the
- target with given id. The type represents the query type - only
- "rpn" is supported now in which case the third argument specifies
- a Type-1 query (RPN). Like <function>yaz_connect</function> this
- function is non-blocking and only prepares for a search to be
- executed later when <function>yaz_wait</function> is called.
- </para>
- </refsect1>
- <refsect1>
- <title>The RPN query</title>
- <para>
- The RPN query is a textual represenation of the Type-1 query as
- defined by the Z39.50 standard. However, in the text representation
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_range</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ <paramdef>int <parameter>start</parameter>
+ </paramdef>
+ <paramdef>int <parameter>number</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 이 함수는 <function>yaz_search</function>와 조합하여
+시작위치(start)와 검색내용 중 나열할 최대값(number)을
+나타내는데 이용된다. start의 디폴트 값은 "1"이고, number의
+디폴트 값은 "10"이다.( 단지 <function>yaz_search</function>만이
+있는경우)
+ </para>
+ <para>
+ 성공하면 true를 : 에러가 난 경우는 false 를 반환한다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-record">
+ <refnamediv>
+ <refname>yaz_record</refname>
+ <refpurpose>레코드를 리턴한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_record</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ <paramdef>int <parameter>pos</parameter>
+ </paramdef>
+ <paramdef>string <parameter>type</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 주어진 포지션에 레코드가 없는경우 공백문자를 반환하고,
+있는경우 레코드를 반환한다.
+ </para>
+ <para>
+ <function>yaz_record</function>는 지정된 위치의
+result set에서의 레코드를 점검한다. 만일 주어진 위치에서 database
+record 존재하지 않으면 공백문자를 리턴한다. 변수는 리턴될
+레코드의 type를 지정한다. 만일 "string"이 주어지면 레코드는
+(XML과 SUTRS)출력에 적합한 문자로 리턴된다. 만일 "array"로
+지정하면 (structured records위한) 배열로 리턴된다.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-search">
+ <refnamediv>
+ <refname>yaz_search</refname>
+ <refpurpose>검색을 준비한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_search</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ <paramdef>string <parameter>type</parameter>
+ </paramdef>
+ <paramdef>string <parameter>query</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>yaz_search</function>은 주어진 ID로
+target에 검색을 준비한다. type은 쿼리 타입을 나타낸다.-세번째
+변수로 지정된 Type-1 query (RPN)인 경우 단지 "rpn"만을 지원한다.
+<function>yaz_connect</function>처럼 non-blocking 이고
+<function>yaz_wait</function>이 호출된 이후에 검색을 준비한다.
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>The RPN query</title>
+ <para>
+ The RPN query is a textual represenation of the Type-1 query as defined by the
+Z39.50 standard. However, in the text representation
as used by YAZ a prefix notation is used, that is the operater
precedes the operands. The query string is a sequence of tokens where
white space is ignored is ignored unless surrounded by double
quotes. Tokens beginning with an at-character (<literal>@</literal>)
are considered operators, otherwise they are treated as search terms.
</para>
- <table>
- <title>RPN Operators</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Syntax</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>@and query1 query2</literal></entry>
- <entry>intersection of query1 and query2</entry>
- </row>
- <row>
- <entry><literal>@or query1 query2</literal></entry>
- <entry>union of query1 and query2</entry>
- </row>
- <row>
- <entry><literal>@not query1 query2</literal></entry>
- <entry>query1 and not query2</entry>
- </row>
- <row>
- <entry><literal>@set name</literal></entry>
- <entry>result set reference</entry>
- </row>
- <row>
- <entry><literal>@attrset set query</literal></entry>
- <entry>specifies attribute-set for query. This construction is only
+ <table>
+ <title>RPN Operators</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Syntax</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <literal>@and query1
+query2</literal>
+ </entry>
+ <entry>intersection of query1
+and query2</entry>
+ </row>
+ <row>
+ <entry>
+ <literal>@or query1
+query2</literal>
+ </entry>
+ <entry>union of query1 and
+query2</entry>
+ </row>
+ <row>
+ <entry>
+ <literal>@not query1
+query2</literal>
+ </entry>
+ <entry>query1 and not
+query2</entry>
+ </row>
+ <row>
+ <entry>
+ <literal>@set
+name</literal>
+ </entry>
+ <entry>result set
+reference</entry>
+ </row>
+ <row>
+ <entry>
+ <literal>@attrset set
+query</literal>
+ </entry>
+ <entry>specifies attribute-set
+for query. This construction is only
allowed once - in the beginning of the whole query</entry>
- </row>
- <row>
- <entry><literal>@attr set type=value query</literal></entry>
- <entry>applies attribute to query. The type and value are
+ </row>
+ <row>
+ <entry>
+ <literal>@attr set
+type=value query</literal>
+ </entry>
+ <entry>applies attribute to
+query. The type and value are
integers specifying the attribute-type and attribute-value
respectively. The set, if given, specifies the
attribute-set.</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
The following illustrates valid query constructions:
<informalexample>
- <screen>computer</screen>
- </informalexample>
+ <screen>computer</screen>
+ </informalexample>
Matches documents where "computer" occur. No attributes are specified.
</para>
- <para>
- <informalexample>
- <screen>"donald knuth"</screen>
- </informalexample>
+ <para>
+ <informalexample>
+ <screen>"donald knuth"</screen>
+ </informalexample>
Matches documents where "donald knuth" occur.
</para>
- <para>
- <informalexample>
- <screen>@attr 1=4 art</screen>
- </informalexample>
+ <para>
+ <informalexample>
+ <screen>@attr 1=4 art</screen>
+ </informalexample>
Attribute type is 1 (Bib-1 use), attribute value is 4
Title), so this should match documents where "art" occur
in the title.
</para>
- <para>
- <informalexample>
-<screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen>
- </informalexample>
+ <para>
+ <informalexample>
+ <screen>@attrset gils @and @attr 1=4 art @attr
+1=1003 "donald knuth"</screen>
+ </informalexample>
The query as a whole uses the GILS attributeset. The query matches
documents where "art" occur in the title and in which "donald knuth"
occur in the author.
</para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-syntax">
- <refnamediv>
- <refname>yaz_syntax</refname>
- <refpurpose>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-syntax">
+ <refnamediv>
+ <refname>yaz_syntax</refname>
+ <refpurpose>
Specifies the object identifier (OID) for the preferred record syntax
for retrieval.
</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_syntax</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- <paramdef>string <parameter>syntax</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_syntax</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ <paramdef>string <parameter>syntax</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
The syntax may be specified in a raw dot-notation (like
<literal>1.2.840.10003.5.10</literal>) or as one of the known
record syntaxes (sutrs, usmarc, grs1, xml, etc.).
@@ -455,24 +432,26 @@
<function>yaz_search</function> to specify the preferred record
syntax for retrieval.
</para>
- </refsect1>
- </refentry>
-
- <refentry id="function.yaz-wait">
- <refnamediv>
- <refname>yaz_wait</refname>
- <refpurpose>Executes queries</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>yaz_wait</function></funcdef>
- <paramdef>int <parameter>id</parameter></paramdef>
- <paramdef>string <parameter>syntax</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.yaz-wait">
+ <refnamediv>
+ <refname>yaz_wait</refname>
+ <refpurpose>Executes queries</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>yaz_wait</function>
+ </funcdef>
+ <paramdef>int <parameter>id</parameter>
+ </paramdef>
+ <paramdef>string <parameter>syntax</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
This function carries out networked (blocked) activity for
outstanding requests which have been prepared by the functions
<function>yaz_connect</function>,
@@ -480,11 +459,9 @@
returns when all targets have either completed all requests or
otherwise completed (in case of errors).
</para>
- </refsect1>
- </refentry>
-
- </reference>
-
+ </refsect1>
+ </refentry>
+</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
