From 4f8ff9ad49e97500875222fda1de7b79c8178e13 Mon Sep 17 00:00:00 2001 From: Peter Saint-Andre Date: Sat, 21 Mar 2009 04:19:46 +0000 Subject: [PATCH] changed terminology section to use definition lists git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@2915 4b5297f7-1745-476d-ba37-a9c6900126ab --- xep-0045.xml | 94 +++++++++++++++++++++++++++------------------------- 1 file changed, 49 insertions(+), 45 deletions(-) diff --git a/xep-0045.xml b/xep-0045.xml index 0bb2f014..3a885f2e 100644 --- a/xep-0045.xml +++ b/xep-0045.xml @@ -471,53 +471,57 @@ -

Affiliation -- a long-lived association or connection with a room; the possible affiliations are "owner", "admin", "member", and "outcast" (naturally it is also possible to have no affiliation); affiliation is distinct from role. An affiliation lasts across a user's visits to a room.

-

Ban -- to remove a user from a room such that the user is not allowed to re-enter the room (until and unless the ban has been removed). A banned user has an affiliation of "outcast".

-

Bare JID -- the <user@host> by which a user is identified outside the context of any existing session or resource; contrast with Full JID and Room JID.

-

Full JID -- the <user@host/resource> by which an online user is identified outside the context of a room; contrast with Bare JID and Room JID.

-

GC -- the minimal "groupchat 1.0" protocol http://www.jabber.org/protocol/groupchat.html developed within the Jabber community in 1999; MUC is backwards-compatible with GC.

-

History -- a limited number of message stanzas sent to a new occupant to provide the context of current discussion.

-

Invitation -- a special message sent from one user to another asking the recipient to join a room.

-

IRC -- Internet Relay Chat.

-

Kick -- to temporarily remove a participant or visitor from a room; the user is allowed to re-enter the room at any time. A kicked user has a role of "none".

-

Logging -- storage of discussions that occur within a room for public retrieval outside the context of the room.

-

Member -- a user who is on the "whitelist" for a members-only room or who is registered with an open room. A member has an affiliation of "member".

-

Moderator -- a room role that is usually associated with room admins but that may be granted to non-admins; is allowed to kick users, grant and revoke voice, etc. A moderator has a role of "moderator".

-

MUC -- the multi-user chat protocol for text-based conferencing specified in this document.

-

Occupant -- any Jabber user who is in a room (this is an "abstract class" and does not correspond to any specific role).

-

Outcast -- a user who has been banned from a room. An outcast has an affiliation of "outcast".

-

Participant -- an occupant who does not have administrative privileges; in a moderated room, a participant is further defined as having voice (in contrast to a visitor). A participant has a role of "participant".

-

Private Message -- a message sent from one occupant directly to another's room JID (not to the room itself for broadcasting to all occupants).

-

Role -- a temporary position or privilege level within a room, distinct from a user's long-lived affiliation with the room; the possible roles are "moderator", "participant", and "visitor" (it is also possible to have no defined role). A role lasts only for the duration of an occupant's visit to a room.

-

Room -- a virtual space that Jabber users figuratively enter in order to participate in real-time, text-based conferencing with other users.

-

Room Administrator -- a user empowered by the room owner to perform administrative functions such as banning users; however, is not allowed to change defining room features. An admin has an affiliation of "admin".

-

Room ID -- the node identifier portion of a Room JID, which may be opaque and thus lack meaning for human users (see Business Rules for syntax); contrast with Room Name.

-

Room JID -- the &ROOMJID; by which an occupant is identified within the context of a room; contrast with Bare JID and Full JID.

-

Room Name -- a user-friendly, natural-language name for a room, configured by the room owner and presented in Service Discovery queries; contrast with Room ID.

-

Room Nickname -- the resource identifier portion of a Room JID (see Business Rules for syntax); this is the "friendly name" by which an occupant is known in the room.

-

Room Owner -- the Jabber user who created the room or a Jabber user who has been designated by the room creator or owner as someone with owner privileges (if allowed); is allowed to change defining room features as well as perform all administrative functions. An owner has an affiliation of "owner".

-

Room Roster -- a Jabber client's representation of the occupants in a room.

-

Server -- a Jabber server that may or may not have associated with it a text-based conferencing service.

-

Service -- a host that offers text-based conferencing capabilities; often but not necessarily a sub-domain of a Jabber server (e.g., conference.jabber.org).

-

Subject -- a temporary discussion topic within a room.

-

Visit -- a user's "session" in a room, beginning when the user enters the room (i.e., becomes an occupant) and ending when the user exits the room.

-

Visitor -- in a moderated room, an occupant who does not have voice (in contrast to a participant). A visitor has a role of "visitor".

-

Voice -- in a moderated room, the privilege to send messages to all occupants.

+
+
Affiliation
A long-lived association or connection with a room; the possible affiliations are "owner", "admin", "member", and "outcast" (naturally it is also possible to have no affiliation); affiliation is distinct from role. An affiliation lasts across a user's visits to a room.
 +
Ban
To remove a user from a room such that the user is not allowed to re-enter the room (until and unless the ban has been removed). A banned user has an affiliation of "outcast".
 +
Bare JID
The <user@host> by which a user is identified outside the context of any existing session or resource; contrast with Full JID and Room JID.
 +
Full JID
The <user@host/resource> by which an online user is identified outside the context of a room; contrast with Bare JID and Room JID.
 +
GC
The minimal "groupchat 1.0" protocol [7] developed within the Jabber community in 1999; MUC is backwards-compatible with GC.
 +
History
A limited number of message stanzas sent to a new occupant to provide the context of current discussion.
 +
Invitation
A special message sent from one user to another asking the recipient to join a room.
 +
IRC
Internet Relay Chat.
 +
Kick
To temporarily remove a participant or visitor from a room; the user is allowed to re-enter the room at any time. A kicked user has a role of "none".
 +
Logging
Storage of discussions that occur within a room for public retrieval outside the context of the room.
 +
Member
A user who is on the "whitelist" for a members-only room or who is registered with an open room. A member has an affiliation of "member".
 +
Moderator
A room role that is usually associated with room admins but that may be granted to non-admins; is allowed to kick users, grant and revoke voice, etc. A moderator has a role of "moderator".
 +
MUC
The multi-user chat protocol for text-based conferencing specified in this document.
 +
Occupant
Any Jabber user who is in a room (this is an "abstract class" and does not correspond to any specific role).
 +
Outcast
A user who has been banned from a room. An outcast has an affiliation of "outcast".
 +
Participant
An occupant who does not have administrative privileges; in a moderated room, a participant is further defined as having voice (in contrast to a visitor). A participant has a role of "participant".
 +
Private Message
A message sent from one occupant directly to another's room JID (not to the room itself for broadcasting to all occupants).
 +
Role
A temporary position or privilege level within a room, distinct from a user's long-lived affiliation with the room; the possible roles are "moderator", "participant", and "visitor" (it is also possible to have no defined role). A role lasts only for the duration of an occupant's visit to a room.
 +
Room
A virtual space that Jabber users figuratively enter in order to participate in real-time, text-based conferencing with other users.
 +
Room Administrator
A user empowered by the room owner to perform administrative functions such as banning users; however, is not allowed to change defining room features. An admin has an affiliation of "admin".
 +
Room ID
The node identifier portion of a Room JID, which may be opaque and thus lack meaning for human users (see Business Rules for syntax); contrast with Room Name.
 +
Room JID
The <room@service/nick> by which an occupant is identified within the context of a room; contrast with Bare JID and Full JID.
 +
Room Name
A user-friendly, natural-language name for a room, configured by the room owner and presented in Service Discovery queries; contrast with Room ID.
 +
Room Nickname
The resource identifier portion of a Room JID (see Business Rules for syntax); this is the "friendly name" by which an occupant is known in the room.
 +
Room Owner
The Jabber user who created the room or a Jabber user who has been designated by the room creator or owner as someone with owner privileges (if allowed); is allowed to change defining room features as well as perform all administrative functions. An owner has an affiliation of "owner".
 +
Room Roster
A Jabber client's representation of the occupants in a room.
 +
Server
A Jabber server that may or may not have associated with it a text-based conferencing service.
 +
Service
A host that offers text-based conferencing capabilities; often but not necessarily a sub-domain of a Jabber server (e.g., conference.jabber.org).
 +
Subject
A temporary discussion topic within a room.
 +
Visit
A user's "session" in a room, beginning when the user enters the room (i.e., becomes an occupant) and ending when the user exits the room.
 +
Visitor
In a moderated room, an occupant who does not have voice (in contrast to a participant). A visitor has a role of "visitor".
 +
Voice
In a moderated room, the privilege to send messages to all occupants.
 +
-

Fully-Anonymous Room -- a room in which the full JIDs or bare JIDs of occupants cannot be discovered by anyone, including room admins and room owners; such rooms are NOT RECOMMENDED or explicitly supported by MUC, but are possible using this protocol if a service implementation offers the appropriate configuration options; contrast with Non-Anonymous Room and Semi-Anonymous Room.

-

Hidden Room -- a room that cannot be found by any user through normal means such as searching and service discovery; antonym: Public Room.

-

Members-Only Room -- a room that a user cannot enter without being on the member list; antonym: Open Room.

-

Moderated Room -- a room in which only those with "voice" may send messages to all occupants; antonym: Unmoderated Room.

-

Non-Anonymous Room -- a room in which an occupant's full JID is exposed to all other occupants, although the occupant may choose any desired room nickname; contrast with Semi-Anonymous Room and Fully-Anonymous Room.

-

Open Room -- a room that anyone may enter without being on the member list; antonym: Members-Only Room.

-

Password-Protected Room -- a room that a user cannot enter without first providing the correct password; antonym: Unsecured Room.

-

Persistent Room -- a room that is not destroyed if the last occupant exits; antonym: Temporary Room.

-

Public Room -- a room that can be found by any user through normal means such as searching and service discovery; antonym: Hidden Room.

-

Semi-Anonymous Room -- a room in which an occupant's full JID can be discovered by room admins only; contrast with Fully-Anonymous Room and Non-Anonymous Room.

-

Temporary Room -- a room that is destroyed if the last occupant exits; antonym: Persistent Room.

-

Unmoderated Room -- a room in which any occupant is allowed to send messages to all occupants; antonym: Moderated Room.

-

Unsecured Room -- a room that anyone is allowed to enter without first providing the correct password; antonym: Password-Protected Room.

+
+
Fully-Anonymous Room
A room in which the full JIDs or bare JIDs of occupants cannot be discovered by anyone, including room admins and room owners; such rooms are NOT RECOMMENDED or explicitly supported by MUC, but are possible using this protocol if a service implementation offers the appropriate configuration options; contrast with Non-Anonymous Room and Semi-Anonymous Room.
 +
Hidden Room
A room that cannot be found by any user through normal means such as searching and service discovery; antonym: Public Room.
 +
Members-Only Room
A room that a user cannot enter without being on the member list; antonym: Open Room.
 +
Moderated Room
A room in which only those with "voice" may send messages to all occupants; antonym: Unmoderated Room.
 +
Non-Anonymous Room
A room in which an occupant's full JID is exposed to all other occupants, although the occupant may choose any desired room nickname; contrast with Semi-Anonymous Room and Fully-Anonymous Room.
 +
Open Room
A room that anyone may enter without being on the member list; antonym: Members-Only Room.
 +
Password-Protected Room
A room that a user cannot enter without first providing the correct password; antonym: Unsecured Room.
 +
Persistent Room
A room that is not destroyed if the last occupant exits; antonym: Temporary Room.
 +
Public Room
A room that can be found by any user through normal means such as searching and service discovery; antonym: Hidden Room.
 +
Semi-Anonymous Room
A room in which an occupant's full JID can be discovered by room admins only; contrast with Fully-Anonymous Room and Non-Anonymous Room.
 +
Temporary Room
A room that is destroyed if the last occupant exits; antonym: Persistent Room.
 +
Unmoderated Room
A room in which any occupant is allowed to send messages to all occupants; antonym: Moderated Room.
 +
Unsecured Room
A room that anyone is allowed to enter without first providing the correct password; antonym: Password-Protected Room.
 +

Most of the examples in this document use the scenario of the witches' meeting held in a dark cave at the beginning of Act IV, Scene I of Shakespeare's Macbeth, represented here as the "darkcave@chat.shakespeare.lit" chatroom. The characters are as follows: