15.3 Customizing the roster buffer

jabber-roster-sort-functions controls how roster items are sorted. By default, contacts are sorted first by presence, and then alphabetically by displayed name.

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:

%a

Avatar of contact, if any

%c

‘*’ if the contact is connected, or ‘ ’ if not

%u

Subscription state—see below

%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 a string ("Online", "Away" etc)

%S

Status string specified by contact

jabber-roster-show-title controls whether to show a "Jabber roster" string at the top of the roster buffer. You need to run M-x jabber-display-roster after changing this variable to update the display.

%u is replaced by one of the strings given by `jabber-roster-subscription-display'.

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.

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

jabber-roster-show-bindings controls whether to show a list of keybindings at the top of the roster buffer. You need to run M-x jabber-display-roster after changing this variable to update the display.