16.3 JID symbols

JIDs are sometimes represented as symbols. Its name is the JID, and it is interned in jabber-jid-obarray. A roster entry can have the following properties:

xml

The XML tag received from the server on roster update

name

The name of the roster item (just like the XML attribute)

subscription

The subscription state; a string, one of "none", "from", "to" and "both"

ask

The ask state; either nil or "subscribe"

groups

A list of strings (possibly empty) containing all the groups the contact is in

connected

Boolean, true if any resource is connected

show

Presence show value for highest-priority connected resource; a string, one of "" (i.e. online), "away", "xa", "dnd", "chat", "error" and nil (i.e. offline)

status

Presence status message for highest-priority connected resource

resources

Alist. Keys are strings (resource names), values are plists with properties connected, show, status and priority.

Incoming presence information is inserted in resources, and the information from the resource with the highest priority is inserted in show and status by the function jabber-prioritize-resources.