Commit 941ed5ac authored by Per Cederqvist's avatar Per Cederqvist

(The Misc-Info List): Document blank carbon copies.

(create-person-old): Document that the new person will be a member of
	his letterbox.
(create-person): Likewise.
parent b8c355e0
\input texinfo @c -*-texinfo-*-
@c $Id: Protocol-A.texi,v 1.33 1998/10/06 07:39:01 ceder Exp $
@c $Id: Protocol-A.texi,v 1.34 1998/10/06 20:03:58 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -523,7 +523,8 @@ in a single session.
The @code{Misc-Info} list contains tagged data. The fields are sent in
groups pertaining to a particular type of information: information about
recipient; carbon copy recipient, comment to; footnote to; comment in
recipient; carbon copy recipient; blank carbon copy recipient;
comment to; footnote to; comment in
and footnote in. The information groups may be sent in any order and
there may be any number of groups. Within each group the elements are
always sent in the order listed below.
......@@ -570,17 +571,58 @@ number of the article in the conference specified by the most recent
@code{cc-recpt} field.
@item rec-time
Present after the CC recipient has read the article. It contains the
time when the article was read.
time when the article was read. Since only persons can read articles
this will only be seen if the CC recipient is a person.
@item sent-by
Present when a CC recipient was added by a person other than the author
after the article had been created. It contains the person number of the
person who added the cc recipient.
person who added the CC recipient.
@item sent-at
Present when a CC recipient was added after the article had been
created. It is the time when the CC recipient was added.
@end table
@subsection Blank Carbon Copy (BCC) Recipient
The blank carbon-copy recipient group is identical to the carbon-copy
recipient group above. The difference is the visibility of the
information. A carbon-copy recipient group is visible to anyone that is
allowed to fetch both the text status of the involed text and the
conference status of the involved conference. (That is, as long as the
conference isn't secret everybody is allowed to se the carbon-copy
recipient group.)
A BCC recipient group is only visible to members and supervisors of the
recipient. This is enforced by the server.
This type of group was introduced in protocol version 10. When
old-style calls such as @code{@xref{get-text-stat-old}} are used this
will be converted to a CC recipient group by the server for the benefit
of clients that don't understand this group.
@table @code
@item bcc-recpt
Starts a blank carbon-copy recipient group. It contains the conference
number of a blank carbon-copy recipient of the article.
@item loc-no
Always present in a BCC recipient group. It contains the local text
number of the article in the conference specified by the most recent
@code{bcc-recpt} field.
@item rec-time
Present after the BCC recipient has read the article. It contains the
time when the article was read. Since only persons can read articles
this will only be seen if the BCC recipient is a person.
@item sent-by
Present when a BCC recipient was added by a person other than the author
after the article had been created. It contains the person number of the
person who added the BCC recipient.
@item sent-at
Present when a BCC recipient was added after the article had been
created. It is the time when the BCC recipient was added.
@end table
@subsection Comment To
@table @code
......@@ -770,6 +812,8 @@ a letterbox, the person attached to the letterbox. The hide-creator and
secret bits are cleared automatically. Only one redirect can be
specified.
@c FIXME: who is responsible for the redirect? The client? The server?
@c A magic redirecting client?
@item x-face [9] (conference)
......@@ -2727,6 +2771,10 @@ configured that way.
If the session was not logged in an automatic visible login to the new
person will be performed.
The new person will be a member of exactly one conference: the
associated mailbox. That membership will have priority 255 and (of
course) position 0. All flags of the membership will be 0.
@i{Example:}
@example
1 5 24HLysKOM Statistics Daemon 6Hsecret
......@@ -6413,6 +6461,10 @@ logged in as a person with sufficient privileges. The list
@code{aux-items} contains the aux items that are to be attached to the
new person's letterbox conference.
The new person will be a member of exactly one conference: the
associated letterbox. That membership will have priority 255 and (of
course) position 0. All flags of the membership will be 0.
@unnumberedsubsubsec Error codes
......
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