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-*-
@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
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -2103,8 +2103,8 @@ introduced in protocol version 10 or later.
@example
Who-Info-Old ::=
( person : Pers-No;
what-am-i-doing : HOLLERITH;
working-conference : Conf-No;
what-am-i-doing : HOLLERITH;
)
Who-Info-List-Old ::= ARRAY Who-Info-Old;
......@@ -2145,10 +2145,10 @@ The fields of @code{Who-Info-Old} are
@table @code
@item person
The person the information is about.
@item what-am-i-doing
A client-supplied string saying what the person is doing.
@item working-conference
The conference the person is currently in.
@item what-am-i-doing
A client-supplied string saying what the person is doing.
@end table
The fields of @code{Who-Info} are
......@@ -2711,8 +2711,12 @@ using LysKOM. Clients are encouraged to use this call creatively.
@end example
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
logged in as a person with sufficient privileges.
password given as arguments. To create a person the session may have to
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:}
@example
......@@ -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
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}.)
@unnumberedsubsubsec Error codes
......@@ -4992,11 +4997,13 @@ This call always succeeds.
@end example
This call returns a list of conferences in which the person
@code{pers-no} has unread texts. This call may be issued without logging
on, and will return a result for any valid @code{pers-no}. To retrieve
information about secret persons, or to get information about unread
texts in secret conference, the session must log on as a person with
access to that information.
@code{pers-no} may have unread texts. This call will return a result for
any valid @code{pers-no}. To retrieve information about secret persons,
or to get information about unread texts in secret conference, the
session must log on as a person with 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
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