From: Magnus H. <leg...@us...> - 2008-08-23 23:25:21
|
Update of /cvsroot/emacs-jabber/emacs-jabber In directory sc8-pr-cvs17.sourceforge.net:/tmp/cvs-serv6618 Modified Files: jabber.texi Log Message: Revision: ma...@fr...--2005/emacs-jabber--cvs-head--0--patch-560 Creator: Magnus Henoch <ma...@fr...> Manual: customizing the roster buffer Index: jabber.texi =================================================================== RCS file: /cvsroot/emacs-jabber/emacs-jabber/jabber.texi,v retrieving revision 1.115 retrieving revision 1.116 diff -u -d -r1.115 -r1.116 --- jabber.texi 23 Aug 2008 23:24:56 -0000 1.115 +++ jabber.texi 23 Aug 2008 23:25:17 -0000 1.116 @@ -1634,28 +1634,25 @@ @node Customizing the roster buffer, Customizing the chat buffer, Menu, Customization @section Customizing the roster buffer -@vindex jabber-roster-sort-functions -@vindex jabber-sort-order -@vindex jabber-show-resources -@vindex jabber-roster-line-format -@vindex jabber-resource-line-format -@vindex jabber-roster-buffer -@vindex jabber-roster-show-bindings @cindex Roster buffer, customizing @cindex Sorting the roster +@vindex jabber-roster-sort-functions @code{jabber-roster-sort-functions} controls how roster items are sorted. By default, contacts are sorted first by presence, and then alphabetically by displayed name. +@vindex jabber-sort-order @code{jabber-sort-order} controls how roster items are sorted by presence. It is a list containing strings corresponding to show status (@pxref{Presence}) or @code{nil}, which represents offline. +@vindex jabber-show-resources @code{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. +@vindex jabber-roster-line-format @code{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: @@ -1664,9 +1661,9 @@ @item %a Avatar of contact, if any @item %c -"*" if the contact is connected, or " " if not +@samp{*} if the contact is connected, or @samp{ } if not @item %u -Subscription state - see below +Subscription state---see below @item %n Nickname of contact, or JID if no nickname @item %j @@ -1674,27 +1671,30 @@ @item %r Highest-priority resource of contact @item %s -Availability of contact as string ("Online", "Away" etc) +Availability of contact as a string ("Online", "Away" etc) @item %S Status string specified by contact @end table +@code{%u} is replaced by one of the strings given by +`jabber-roster-subscription-display'. + +@vindex jabber-resource-line-format @code{jabber-resource-line-format} is nearly identical, except that the values correspond to the values of the resource in question, and that the @code{%p} escape is available, which inserts the priority of the resource. +@vindex jabber-roster-buffer @code{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. +If you change this, the new name will be used the next time the roster +is redisplayed. +@vindex jabber-roster-show-bindings @code{jabber-roster-show-bindings} controls whether to show a list of keybindings at the top of the roster buffer. You need to run @kbd{M-x jabber-display-roster} after changing this variable to update the display. -@code{%u} is replaced by one of the strings given by -`jabber-roster-subscription-display'. - @node Customizing the chat buffer, Customizing alerts, Customizing the roster buffer, Customization @section Customizing the chat buffer |