Node:The Misc-Info List,
Next:The Aux-Item List,
Previous:Persons and Sessions,
Up:Concepts
The Misc-Info List
The 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; 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.
Recipient
recpt
- Starts a recipient group. It contains the conference number of a
recipient of the article.
loc-no
- Always present within a recipient group. It contains the local text
number of the article in the conference specified by the preceding
recpt
field.
rec-time
- If the recipient is a person, this element is added by the server when
the recipient marks the article as read. It contains the time when the
text was read.
sent-by
- Present when the recipient was added by a person other than the author
(after the article was created.) It contains the person number of the
person who added the recipient.
sent-at
- Present when the recipient was added after the article was created. It
contains the time when the recipient was added.
Carbon Copy (CC) Recipient
The carbon-copy recipient group is identical to the recipient group
above. The difference is how new comments to an article with a recipient
or carbon-copy recipient are treated. A comment to an article is sent to
all recipients, but not to carbon-copy recipients of the original
article. This difference is enforced by the clients.
cc-recpt
- Starts a carbon-copy recipient group. It contains the conference number
of a carbon-copy recipient of the article.
loc-no
- Always present in a CC recipient group. It contains the local text
number of the article in the conference specified by the most recent
cc-recpt
field.
rec-time
- Present after the CC 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 CC recipient is a person.
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.
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.
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 involved text and the
conference status of the involved conference. (That is, as long as the
conference isn't secret everybody is allowed to see the carbon-copy
recipient group.)
A BCC recipient group is basically only visible to members and
supervisors of the recipient. Persons that have the right to become a
member of the recipient can also see it, as can the author of the text
(unless the recipient is secret to him). This is enforced by the
server.
This type of group was introduced in protocol version 10. When
old-style calls such as 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. (This
conversion will of course only be performed when the user is allowed
to se the blank carbon copy.)
bcc-recpt
- Starts a blank carbon-copy recipient group. It contains the conference
number of a blank carbon-copy recipient of the article.
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
bcc-recpt
field.
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.
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.
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.
Comment To
comm-to
- Always present when the article is a comment to another article.
sent-by
- Present when the article was added as a comment by a person other than
the author, after the article had been created. It contains the person
number of the person who added the article as a comment.
sent-at
- Present when the article was added as a comment after the article had
been created. It contains the time when it was added as a comment.
Footnote To
footn-to
- Always present when the article is a footnote to another article.
sent-at
- Present when the article was added as a footnote after the article had
been created. It contains the time when it was added as a footnote.
Comment in
comm-in
- Present when there are comments to this article. It contains the article
number which is a comment to this article.
Footnote in
footn-in
- Present when there are footnotes to this article. It contains the
article number which is a footnote to this article.