(LysKOM Data Types): Explain Text-Mapping.

doc/Protocol-A.texi

@@ -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