Next: , Previous: Connection settings, Up: Customization



10.2 Customizing the roster buffer

jabber-sort-order controls how roster items are sorted by presence. It is a list containing strings corresponding to show status (see Presence) or nil, which represents offline.

jabber-show-resources controls when your contacts' resources are shown in the roster buffer. The default is to show resources when a contact has more than one connected resource.

jabber-roster-line-format specifies how the entry for each contact looks. It is a string where some characters are special if preceded by a percent sign:

jabber-roster-buffer specifies the name of the roster buffer. If you change this, the new name will be used the next time you connect.

%c
"*" if the contact is connected, or " " if not
%n
Nickname of contact, or JID if no nickname
%j
Bare JID of contact (without resource)
%r
Highest-priority resource of contact
%s
Availability of contact as string ("Online", "Away" etc)
%S
Status string specified by contact

jabber-resource-line-format is nearly identical, except that the values correspond to the values of the resource in question, and that the %p escape is available, which inserts the priority of the resource.