Commit 034bfbd7 authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(LysKOM Data Types): Explain Text-Mapping.

parent 777a0a29
......@@ -2,7 +2,7 @@
@c
@c FIXME: Explain how the garb works with nice and keep-commented
@c
@c $Id: Protocol-A.texi,v 1.55 1999/04/05 00:41:23 ceder Exp $
@c $Id: Protocol-A.texi,v 1.56 1999/04/05 20:11:41 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -1955,7 +1955,43 @@ actually transmitted. See also the example in @ref{lookup-name}.
)
@end example
FIXME: more text here.
A @code{Text-Mapping} is used when the client needs to look up which
global @code{Text-No} that corresponds to a @code{Local-Text-No}. The
client uses @code{local-to-global} to ask for information about a few
texts starting a a certain local text number, and the server returns the
information in a @code{Text-Mapping}.
@table @code
@item range-begin
The first local text number that the client asked about.
@item range-end
The first local text number that the reply doesn't say anything about.
This @code{Text-Mapping} tells the client about all existing texts from
@code{range-begin} to (but not including) @code{range-end}.
@item later-texts-exists
This is true if there are more texts in the conference after this
block.
@item block
The block can be sent i two formats. The server is free to choose which
format to use as it pleases; clients must be prepared for any of them.
@itemize @bullet
@item
The @dfn{sparse} format is useful when many local text number no longer
exists. It starts with a @code{0} that indicates that the sparse format
is used, and is followed by an array of @code{Text-Number-Pair}. The
array will always be sorted so that @code{local-number} always
increases.
@item
The @dfn{dense} format is good when most of the local text numbers
exist. It starts with a @code{1} that indicates that the dense format
is used, and is followed by a @code{Text-List}. The @code{Text-List}
contains @code{first-local-no} and an array of @code{Text-No}.
The local text number @code{first-local-no} corresponds to the first
@code{Text-No} in the array, @code{first-local-no} + 1 corresponds to
the second entry in the array, and so on. The array contains a zero to
indicate that a certain local text number doesn't exist.
@end itemize
@end table
@subsection Server Information
......
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