Commit afaaeff2 authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(LysKOM Data Types): Documented Conf-List-Archaic.

(lookup-name): This request returns a Conf-List-Archaic, not a
	Conf-No-List.  Added an example.
parent 4ffc133c
\input texinfo @c -*-texinfo-*-
@c $Id: Protocol-A.texi,v 1.18 1998/08/22 20:55:26 ceder Exp $
@c $Id: Protocol-A.texi,v 1.19 1998/08/23 20:26:09 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -1609,6 +1609,23 @@ The number of days an article should be kept before being removed from
the conference.
@end table
@subsection Archaic way to list conferences
The result of request number 12, lookup-name, cannot be expressed in the
grammar used in this document. This is as close as it gets:
@tindex Conf-List-Archaic
@example
Conf-List-Archaic ::=
( conf-nos : ARRAY Conf-no;
conf-types : ARRAY Conf-Type; # Sans <n>; see below
)
@end example
The two arrays @code{conf-nos} and @code{conf-types} are always the same
size. For some obscure reason the size of the second array is not
actually transmitted. See also the example in @ref{lookup-name}.
@subsection Mapping Local to Global Text Numbers
......@@ -3036,12 +3053,32 @@ is corrupt.)
@findex lookup-name
@example
lookup-name [12] ( name : HOLLERITH ) -> ( Conf-No-List );
lookup-name [12] ( name : HOLLERITH ) -> ( Conf-List-Archaic );
@end example
This call returns a list of conferences matching the string @code{name}.
lookup-name has been superseded by call 76, @ref{lookup-z-name}.
@i{Example:}
@example
1 12 3Ha d
@t{=1 3 @{ 217 674 1582 @} @{ 0000 1001 0000 @}}
2 12 3H:::
@t{=2 0 * *}
3 76 3Ha d 1 1
@t{=3 3 @{ 31HAlkohol- (och annan) drogdebatt 0000 217
13HAnna Degerman 1001 674
27HAnarchy discussion (import) 0000 1582 @}}
4 76 3H::: 1 1
@t{=4 0 *}
@end example
This example shows two attempts to look up a name. The first example
looks up @samp{a d} and finds three matches (the middle, number 674, is
a person. The second example looks up @samp{:::} which doesn't match
any conference (or person). Call number 3 and 4 issues the same lookup
using the @ref{lookup-z-name} call. (The return value for call number 3
has been broken into three lines to fit on the page.)
@unnumberedsubsubsec Error codes
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment