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-*- \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 @c %**start of header
@setfilename protocol-a.info @setfilename protocol-a.info
@settitle LysKOM Protocol A @settitle LysKOM Protocol A
...@@ -442,7 +442,7 @@ and are never reused for a particular recipient, though different ...@@ -442,7 +442,7 @@ and are never reused for a particular recipient, though different
recipients will have articles with the same local numbers. recipients will have articles with the same local numbers.
Occasionally it is necessary to map between local and global 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. ...@@ -1548,6 +1548,28 @@ the conference.
@end table @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 @subsection Server Information
@example @example
...@@ -2355,7 +2377,7 @@ in the example. ...@@ -2355,7 +2377,7 @@ in the example.
* sub-recipient:: Remove a recipient from an article (31) * sub-recipient:: Remove a recipient from an article (31)
* add-comment:: Add a comment to an article (32) * add-comment:: Add a comment to an article (32)
* sub-comment:: Remove a comment from an article (33) * 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-time:: Get the current time (35)
* get-info-old:: O Get server information (36) * get-info-old:: O Get server information (36)
* add-footnote:: Add an article as a footnote to another (37) * add-footnote:: Add an article as a footnote to another (37)
...@@ -2424,6 +2446,7 @@ in the example. ...@@ -2424,6 +2446,7 @@ in the example.
* add-member:: Add a member to a conference (100) * add-member:: Add a member to a conference (100)
* get-members:: Get members of a conference (101) * get-members:: Get members of a conference (101)
* set-membership-type:: Modify the type of conference (102) * set-membership-type:: Modify the type of conference (102)
* local-to-global:: Map local text numbers to global ones (103)
@end menu @end menu
@iftex @iftex
...@@ -3947,7 +3970,7 @@ The text @code{comment-to} already has the maximum number of comments. ...@@ -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 @node sub-comment, get-map, add-comment, Protocol Requests
@subsection sub-comment (1) Recommended @subsection sub-comment (1) Obsolete (10)
@example @example
sub-comment [33] (( text-no : Text-No; sub-comment [33] (( text-no : Text-No;
...@@ -4007,6 +4030,8 @@ anyway. ...@@ -4007,6 +4030,8 @@ anyway.
-> ( result : Text-List ); -> ( result : Text-List );
@end example @end example
This call has been superceded by @ref{local-to-global}.
This call retrieves an array mapping local text numbers 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 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} 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. ...@@ -5731,7 +5756,7 @@ The MOTD text in @code{info} already has the maximum number of marks.
@subsection accept-async (9) Recommended @subsection accept-async (9) Recommended
@example @example
accept-async [80] ( request-list : ARRAY 32 ) -> ( ) accept-async [80] ( request-list : ARRAY INT32 ) -> ( )
@end example @end example
This call advises the server that the client wants to receive the 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. ...@@ -6544,7 +6569,7 @@ The conference @code{conf} does not exist or is secret.
@end table @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 @subsection set-membership-type (10) Recommended
@example @example
...@@ -6564,6 +6589,18 @@ the server's restrictions will result in an error. ...@@ -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 @node Asynchronous Messages, , , Top
@chapter Asynchronous Messages @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