Commit 8301267b authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(Articles): Refer to local-to-global instead of get-map.

(LysKOM Data Types): Added subsection titled "Mapping Local to Global
	Text Numbers".
(Protocol Requests): Mark get-map as obsolete, and refer to 103.
	Added 103=local-to-global.
(get-map): This is superseded by local-to-global.
(accept-async): Fixed typo.
(local-to-global): New node.
parent 8649d234
\input texinfo @c -*-texinfo-*-
@c $Id: Protocol-A.texi,v 1.10 1998/08/02 18:44:34 ceder Exp $
@c $Id: Protocol-A.texi,v 1.11 1998/08/03 21:04:11 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -442,7 +442,7 @@ and are never reused for a particular recipient, though different
recipients will have articles with the same local numbers.
Occasionally it is necessary to map between local and global numbers.
The server call @code{get-map} does this.
The server call @code{local-to-global} does this.
......@@ -1548,6 +1548,28 @@ the conference.
@end table
@subsection Mapping Local to Global Text Numbers
@example
Local-To-Global-Result ::=
( later-texts-exists : BOOL;
block : Local-To-Global-Block;
)
Local-To-Global-Block ::= SELECTION
( 0=sparse sparse-block : ARRAY Text-Number-Pair;
1=dense dense-block : Text-List;
)
Text-Number-Pair ::=
( local-number : Local-Text-No;
global-number : Text-No;
)
@end example
FIXME: more text here.
@subsection Server Information
@example
......@@ -2355,7 +2377,7 @@ in the example.
* sub-recipient:: Remove a recipient from an article (31)
* add-comment:: Add a comment to an article (32)
* sub-comment:: Remove a comment from an article (33)
* get-map:: Map local text numbers to global ones (34)
* get-map:: O Map local text numbers to global. Use 103 (34)
* get-time:: Get the current time (35)
* get-info-old:: O Get server information (36)
* add-footnote:: Add an article as a footnote to another (37)
......@@ -2424,6 +2446,7 @@ in the example.
* add-member:: Add a member to a conference (100)
* get-members:: Get members of a conference (101)
* set-membership-type:: Modify the type of conference (102)
* local-to-global:: Map local text numbers to global ones (103)
@end menu
@iftex
......@@ -3947,7 +3970,7 @@ The text @code{comment-to} already has the maximum number of comments.
@node sub-comment, get-map, add-comment, Protocol Requests
@subsection sub-comment (1) Recommended
@subsection sub-comment (1) Obsolete (10)
@example
sub-comment [33] (( text-no : Text-No;
......@@ -4007,6 +4030,8 @@ anyway.
-> ( result : Text-List );
@end example
This call has been superceded by @ref{local-to-global}.
This call retrieves an array mapping local text numbers to global
numbers. It is most often used to get a list of unread texts in a
conference. Clients will usually use the @code{query-read-texts}
......@@ -5731,7 +5756,7 @@ The MOTD text in @code{info} already has the maximum number of marks.
@subsection accept-async (9) Recommended
@example
accept-async [80] ( request-list : ARRAY 32 ) -> ( )
accept-async [80] ( request-list : ARRAY INT32 ) -> ( )
@end example
This call advises the server that the client wants to receive the
......@@ -6544,7 +6569,7 @@ The conference @code{conf} does not exist or is secret.
@end table
@node set-membership-type, ,get-members, Protocol Requests
@node set-membership-type, local-to-global, get-members, Protocol Requests
@subsection set-membership-type (10) Recommended
@example
......@@ -6564,6 +6589,18 @@ the server's restrictions will result in an error.
@node local-to-global, ,set-membership-type, Protocol Requests
@subsection local-to-global (10) Recommended
@example
local-to-global [103] (( conf-no : Conf-No;
first-local-no : Local-Text-No;
no-of-existing-texts : INTEGER; ))
-> ( result : Local-To-Global-Result );
@end example
FIXME: more text here
@node Asynchronous Messages, , , Top
@chapter Asynchronous Messages
......
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