(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.

doc/Protocol-A.texi

 \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