Variable: gnus-group-highlight

gnus-group-highlight is a customizable variable defined in gnus-group.el.gz.

Value

(((and mailp (= unread 0) (eq level 1)) . gnus-group-mail-1-empty)
 ((and mailp (eq level 1)) . gnus-group-mail-1)
 ((and mailp (= unread 0) (eq level 2)) . gnus-group-mail-2-empty)
 ((and mailp (eq level 2)) . gnus-group-mail-2)
 ((and mailp (= unread 0) (eq level 3)) . gnus-group-mail-3-empty)
 ((and mailp (eq level 3)) . gnus-group-mail-3)
 ((and mailp (= unread 0)) . gnus-group-mail-low-empty)
 ((and mailp) . gnus-group-mail-low)
 ((and (= unread 0) (eq level 1)) . gnus-group-news-1-empty)
 ((and (eq level 1)) . gnus-group-news-1)
 ((and (= unread 0) (eq level 2)) . gnus-group-news-2-empty)
 ((and (eq level 2)) . gnus-group-news-2)
 ((and (= unread 0) (eq level 3)) . gnus-group-news-3-empty)
 ((and (eq level 3)) . gnus-group-news-3)
 ((and (= unread 0) (eq level 4)) . gnus-group-news-4-empty)
 ((and (eq level 4)) . gnus-group-news-4)
 ((and (= unread 0) (eq level 5)) . gnus-group-news-5-empty)
 ((and (eq level 5)) . gnus-group-news-5)
 ((and (= unread 0) (eq level 6)) . gnus-group-news-6-empty)
 ((and (eq level 6)) . gnus-group-news-6)
 ((and (= unread 0)) . gnus-group-news-low-empty)
 (t . gnus-group-news-low))

Documentation

Controls the highlighting of group buffer lines.

Below is a list of Form/Face pairs. When deciding how a particular group line should be displayed, each form is evaluated. The content of the face field after the first true form is used. You can change how those group lines are displayed by editing the face field.

It is also possible to change and add form fields, but currently that requires an understanding of Lisp expressions. Hopefully this will change in a future release. For now, you can use the following variables in the Lisp expression:

group: The name of the group.
unread: The number of unread articles in the group.
method: The select method used.
total: The total number of articles in the group.
mailp: Whether it's a mail group or not.
level: The level of the group.
score: The score of the group.
ticked: The number of ticked articles.
group-age: Time in seconds since the group was last read
           (see info node (gnus)Group Timestamp).

Source Code

;; Defined in /usr/src/emacs/lisp/gnus/gnus-group.el.gz
(defcustom gnus-group-highlight
  '(;; Mail.
    ((and mailp (= unread 0) (eq level 1)) .
     gnus-group-mail-1-empty)
    ((and mailp (eq level 1)) .
     gnus-group-mail-1)
    ((and mailp (= unread 0) (eq level 2)) .
     gnus-group-mail-2-empty)
    ((and mailp (eq level 2)) .
     gnus-group-mail-2)
    ((and mailp (= unread 0) (eq level 3)) .
     gnus-group-mail-3-empty)
    ((and mailp (eq level 3)) .
     gnus-group-mail-3)
    ((and mailp (= unread 0)) .
     gnus-group-mail-low-empty)
    ((and mailp) .
     gnus-group-mail-low)
    ;; News.
    ((and (= unread 0) (eq level 1)) .
     gnus-group-news-1-empty)
    ((and (eq level 1)) .
     gnus-group-news-1)
    ((and (= unread 0) (eq level 2)) .
     gnus-group-news-2-empty)
    ((and (eq level 2)) .
     gnus-group-news-2)
    ((and (= unread 0) (eq level 3)) .
     gnus-group-news-3-empty)
    ((and (eq level 3)) .
     gnus-group-news-3)
    ((and (= unread 0) (eq level 4)) .
     gnus-group-news-4-empty)
    ((and (eq level 4)) .
     gnus-group-news-4)
    ((and (= unread 0) (eq level 5)) .
     gnus-group-news-5-empty)
    ((and (eq level 5)) .
     gnus-group-news-5)
    ((and (= unread 0) (eq level 6)) .
     gnus-group-news-6-empty)
    ((and (eq level 6)) .
     gnus-group-news-6)
    ((and (= unread 0)) .
     gnus-group-news-low-empty)
    (t .
     gnus-group-news-low))
  "Controls the highlighting of group buffer lines.

Below is a list of `Form'/`Face' pairs.  When deciding how a
particular group line should be displayed, each form is
evaluated.  The content of the face field after the first true form is
used.  You can change how those group lines are displayed by
editing the face field.

It is also possible to change and add form fields, but currently that
requires an understanding of Lisp expressions.  Hopefully this will
change in a future release.  For now, you can use the following
variables in the Lisp expression:

`group':     The name of the group.
`unread':    The number of unread articles in the group.
`method':    The select method used.
`total':     The total number of articles in the group.
`mailp':     Whether it's a mail group or not.
`level':     The level of the group.
`score':     The score of the group.
`ticked':    The number of ticked articles.
`group-age': Time in seconds since the group was last read
           (see info node `(gnus)Group Timestamp')."
  :group 'gnus-group-visual
  :type '(repeat (cons (sexp :tag "Form") face))
  :risky t)