Next: , Previous: XML representation, Up: Hacking and extending



11.2 Roster structure

Roster entries are contained in the list *jabber-roster*.

A roster entry is a symbol. 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 (also copied)
ask
The ask state (copied)
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 status for highest-priority connected resource
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.