Commit e93fc54f authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(LysKOM Data Types): The order of the elements in Who-Innfo-Old was

	wrong.  The same bug existed at least as far back as in the
	prot-A.txt file that was distributed with the 1.7.0 server.  I
	find it better to change the documentation than the code.
(create-person-old): Document the auto-login feature.
(who-is-on): Clarify which sessions that are returned.
(get-unread-confs): Clarify that this request may return extra
	conferences.  This request may not be made before you log in.
parent a2206ea7
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c $Id: Protocol-A.texi,v 1.22 1998/08/26 22:33:42 ceder Exp $ @c $Id: Protocol-A.texi,v 1.23 1998/08/28 08:04:10 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
...@@ -2103,8 +2103,8 @@ introduced in protocol version 10 or later. ...@@ -2103,8 +2103,8 @@ introduced in protocol version 10 or later.
@example @example
Who-Info-Old ::= Who-Info-Old ::=
( person : Pers-No; ( person : Pers-No;
what-am-i-doing : HOLLERITH;
working-conference : Conf-No; working-conference : Conf-No;
what-am-i-doing : HOLLERITH;
) )
Who-Info-List-Old ::= ARRAY Who-Info-Old; Who-Info-List-Old ::= ARRAY Who-Info-Old;
...@@ -2145,10 +2145,10 @@ The fields of @code{Who-Info-Old} are ...@@ -2145,10 +2145,10 @@ The fields of @code{Who-Info-Old} are
@table @code @table @code
@item person @item person
The person the information is about. The person the information is about.
@item what-am-i-doing
A client-supplied string saying what the person is doing.
@item working-conference @item working-conference
The conference the person is currently in. The conference the person is currently in.
@item what-am-i-doing
A client-supplied string saying what the person is doing.
@end table @end table
The fields of @code{Who-Info} are The fields of @code{Who-Info} are
...@@ -2711,8 +2711,12 @@ using LysKOM. Clients are encouraged to use this call creatively. ...@@ -2711,8 +2711,12 @@ using LysKOM. Clients are encouraged to use this call creatively.
@end example @end example
This call requests that the server create a new person with the name and This call requests that the server create a new person with the name and
password given as arguments. To create a person the session must be password given as arguments. To create a person the session may have to
logged in as a person with sufficient privileges. be logged in as a person with sufficient privileges, if the server is
configured that way.
If the session was not logged in an automatic visible login to the new
person will be performed.
@i{Example:} @i{Example:}
@example @example
...@@ -4973,7 +4977,8 @@ This call is obsolete. Please use @ref{who-is-on-dynamic} and ...@@ -4973,7 +4977,8 @@ This call is obsolete. Please use @ref{who-is-on-dynamic} and
@code{get-static-session-info} instead. Nonetheless, servers should @code{get-static-session-info} instead. Nonetheless, servers should
support this call since many clients still use it. support this call since many clients still use it.
This call should simply return a list of visible sessions. The data This call should simply return a list of visible sessions (sessions
where a person is logged in and the invisible flag is unset). The data
structure is described elsewhere (@pxref{LysKOM Data Types}.) structure is described elsewhere (@pxref{LysKOM Data Types}.)
@unnumberedsubsubsec Error codes @unnumberedsubsubsec Error codes
...@@ -4992,11 +4997,13 @@ This call always succeeds. ...@@ -4992,11 +4997,13 @@ This call always succeeds.
@end example @end example
This call returns a list of conferences in which the person This call returns a list of conferences in which the person
@code{pers-no} has unread texts. This call may be issued without logging @code{pers-no} may have unread texts. This call will return a result for
on, and will return a result for any valid @code{pers-no}. To retrieve any valid @code{pers-no}. To retrieve information about secret persons,
information about secret persons, or to get information about unread or to get information about unread texts in secret conference, the
texts in secret conference, the session must log on as a person with session must log on as a person with access to that information.
access to that information.
The result is guaranteed to include all conferences where @code{pers-no}
has unread texts. It may also return some extra conferences.
@example @example
1 52 7 1 52 7
......
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