Commit b195b3c9 authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(Membership Information): Renamed the reserved1 bit of Membership-Type

	to passive-message-invert. Document it.
(async-send-message): Mention that the passive and
	passive-message-invert bits of the Membership-Type influences
	if messages are sent or not.
(send-message): Mention passive and passive-message-invert.
	Mention async-send-message.
(Error Codes): Don't say "group message".
parent cbf65eb9
...@@ -2201,7 +2201,7 @@ have. ...@@ -2201,7 +2201,7 @@ have.
( invitation; ( invitation;
passive; passive;
secret; secret;
reserved1; passive-message-invert;
reserved2; reserved2;
reserved3; reserved3;
reserved4; reserved4;
...@@ -2220,14 +2220,24 @@ The member has been invited, but has not yet accepted membership. ...@@ -2220,14 +2220,24 @@ The member has been invited, but has not yet accepted membership.
Clients should set this flag when adding other users as members. The Clients should set this flag when adding other users as members. The
server may force this flag to be set when adding another person as a server may force this flag to be set when adding another person as a
member of a conference. member of a conference.
@item passive @item passive
The member is not actively participating in the conference. Passive The member is not actively participating in the conference. Passive
members do not receive group messages and should not be displayed as members do not receive messages (@pxref{async-send-message}) and
active members by clients. should not be displayed as active members by clients. See also
@field{passive-message-invert}.
@item secret @item secret
The member does not wish to disclose the membership. Secret memberships The member does not wish to disclose the membership. Secret memberships
and members are cleared before being returned to a person who is not a and members are cleared before being returned to a person who is not a
supervisor of the member or has sufficient privileges enabled. supervisor of the member or has sufficient privileges enabled.
@item passive-message-invert
If this bit is set, the @field{passive} bit is inverted when checking
for messages (@pxref{async-send-message}) to this conference. In
other words, messages are blocked if one (but not both) of the bits
@field{passive} and @field{passive-message-invert} are set.
@end table @end table
The remaining flags in the @type{Membership-Type} structure are reserved The remaining flags in the @type{Membership-Type} structure are reserved
...@@ -5548,8 +5558,15 @@ Person @rarg{pers-no} does not exist or is secret. ...@@ -5548,8 +5558,15 @@ Person @rarg{pers-no} does not exist or is secret.
@end example @end example
This call sends the message @rarg{message} to all members of This call sends the message @rarg{message} to all members of
@rarg{recipient} that are currently logged in. If @rarg{recipient} is @rarg{recipient} using @asynclink{async-send-message}. If
0, the message is sent to all sessions that are logged in. @rarg{recipient} is 0, the message is sent to all sessions that are
logged in.
The message is sent to all members of @rarg{recipient} that are
currently logged in, and where the @field{passive} and
@field{passive-message-invert} bits of the @type{Membership-Type}
(@pxref{Membership-Type}) don't prevent the message from being
delivered.
@reqexample @reqexample
@example @example
...@@ -5580,8 +5597,7 @@ Conference @rarg{recipient} does not exist or is secret. ...@@ -5580,8 +5597,7 @@ Conference @rarg{recipient} does not exist or is secret.
The message feature has been disabled in the server. The message feature has been disabled in the server.
@item message-not-sent @item message-not-sent
The message was not sent for some other reason. Perhaps the recipient is The message was not sent for some other reason. Perhaps the recipient is
not accepting messages or there are no viable recipients for a group not accepting messages or no member of the recipient was logged on.
message.
@end table @end table
...@@ -8342,6 +8358,8 @@ all logged-in members of that conference. If it is a mailbox then the ...@@ -8342,6 +8358,8 @@ all logged-in members of that conference. If it is a mailbox then the
message is personal and is only sent to members of the mailbox message is personal and is only sent to members of the mailbox
conference. conference.
The @field{passive} and @field{passive-message-invert} bits of the
membership influence if this message is sent. @xref{Membership-Type}.
@node async-logout @node async-logout
...@@ -8699,7 +8717,7 @@ server. @field{error-status} is undefined. ...@@ -8699,7 +8717,7 @@ server. @field{error-status} is undefined.
@item message-not-sent (53) @item message-not-sent (53)
Attempt to send an asynchronous message failed for some reason. Perhaps Attempt to send an asynchronous message failed for some reason. Perhaps
the recipient is not accepting messages at the moment or there are no the recipient is not accepting messages at the moment or there are no
viable recipients for a group message. viable members in the recipient of the message.
@field{error-status} is undefined. @field{error-status} is undefined.
@item invalid-membership-type (54) @item invalid-membership-type (54)
......
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