1 ;;; gnus-spec.el --- format spec functions for Gnus
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
6 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
30 (unless (fboundp 'declare-function) (defmacro declare-function (&rest r))))
31 (eval-when-compile (require 'cl))
32 (defvar gnus-newsrc-file-version)
36 (defcustom gnus-use-correct-string-widths (featurep 'xemacs)
37 "*If non-nil, use correct functions for dealing with wide characters."
42 (defcustom gnus-make-format-preserve-properties (featurep 'xemacs)
43 "*If non-nil, use a replacement `format' function which preserves
44 text properties. This is only needed on XEmacs, as FSF Emacs does this anyway."
49 ;;; Internal variables.
51 (defvar gnus-summary-mark-positions nil)
52 (defvar gnus-group-mark-positions nil)
53 (defvar gnus-group-indentation "")
55 ;; Format specs. The chunks below are the machine-generated forms
56 ;; that are to be evaled as the result of the default format strings.
57 ;; We write them in here to get them byte-compiled. That way the
58 ;; default actions will be quite fast, while still retaining the full
59 ;; flexibility of the user-defined format specs.
61 ;; First we have lots of dummy defvars to let the compiler know these
62 ;; are really dynamic variables.
64 (defvar gnus-tmp-unread)
65 (defvar gnus-tmp-replied)
66 (defvar gnus-tmp-score-char)
67 (defvar gnus-tmp-indentation)
68 (defvar gnus-tmp-opening-bracket)
69 (defvar gnus-tmp-lines)
70 (defvar gnus-tmp-name)
71 (defvar gnus-tmp-closing-bracket)
72 (defvar gnus-tmp-subject-or-nil)
73 (defvar gnus-tmp-subject)
74 (defvar gnus-tmp-marked)
75 (defvar gnus-tmp-marked-mark)
76 (defvar gnus-tmp-subscribed)
77 (defvar gnus-tmp-process-marked)
78 (defvar gnus-tmp-number-of-unread)
79 (defvar gnus-tmp-group-name)
80 (defvar gnus-tmp-group)
81 (defvar gnus-tmp-article-number)
82 (defvar gnus-tmp-unread-and-unselected)
83 (defvar gnus-tmp-news-method)
84 (defvar gnus-tmp-news-server)
85 (defvar gnus-tmp-article-number)
86 (defvar gnus-mouse-face)
87 (defvar gnus-mouse-face-prop)
88 (defvar gnus-tmp-header)
89 (defvar gnus-tmp-from)
91 (declare-function gnus-summary-from-or-to-or-newsgroups "gnus-sum"
92 (header gnus-tmp-from))
94 (defun gnus-summary-line-format-spec ()
95 (insert gnus-tmp-unread gnus-tmp-replied
96 gnus-tmp-score-char gnus-tmp-indentation)
97 (gnus-put-text-property
101 (format "%c%4s: %-23s%c" gnus-tmp-opening-bracket gnus-tmp-lines
104 (gnus-summary-from-or-to-or-newsgroups
105 gnus-tmp-header gnus-tmp-from))))
106 (if (> (length val) 23)
109 gnus-tmp-closing-bracket))
111 gnus-mouse-face-prop gnus-mouse-face)
112 (insert " " gnus-tmp-subject-or-nil "\n"))
114 (defvar gnus-summary-line-format-spec
115 (gnus-byte-code 'gnus-summary-line-format-spec))
117 (defun gnus-summary-dummy-line-format-spec ()
119 (gnus-put-text-property
124 gnus-mouse-face-prop gnus-mouse-face)
125 (insert " " gnus-tmp-subject "\n"))
127 (defvar gnus-summary-dummy-line-format-spec
128 (gnus-byte-code 'gnus-summary-dummy-line-format-spec))
130 (defun gnus-group-line-format-spec ()
131 (insert gnus-tmp-marked-mark gnus-tmp-subscribed
132 gnus-tmp-process-marked
133 gnus-group-indentation
134 (format "%5s: " gnus-tmp-number-of-unread))
135 (gnus-put-text-property
138 (insert gnus-tmp-group "\n")
140 gnus-mouse-face-prop gnus-mouse-face))
141 (defvar gnus-group-line-format-spec
142 (gnus-byte-code 'gnus-group-line-format-spec))
144 (defvar gnus-format-specs
145 `((version . ,emacs-version)
146 (gnus-version . ,(gnus-continuum-version))
147 (group "%M\%S\%p\%P\%5y: %(%g%)\n" ,gnus-group-line-format-spec)
148 (summary-dummy "* %(: :%) %S\n"
149 ,gnus-summary-dummy-line-format-spec)
150 (summary "%U%R%z%I%(%[%4L: %-23,23f%]%) %s\n"
151 ,gnus-summary-line-format-spec))
152 "Alist of format specs.")
154 (defvar gnus-default-format-specs gnus-format-specs)
156 (defvar gnus-article-mode-line-format-spec nil)
157 (defvar gnus-summary-mode-line-format-spec nil)
158 (defvar gnus-group-mode-line-format-spec nil)
160 ;;; Phew. All that gruft is over with, fortunately.
163 (defun gnus-update-format (var)
164 "Update the format specification near point."
169 ;; Find the end of the current word.
170 (re-search-forward "[ \t\n]" nil t)
172 (when (re-search-backward "\\(gnus-[-a-z]+-line-format\\)" nil t)
174 (let* ((type (intern (progn (string-match "gnus-\\([-a-z]+\\)-line" var)
175 (match-string 1 var))))
176 (entry (assq type gnus-format-specs))
179 (setq gnus-format-specs (delq entry gnus-format-specs)))
181 (intern (format "%s-spec" var))
182 (gnus-parse-format (setq value (symbol-value (intern var)))
183 (symbol-value (intern (format "%s-alist" var)))
184 (not (string-match "mode" var))))
185 (setq spec (symbol-value (intern (format "%s-spec" var))))
186 (push (list type value spec) gnus-format-specs)
188 (pop-to-buffer "*Gnus Format*")
190 (lisp-interaction-mode)
191 (insert (gnus-pp-to-string spec))))
193 (defun gnus-update-format-specifications (&optional force &rest types)
194 "Update all (necessary) format specifications.
195 Return a list of updated types."
196 ;; Make the indentation array.
197 ;; See whether all the stored info needs to be flushed.
199 (not gnus-newsrc-file-version)
200 (not (equal (gnus-continuum-version)
201 (gnus-continuum-version gnus-newsrc-file-version)))
202 (not (equal emacs-version
203 (cdr (assq 'version gnus-format-specs)))))
204 (setq gnus-format-specs nil))
205 ;; Flush the group format spec cache if there's the grouplens stuff
206 ;; or it doesn't support decoded group names.
207 (when (memq 'group types)
208 (let* ((spec (assq 'group gnus-format-specs))
209 (sspec (gnus-prin1-to-string (nth 2 spec))))
210 (when (or (string-match " gnus-tmp-grouplens[ )]" sspec)
211 (not (string-match " gnus-tmp-decoded-group[ )]" sspec)))
212 (setq gnus-format-specs (delq spec gnus-format-specs)))))
214 ;; Go through all the formats and see whether they need updating.
215 (let (new-format entry type val updated)
216 (while (setq type (pop types))
217 ;; Jump to the proper buffer to find out the value of the
218 ;; variable, if possible. (It may be buffer-local.)
220 (let ((buffer (intern (format "gnus-%s-buffer" type))))
221 (when (and (boundp buffer)
222 (setq val (symbol-value buffer))
223 (gnus-buffer-exists-p val))
225 (setq new-format (symbol-value
226 (intern (format "gnus-%s-line-format" type)))))
227 (setq entry (cdr (assq type gnus-format-specs)))
229 (equal (car entry) new-format))
230 ;; Use the old format.
231 (set (intern (format "gnus-%s-line-format-spec" type))
233 ;; This is a new format.
235 (if (not (stringp new-format))
236 ;; This is a function call or something.
238 ;; This is a "real" format.
242 (intern (format "gnus-%s-line-format-alist" type)))
243 (not (string-match "mode$" (symbol-name type))))))
244 ;; Enter the new format spec into the list.
247 (setcar (cdr entry) val)
248 (setcar entry new-format))
249 (push (list type new-format val) gnus-format-specs))
250 (set (intern (format "gnus-%s-line-format-spec" type)) val)
251 (push type updated))))
253 (unless (assq 'version gnus-format-specs)
254 (push (cons 'version emacs-version) gnus-format-specs))
257 (defvar gnus-mouse-face-0 'highlight)
258 (defvar gnus-mouse-face-1 'highlight)
259 (defvar gnus-mouse-face-2 'highlight)
260 (defvar gnus-mouse-face-3 'highlight)
261 (defvar gnus-mouse-face-4 'highlight)
263 (defun gnus-mouse-face-function (form type)
264 `(gnus-put-text-property
265 (point) (progn ,@form (point))
269 `(quote ,(symbol-value (intern (format "gnus-mouse-face-%d" type)))))))
271 (defvar gnus-face-0 'bold)
272 (defvar gnus-face-1 'italic)
273 (defvar gnus-face-2 'bold-italic)
274 (defvar gnus-face-3 'bold)
275 (defvar gnus-face-4 'bold)
277 (defun gnus-face-face-function (form type)
278 `(gnus-add-text-properties
279 (point) (progn ,@form (point))
280 '(gnus-face t face ,(symbol-value (intern (format "gnus-face-%d" type))))))
282 (defun gnus-balloon-face-function (form type)
283 `(gnus-put-text-property
284 (point) (progn ,@form (point))
285 ,(if (fboundp 'balloon-help-mode)
288 ,(intern (format "gnus-balloon-face-%d" type))))
290 (defun gnus-spec-tab (column)
292 `(insert-char ? (max (- ,column (current-column)) 0))
293 (let ((column (abs column)))
294 `(if (> (current-column) ,column)
296 (if (= (move-to-column ,column) ,column)
297 (delete-region (point) end)
298 (delete-region (1- (point)) end)
300 (insert-char ? (max (- ,column (current-column)) 0))))))
302 (defun gnus-correct-length (string)
303 "Return the correct width of STRING."
304 (apply #'+ (mapcar #'char-width string)))
306 (defun gnus-correct-substring (string start &optional end)
311 (length (length string))
312 (string (concat string "\0")))
313 ;; Find the start position.
314 (while (and (< seek length)
316 (incf wseek (char-width (aref string seek)))
319 ;; Find the end position.
320 (while (and (<= seek length)
323 (incf wseek (char-width (aref string seek)))
326 (substring string wstart (1- wend))))
328 (defun gnus-string-width-function ()
330 (gnus-use-correct-string-widths
331 'gnus-correct-length)
332 ((fboundp 'string-width)
337 (defun gnus-substring-function ()
339 (gnus-use-correct-string-widths
340 'gnus-correct-substring)
341 ((fboundp 'string-width)
342 'gnus-correct-substring)
346 (defun gnus-tilde-max-form (el max-width)
347 "Return a form that limits EL to MAX-WIDTH."
348 (let ((max (abs max-width))
349 (length-fun (gnus-string-width-function))
350 (substring-fun (gnus-substring-function)))
352 `(if (> (,length-fun ,el) ,max)
354 `(,substring-fun ,el (- (,length-fun ,el) ,max))
355 `(,substring-fun ,el 0 ,max))
357 `(let ((val (eval ,el)))
358 (if (> (,length-fun val) ,max)
360 `(,substring-fun val (- (,length-fun val) ,max))
361 `(,substring-fun val 0 ,max))
364 (defun gnus-tilde-cut-form (el cut-width)
365 "Return a form that cuts CUT-WIDTH off of EL."
366 (let ((cut (abs cut-width))
367 (length-fun (gnus-string-width-function))
368 (substring-fun (gnus-substring-function)))
370 `(if (> (,length-fun ,el) ,cut)
372 `(,substring-fun ,el 0 (- (,length-fun ,el) ,cut))
373 `(,substring-fun ,el ,cut))
375 `(let ((val (eval ,el)))
376 (if (> (,length-fun val) ,cut)
378 `(,substring-fun val 0 (- (,length-fun val) ,cut))
379 `(,substring-fun val ,cut))
382 (defun gnus-tilde-ignore-form (el ignore-value)
383 "Return a form that is blank when EL is IGNORE-VALUE."
385 `(if (equal ,el ,ignore-value)
387 `(let ((val (eval ,el)))
388 (if (equal val ,ignore-value)
391 (defun gnus-pad-form (el pad-width)
392 "Return a form that pads EL to PAD-WIDTH accounting for multi-column
393 characters correctly. This is because `format' may pad to columns or to
394 characters when given a pad value."
395 (let ((pad (abs pad-width))
396 (side (< 0 pad-width))
397 (length-fun (gnus-string-width-function)))
399 `(let ((need (- ,pad (,length-fun ,el))))
401 (concat ,(when side '(make-string need ?\ ))
403 ,(when (not side) '(make-string need ?\ )))
405 `(let* ((val (eval ,el))
406 (need (- ,pad (,length-fun val))))
408 (concat ,(when side '(make-string need ?\ ))
410 ,(when (not side) '(make-string need ?\ )))
413 (defun gnus-parse-format (format spec-alist &optional insert)
414 ;; This function parses the FORMAT string with the help of the
415 ;; SPEC-ALIST and returns a list that can be eval'ed to return the
416 ;; string. If the FORMAT string contains the specifiers %( and %)