Node:The Misc-Info List, Next:, 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.