1 ;;; gnus-spec.el --- format spec functions for Gnus -*- coding: iso-latin-1 -*-
2 ;; Copyright (C) 1996, 1997, 1998, 1999, 2000
3 ;; Free Software Foundation, Inc.
5 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
6 ;; Katsumi Yamaoka <yamaoka@jpl.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 2, or (at your option)
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; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
30 (eval-when-compile (require 'cl))
35 (defcustom gnus-use-correct-string-widths t
36 "*If non-nil, use correct functions for dealing with wide characters."
40 ;;; Internal variables.
42 (defvar gnus-summary-mark-positions nil)
43 (defvar gnus-group-mark-positions nil)
44 (defvar gnus-group-indentation "")
46 ;; Format specs. The chunks below are the machine-generated forms
47 ;; that are to be evaled as the result of the default format strings.
48 ;; We write them in here to get them byte-compiled. That way the
49 ;; default actions will be quite fast, while still retaining the full
50 ;; flexibility of the user-defined format specs.
52 ;; First we have lots of dummy defvars to let the compiler know these
53 ;; are really dynamic variables.
55 (defvar gnus-tmp-unread)
56 (defvar gnus-tmp-replied)
57 (defvar gnus-tmp-score-char)
58 (defvar gnus-tmp-indentation)
59 (defvar gnus-tmp-opening-bracket)
60 (defvar gnus-tmp-lines)
61 (defvar gnus-tmp-name)
62 (defvar gnus-tmp-closing-bracket)
63 (defvar gnus-tmp-subject-or-nil)
64 (defvar gnus-tmp-subject)
65 (defvar gnus-tmp-marked)
66 (defvar gnus-tmp-marked-mark)
67 (defvar gnus-tmp-subscribed)
68 (defvar gnus-tmp-process-marked)
69 (defvar gnus-tmp-number-of-unread)
70 (defvar gnus-tmp-group-name)
71 (defvar gnus-tmp-group)
72 (defvar gnus-tmp-article-number)
73 (defvar gnus-tmp-unread-and-unselected)
74 (defvar gnus-tmp-news-method)
75 (defvar gnus-tmp-news-server)
76 (defvar gnus-tmp-article-number)
77 (defvar gnus-mouse-face)
78 (defvar gnus-mouse-face-prop)
80 (defun gnus-summary-line-format-spec ()
81 (insert gnus-tmp-unread gnus-tmp-replied
82 gnus-tmp-score-char gnus-tmp-indentation)
83 (gnus-put-text-property
87 gnus-tmp-opening-bracket
90 (if (> (length gnus-tmp-name) 20)
91 (substring gnus-tmp-name 0 20)
93 gnus-tmp-closing-bracket)
95 gnus-mouse-face-prop gnus-mouse-face)
96 (insert " " gnus-tmp-subject-or-nil "\n"))
98 (defvar gnus-summary-line-format-spec
99 (gnus-byte-code 'gnus-summary-line-format-spec))
101 (defun gnus-summary-dummy-line-format-spec ()
103 (gnus-put-text-property
108 gnus-mouse-face-prop gnus-mouse-face)
109 (insert " " gnus-tmp-subject "\n"))
111 (defvar gnus-summary-dummy-line-format-spec
112 (gnus-byte-code 'gnus-summary-dummy-line-format-spec))
114 (defun gnus-group-line-format-spec ()
115 (insert gnus-tmp-marked-mark gnus-tmp-subscribed
116 gnus-tmp-process-marked
117 gnus-group-indentation
118 (format "%5s: " gnus-tmp-number-of-unread))
119 (gnus-put-text-property
122 (insert gnus-tmp-group "\n")
124 gnus-mouse-face-prop gnus-mouse-face))
125 (defvar gnus-group-line-format-spec
126 (gnus-byte-code 'gnus-group-line-format-spec))
128 (defvar gnus-format-specs
129 `((group ("%M\%S\%p\%P\%5y: %(%g%)%l\n" ,gnus-group-line-format-spec))
130 (summary-dummy ("* %(: :%) %S\n"
131 ,gnus-summary-dummy-line-format-spec))
132 (summary ("%U\%R\%z\%I\%(%[%4L: %-23,23n%]%) %s\n"
133 ,gnus-summary-line-format-spec)))
134 "Alist of format specs.")
136 (defvar gnus-format-specs-compiled nil
137 "Alist of compiled format specs. Each element should be the form:
138 \(TYPE (FORMAT-STRING-1 . COMPILED-FUNCTION-1)
140 (FORMAT-STRING-n . COMPILED-FUNCTION-n)).")
142 (defvar gnus-article-mode-line-format-spec nil)
143 (defvar gnus-summary-mode-line-format-spec nil)
144 (defvar gnus-group-mode-line-format-spec nil)
146 ;;; Phew. All that gruft is over with, fortunately.
149 (defun gnus-update-format (var)
150 "Update the format specification near point."
155 ;; Find the end of the current word.
156 (re-search-forward "[ \t\n]" nil t)
158 (when (re-search-backward "\\(gnus-[-a-z]+-line-format\\)" nil t)
160 (let* ((type (intern (progn (string-match "gnus-\\([-a-z]+\\)-line" var)
161 (match-string 1 var))))
162 (value (symbol-value (intern var)))
164 (intern (format "%s-spec" var))
166 value (symbol-value (intern (format "%s-alist" var)))
167 (not (string-match "mode" var)))))
168 (entry (assq type gnus-format-specs)))
170 (let ((elem (assoc value entry)))
173 (setcdr entry (cons (cons value elem) (cdr entry)))))
174 (push (list type (cons value spec)) gnus-format-specs))
175 (gnus-product-variable-touch 'gnus-format-specs)
177 (pop-to-buffer "*Gnus Format*")
179 (lisp-interaction-mode)
180 (insert (pp-to-string spec))))
182 (put 'gnus-search-or-regist-spec 'lisp-indent-function 1)
183 (defmacro gnus-search-or-regist-spec (mspec &rest body)
184 (let ((specs (nth 0 mspec)) (type (nth 1 mspec)) (format (nth 2 mspec))
185 (spec (nth 3 mspec)) (entry (nth 4 mspec)) (elem (nth 5 mspec)))
186 `(let* ((,entry (assq ,type ,specs))
187 (,elem (assoc ,format (cdr ,entry))))
193 (setcdr ,entry (cons (cons ,format ,spec) (cdr ,entry))))
194 (push (list ,type (cons ,format ,spec)) ,specs))
195 (gnus-product-variable-touch (quote ,specs)))
198 (defun gnus-update-format-specification-1 (type format val)
199 (set (intern (format "gnus-%s-line-format-spec" type))
200 (gnus-search-or-regist-spec (gnus-format-specs-compiled
201 type format val entry elem)
202 (when (and gnus-compile-user-specs val)
205 (fset 'gnus-tmp-func `(lambda () ,val))
207 (let (byte-compile-warnings)
208 (byte-compile 'gnus-tmp-func))
209 (gnus-byte-code 'gnus-tmp-func))
210 (when (get-buffer "*Compile-Log*")
211 (bury-buffer "*Compile-Log*"))
212 (when (get-buffer "*Compile-Log-Show*")
213 (bury-buffer "*Compile-Log-Show*"))))))))
215 (defun gnus-update-format-specifications (&optional force &rest types)
216 "Update all (necessary) format specifications."
217 ;; Make the indentation array.
218 ;; See whether all the stored info needs to be flushed.
220 (message "%s" "Force update format specs.")
221 (setq gnus-format-specs nil
222 gnus-format-specs-compiled nil)
223 (gnus-product-variable-touch 'gnus-format-specs
224 'gnus-format-specs-compiled))
226 ;; Go through all the formats and see whether they need updating.
229 (while (setq type (pop types))
230 ;; Jump to the proper buffer to find out the value of
231 ;; the variable, if possible. (It may be buffer-local.)
233 (let ((buffer (intern (format "gnus-%s-buffer" type))))
234 (when (and (boundp buffer)
235 (setq val (symbol-value buffer))
236 (gnus-buffer-exists-p val))
239 (intern (format "gnus-%s-line-format" type))))))
240 (or (gnus-update-format-specification-1 type new-format nil)
241 ;; This is a new format.
242 (gnus-update-format-specification-1
244 (gnus-search-or-regist-spec (gnus-format-specs
245 type new-format val entry elem)
246 (setq val (if (stringp new-format)
247 ;; This is a "real" format.
251 (intern (format "gnus-%s-line-format-alist"
253 (not (string-match "mode$"
254 (symbol-name type))))
255 ;; This is a function call or something.
258 (defvar gnus-mouse-face-0 'highlight)
259 (defvar gnus-mouse-face-1 'highlight)
260 (defvar gnus-mouse-face-2 'highlight)
261 (defvar gnus-mouse-face-3 'highlight)
262 (defvar gnus-mouse-face-4 'highlight)
264 (defun gnus-mouse-face-function (form type)
265 `(gnus-put-text-property
266 (point) (progn ,@form (point))
270 `(quote ,(symbol-value (intern (format "gnus-mouse-face-%d" type)))))))
272 (defvar gnus-face-0 'bold)
273 (defvar gnus-face-1 'italic)
274 (defvar gnus-face-2 'bold-italic)
275 (defvar gnus-face-3 'bold)
276 (defvar gnus-face-4 'bold)
278 (defun gnus-face-face-function (form type)
279 `(gnus-add-text-properties
280 (point) (progn ,@form (point))
281 '(gnus-face t face ,(symbol-value (intern (format "gnus-face-%d" type))))))
283 ;;; Avoid byte-compile warning.
284 (defun gnus-tilde-pad-form (el pad-width)
285 "Dummy function except for XEmacs-mule. It will be redefined
286 by `gnus-xmas-redefine'."
287 (let ((val (if (symbolp el) (eval el) el)))
290 (defun gnus-balloon-face-function (form type)
291 `(gnus-put-text-property
292 (point) (progn ,@form (point))
294 ,(intern (format "gnus-balloon-face-%d" type))))
296 (defun gnus-spec-tab (column)
298 `(insert (make-string (max (- ,column (current-column)) 0) ? ))
300 (if (> (current-column) ,(abs column))
301 (delete-region (point)
302 (- (point) (- (current-column) ,(abs column))))
303 (insert (make-string (max (- ,(abs column) (current-column)) 0)
306 (defun gnus-correct-length (string)
307 "Return the correct width of STRING."
309 (mapcar (lambda (char) (incf length (gnus-char-width char))) string)
312 (defun gnus-correct-substring (string start end)
316 (length (length string)))
317 ;; Find the start position.
318 (while (and (< seek length)
320 (incf wstart (gnus-char-width (aref string seek)))
324 ;; Find the end position.
325 (while (and (< seek length)
327 (incf wend (gnus-char-width (aref string seek)))
330 (substring string wstart (1- wend))))
332 (defun gnus-tilde-max-form (el max-width)
333 "Return a form that limits EL to MAX-WIDTH."
334 (let ((max (abs max-width)))
336 `(if (> (,(if gnus-use-correct-string-widths
341 `(,(if gnus-use-correct-string-widths
342 'gnus-correct-substring
344 ,el (- (,(if gnus-use-correct-string-widths
348 `(,(if gnus-use-correct-string-widths
349 'gnus-correct-substring
353 `(let ((val (eval ,el)))
354 (if (> (,(if gnus-use-correct-string-widths
358 `(,(if gnus-use-correct-string-widths
359 'gnus-correct-substring
361 val (- (,(if gnus-use-correct-string-widths
364 `(,(if gnus-use-correct-string-widths
365 'gnus-correct-substring
370 (defun gnus-tilde-cut-form (el cut-width)
371 "Return a form that cuts CUT-WIDTH off of EL."
372 (let ((cut (abs cut-width)))
374 `(if (> (,(if gnus-use-correct-string-widths
378 `(,(if gnus-use-correct-string-widths
379 'gnus-correct-substring
381 (- (,(if gnus-use-correct-string-widths
384 `(,(if gnus-use-correct-string-widths
385 'gnus-correct-substring
386 'substring) ,el ,cut))
388 `(let ((val (eval ,el)))
389 (if (> (,(if gnus-use-correct-string-widths
393 `(,(if gnus-use-correct-string-widths
394 'gnus-correct-substring
396 (- (,(if gnus-use-correct-string-widths
399 `(,(if gnus-use-correct-string-widths
400 'gnus-correct-substring
401 'substring) val ,cut))
404 (defun gnus-tilde-ignore-form (el ignore-value)
405 "Return a form that is blank when EL is IGNORE-VALUE."
407 `(if (equal ,el ,ignore-value)
409 `(let ((val (eval ,el)))
410 (if (equal val ,ignore-value)
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 %)
417 ;; the text between them will have the mouse-face text property.
418 ;; If the FORMAT string contains the specifiers %[ and %], the text between
419 ;; them will have the balloon-help text property.
421 "\\`\\(.*\\)%[0-9]?[{(«]\\(.*\\)%[0-9]?[»})]\\(.*\n?\\)\\'"
423 (gnus-parse-complex-format format spec-alist)
424 ;; This is a simple format.
425 (gnus-parse-simple-format format spec-alist insert)))
427 (defun gnus-parse-complex-format (format spec-alist)
429 (gnus-set-work-buffer)
431 (goto-char (point-min))
432 (while (re-search-forward "\"" nil t)
433 (replace-match "\\\"" nil t))
434 (goto-char (point-min))
436 ;; Convert all font specs into font spec lists.
437 (while (re-search-forward "%\\([0-9]+\\)?\\([«»{}()]\\)" nil t)
438 (let ((number (if (match-beginning 1)
439 (match-string 1) "0"))
440 (delim (aref (match-string 2) 0)))
441 (if (or (= delim ?\()
444 (replace-match (concat "\"("
445 (cond ((= delim ?\() "mouse")
446 ((= delim ?\{) "face")
450 (replace-match "\")\""))))
451 (goto-char (point-max))
453 ;; Convert point position commands.
454 (goto-char (point-min))
455 (while (re-search-forward "%\\([-0-9]+\\)?C" nil t)
456 (replace-match "\"(point)\"" t t))
457 ;; Convert TAB commands.
458 (goto-char (point-min))
459 (while (re-search-forward "%\\([-0-9]+\\)=" nil t)
460 (replace-match (format "\"(tab %s)\"" (match-string 1)) t t))
461 ;; Convert the buffer into the spec.
462 (goto-char (point-min))
463 (let ((form (read (current-buffer))))
464 (cons 'progn (gnus-complex-form-to-spec form spec-alist)))))
466 (defun gnus-complex-form-to-spec (form spec-alist)
472 (gnus-parse-simple-format sform spec-alist t))
473 ((eq (car sform) 'point)
474 `(gnus-put-text-property (1- (point)) (point) 'gnus-position t))
475 ((eq (car sform) 'tab)
476 (gnus-spec-tab (cadr sform)))
478 (funcall (intern (format "gnus-%s-face-function" (car sform)))
479 (gnus-complex-form-to-spec (cddr sform) spec-alist)
483 (defun gnus-parse-simple-format (format spec-alist &optional insert)
484 ;; This function parses the FORMAT string with the help of the
485 ;; SPEC-ALIST and returns a list that can be eval'ed to return a
487 (let ((xemacs-mule-p (and (featurep 'xemacs) (featurep 'mule)))
489 spec flist fstring elem result dontinsert user-defined
490 type value pad-width spec-beg cut-width ignore-value
491 tilde-form tilde elem-type)
493 (gnus-set-work-buffer)
495 (goto-char (point-min))
496 (while (search-forward "%" nil t)
497 (setq user-defined nil
504 (setq spec-beg (1- (point)))
506 ;; Parse this spec fully.
509 ((looking-at "\\([-.0-9]+\\)\\(,[-0-9]+\\)?")
510 (setq pad-width (string-to-number (match-string 1)))
511 (when (match-beginning 2)
512 (setq max-width (string-to-number (buffer-substring
513 (1+ (match-beginning 2))
515 (goto-char (match-end 0)))
518 (setq tilde (read (current-buffer))
522 ((memq type '(pad pad-left))
523 (setq pad-width value))
524 ((eq type 'pad-right)
525 (setq pad-width (- value)))
526 ((memq type '(max-right max))
527 (setq max-width value))
529 (setq max-width (- value)))
530 ((memq type '(cut cut-left))
531 (setq cut-width value))
532 ((eq type 'cut-right)
533 (setq cut-width (- value)))
536 (if (stringp value) value (format "%s" value))))
538 (setq tilde-form value))
540 (error "Unknown tilde type: %s" tilde)))
544 ;; User-defined spec -- find the spec name.
545 (when (eq (setq spec (char-after)) ?u)
547 (setq user-defined (char-after)))
549 (delete-region spec-beg (point))
551 ;; Now we have all the relevant data on this spec, so
552 ;; we start doing stuff.
555 ;; "%%" just results in a "%".
560 (setq elem (list tilde-form ?s)))
561 ;; Treat user defined format specifiers specially.
565 (list (intern (format "gnus-user-format-function-%c"
569 ;; Find the specification from `spec-alist'.
570 ((setq elem (cdr (assq spec spec-alist))))
572 (setq elem '("*" ?s))))
573 (setq elem-type (cadr elem))
574 ;; Insert the new format elements.
575 (and pad-width (not xemacs-mule-p)
576 (insert (number-to-string pad-width)))
577 ;; Create the form to be evaled.
578 (if (or max-width cut-width ignore-value
579 (and pad-width xemacs-mule-p))
582 (let ((el (car elem)))
583 (cond ((= (cadr elem) ?c)
584 (setq el (list 'char-to-string el)))
586 (setq el (list 'int-to-string el))))
588 (setq el (gnus-tilde-ignore-form el ignore-value)))
590 (setq el (gnus-tilde-cut-form el cut-width)))
592 (setq el (gnus-tilde-max-form el max-width)))
593 (and pad-width xemacs-mule-p
594 (setq el (gnus-tilde-pad-form el pad-width)))
597 (push (car elem) flist))))
598 (setq fstring (buffer-string)))
600 ;; Do some postprocessing to increase efficiency.
605 ((string= fstring "")
607 ;; Not a format string.
608 ((not (string-match "%" fstring))
610 ;; A format string with just a single string spec.
611 ((string= fstring "%s")
613 ;; A single character.
614 ((string= fstring "%c")
617 ((string= fstring "%d")
620 (list `(princ ,(car flist)))
621 (list `(int-to-string ,(car flist)))))
622 ;; Just lots of chars and strings.
623 ((string-match "\\`\\(%[cs]\\)+\\'" fstring)
625 ;; A single string spec at the beginning of the spec.
626 ((string-match "\\`%[sc][^%]+\\'" fstring)
627 (list (car flist) (substring fstring 2)))
628 ;; A single string spec in the middle of the spec.
629 ((string-match "\\`\\([^%]+\\)%[sc]\\([^%]+\\)\\'" fstring)
630 (list (match-string 1 fstring) (car flist) (match-string 2 fstring)))
631 ;; A single string spec in the end of the spec.
632 ((string-match "\\`\\([^%]+\\)%[sc]\\'" fstring)
633 (list (match-string 1 fstring) (car flist)))
634 ;; A more complex spec.
636 (list (cons 'format (cons fstring (nreverse flist)))))))
642 (cons 'insert result)))
643 (cond ((stringp result)
646 (cons 'concat result))
649 (defun gnus-eval-format (format &optional alist props)
650 "Eval the format variable FORMAT, using ALIST.
651 If PROPS, insert the result."
652 (let ((form (gnus-parse-format format alist props)))
654 (gnus-add-text-properties (point) (progn (eval form) (point)) props)
657 (defun gnus-compile ()
658 "Byte-compile the user-defined format specs."
661 (let ((entries gnus-format-specs)
662 (byte-compile-warnings '(unresolved callargs redefine))
663 entry type compiled-function)
665 (gnus-message 7 "Compiling format specs...")
668 (setq entry (pop entries)
670 (if (memq type '(version gnus-version))
671 (setq gnus-format-specs (delq entry gnus-format-specs))
672 (let ((form (caddr entry)))
673 (when (and (listp form)
674 ;; Under GNU Emacs, it's (byte-code ...)
675 (not (eq 'byte-code (car form)))
676 ;; Under XEmacs, it's (funcall #<compiled-function ...>)
677 (not (and (eq 'funcall (car form))
678 (byte-code-function-p (cadr form)))))
679 (defalias 'gnus-tmp-func `(lambda () ,form))
680 (byte-compile 'gnus-tmp-func)
681 (setq compiled-function (gnus-byte-code 'gnus-tmp-func))
682 (set (intern (format "gnus-%s-line-format-spec" type))
684 (let ((elem (cdr (assq type gnus-format-specs-compiled))))
686 (set-alist 'elem (cadr entry) compiled-function)
687 (setq elem (list (cadr entry) compiled-function)))
688 (set-alist 'gnus-format-specs-compiled type elem))))))
690 (push (cons 'version emacs-version) gnus-format-specs)
691 (gnus-message 7 "Compiling user specs...done"))))
693 (defun gnus-set-format (type &optional insertable)
694 (set (intern (format "gnus-%s-line-format-spec" type))
696 (symbol-value (intern (format "gnus-%s-line-format" type)))
697 (symbol-value (intern (format "gnus-%s-line-format-alist" type)))
705 ;; coding: iso-8859-1
708 ;;; gnus-spec.el ends here