(accept-async): Added the error code long-array.

(add-member): Added a comment.
(local-to-global): Documented.
(The User Area): Register WWW-kom.

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.56 1999/04/05 20:11:41 ceder Exp $
+@c $Id: Protocol-A.texi,v 1.57 1999/04/15 20:51:44 ceder Exp $
 @c %**start of header
 @setfilename protocol-a.info
 @settitle LysKOM Protocol A
@@ -6423,6 +6423,14 @@ first offending number.
 
 Please note that a bug in lyskomd 1.9.0 prevented the server from
 sending this error message (frankly, we simply forgot about it.)
+
+@item long-array
+The @code{request-list} was too long.  Servers should always accept a
+@code{request-list} that contains a lot more asynchronous messages than
+the server sends, so that it can deal with newer clients.  This error
+message should only be returned if the client tries to trigger a buffer
+overrun.
+
 @end table
 
 
@@ -7194,6 +7202,8 @@ Conference @code{conf-no} does not exist or is secret.
 Person @code{pers-no} does not exist
 
 @item access-denied
+@c FIXME: the "or to change" part is bogus, right?  Aren't those
+@c cirumstances covered by permission-denied?
 Not enough permissions or privileges to add members to conference or to
 change privileges, position or type of a preexisting membership.
 @code{conf-no}.
@@ -7309,7 +7319,62 @@ restrictions set on the server or on the conference @code{conf}
                 -> ( Text-Mapping );
 @end example
 
-FIXME: more text here
+This call retrieves information that makes it possible to convert 
+@code{no-of-existing-texts} existing local text numbers starting at
+@code{first-local-no} to global text numbers, provided that there are
+that many local texts.
+
+The @code{conf-no} parameter specifies which conference to look up local
+numbers in.  @code{first-local-no} is the first number that the client
+is interested in.  @code{no-of-existing-texts} is the maximum number of
+texts the client wants information about.  Legal values for
+@code{no-of-existing-texts} are 1-255 (inclusive).
+
+The server will return a sparse or dense Text-Mapping depending on the
+how many deleted texts there are after @code{first-local-no}.
+
+@example
+        1 103 93 1 5
+        =1 1 7 1 1 1 6 @{ 1003 1005 1009 1029 0 1034 @}
+        2 103 93 1 6
+        =2 1 63 1 0 6 @{
+            1 1003 
+            2 1005
+            3 1009
+            4 1029
+            6 1034
+            62 1302 @}
+        3 103 93 50 10
+        =3 50 70 0 0 2 @{
+            62 1302
+            69 1006 @}
+@end example
+
+The above example shows three calls to @code{local-to-global}.  (Extra
+newlines have been inserted in the result of the two final calls to make
+the result more readable.)
+
+The first call requests information about the first five existing texts
+in conference 93.  The result contains information about texts in the
+range [1-7), and there are more texts.  The server uses the dense form
+of the Text-Mapping.  As can be seen from the result, they have local
+text numbers 1, 2, 3, 4 and 6.  The global text number corresponding to
+local text number 5 is sent as 0, indicating that it doesn't exist.
+
+In the second call, the client requests the same information, but one
+additional text.  The result looks dramatically different, since the
+next existing text in this example has local text number 62.  The result
+contains information about texts in the range [1-63), and there are more
+texts.  The server of course uses the sparse form of the Text-Mapping.
+
+The final call shows what happens when @code{first-local-no} doesn't
+exist.  The result contains information about texts in the range
+[50-70); only local text number 62 and 69 actually exists in that
+range.  69 is the highest local text number.
+
+(Note that local text number 69 corresponds to global text number 1006,
+which is lower than 1302.  Situations like this often occurs when
+@code{add-recipient} is used.)
 
 @unnumberedsubsec Error codes
 
@@ -7317,7 +7382,26 @@ FIXME: more text here
 @item login-first
 Login required before issuing this call.
 
-@c FIXME: more codes here
+@item long-array
+@code{no-of-existing-texts} was larger than 255.
+
+@item conf-zero
+@code{conf-no} was set to 0.
+
+@item local-text-zero
+@code{first-local-no} was set to 0.
+
+@item undef-conf
+The conference does not exist, or the client is not allowed to know that
+it exists.
+
+@item access-denied
+The conference exists, but the client is not allowed to retrieve
+information about the texts in the conference.
+
+@item no-such-local-text
+@code{first-local-no} is greater than the highest local text number that
+ever existed in the conference.
 
 @end table
 
@@ -8048,6 +8132,9 @@ described below.
 @item elisp
 The block created by the Emacs list client. The format is completely
 undocumented, but you'll need a lisp reader to parse it.
+@item WWW-kom
+The block created by the web gateway WWW-kom.  It has the same syntax as
+the common block, but the keys and values are not documented.
 @end table
 
 If you're writing a client that uses the user-area, please let us know