====== Ростер (контакт-лист) ======


===== 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.