Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-615
[bpt/emacs.git] / lisp / gnus / gnus-cite.el
CommitLineData
23f87bed 1;;; gnus-cite.el --- parse citations in articles for Gnus
eec82323 2
23f87bed 3;; Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
16409b0b
GM
4;; Free Software Foundation, Inc.
5
6;; Author: Per Abhiddenware
7
8;; This file is part of GNU Emacs.
9
10;; GNU Emacs is free software; you can redistribute it and/or modify
eec82323
LMI
11;; it under the terms of the GNU General Public License as published by
12;; the Free Software Foundation; either version 2, or (at your option)
13;; any later version.
14
15;; GNU Emacs is distributed in the hope that it will be useful,
16;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18;; GNU General Public License for more details.
19
20;; You should have received a copy of the GNU General Public License
21;; along with GNU Emacs; see the file COPYING. If not, write to the
22;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23;; Boston, MA 02111-1307, USA.
24
25;;; Commentary:
26
27;;; Code:
28
5ab7173c
RS
29(eval-when-compile (require 'cl))
30
eec82323 31(require 'gnus)
eec82323 32(require 'gnus-range)
23f87bed
MB
33(require 'gnus-art)
34(require 'message) ; for message-cite-prefix-regexp
eec82323
LMI
35
36;;; Customization:
37
38(defgroup gnus-cite nil
39 "Citation."
40 :prefix "gnus-cite-"
41 :link '(custom-manual "(gnus)Article Highlighting")
42 :group 'gnus-article)
43
6748645f
LMI
44(defcustom gnus-cited-opened-text-button-line-format "%(%{[-]%}%)\n"
45 "Format of opened cited text buttons."
46 :group 'gnus-cite
47 :type 'string)
48
49(defcustom gnus-cited-closed-text-button-line-format "%(%{[+]%}%)\n"
50 "Format of closed cited text buttons."
eec82323
LMI
51 :group 'gnus-cite
52 :type 'string)
53
54(defcustom gnus-cited-lines-visible nil
16409b0b
GM
55 "The number of lines of hidden cited text to remain visible.
56Or a pair (cons) of numbers which are the number of lines at the top
57and bottom of the text, respectively, to remain visible."
eec82323
LMI
58 :group 'gnus-cite
59 :type '(choice (const :tag "none" nil)
16409b0b
GM
60 integer
61 (cons :tag "Top and Bottom" integer integer)))
eec82323
LMI
62
63(defcustom gnus-cite-parse-max-size 25000
64 "Maximum article size (in bytes) where parsing citations is allowed.
65Set it to nil to parse all articles."
66 :group 'gnus-cite
67 :type '(choice (const :tag "all" nil)
68 integer))
69
eec82323
LMI
70(defcustom gnus-cite-max-prefix 20
71 "Maximum possible length for a citation prefix."
72 :group 'gnus-cite
73 :type 'integer)
74
75(defcustom gnus-supercite-regexp
23f87bed 76 (concat "^\\(" message-cite-prefix-regexp "\\)? *"
eec82323 77 ">>>>> +\"\\([^\"\n]+\\)\" +==")
6748645f 78 "*Regexp matching normal Supercite attribution lines.
eec82323
LMI
79The first grouping must match prefixes added by other packages."
80 :group 'gnus-cite
81 :type 'regexp)
82
83(defcustom gnus-supercite-secondary-regexp "^.*\"\\([^\"\n]+\\)\" +=="
84 "Regexp matching mangled Supercite attribution lines.
85The first regexp group should match the Supercite attribution."
86 :group 'gnus-cite
87 :type 'regexp)
88
89(defcustom gnus-cite-minimum-match-count 2
90 "Minimum number of identical prefixes before we believe it's a citation."
91 :group 'gnus-cite
92 :type 'integer)
93
23f87bed
MB
94;; Some Microsoft products put in a citation that extends to the
95;; remainder of the message:
96;;
97;; -----Original Message-----
98;; From: ...
99;; To: ...
100;; Sent: ... [date, in non-RFC-2822 format]
101;; Subject: ...
102;;
103;; Cited message, with no prefixes
104;;
105;; The four headers are always the same. But note they are prone to
106;; folding without additional indentation.
107;;
108;; Others use "----- Original Message -----" instead, and properly quote
109;; the body using "> ". This style is handled without special cases.
110
6748645f 111(defcustom gnus-cite-attribution-prefix
23f87bed 112 "In article\\|in <\\|On \\(Mon\\|Tue\\|Wed\\|Thu\\|Fri\\|Sat\\|Sun\\),\\|----- ?Original Message ?-----"
6748645f 113 "*Regexp matching the beginning of an attribution line."
eec82323
LMI
114 :group 'gnus-cite
115 :type 'regexp)
116
117(defcustom gnus-cite-attribution-suffix
23f87bed 118 "\\(\\(wrote\\|writes\\|said\\|says\\|>\\)\\(:\\|\\.\\.\\.\\)\\|----- ?Original Message ?-----\\)[ \t]*$"
6748645f 119 "*Regexp matching the end of an attribution line.
eec82323
LMI
120The text matching the first grouping will be used as a button."
121 :group 'gnus-cite
122 :type 'regexp)
123
23f87bed
MB
124(defcustom gnus-cite-unsightly-citation-regexp
125 "^-----Original Message-----\nFrom: \\(.+\n\\)+\n"
126 "Regexp matching Microsoft-type rest-of-message citations."
127 :group 'gnus-cite
128 :type 'regexp)
129
130(defcustom gnus-cite-ignore-quoted-from t
131 "Non-nil means don't regard lines beginning with \">From \" as cited text.
132Those lines may have been quoted by MTAs in order not to mix up with
133the envelope From line."
134 :group 'gnus-cite
135 :type 'boolean)
136
eec82323 137(defface gnus-cite-attribution-face '((t
23f87bed 138 (:italic t)))
eec82323
LMI
139 "Face used for attribution lines.")
140
141(defcustom gnus-cite-attribution-face 'gnus-cite-attribution-face
142 "Face used for attribution lines.
143It is merged with the face for the cited text belonging to the attribution."
144 :group 'gnus-cite
145 :type 'face)
146
147(defface gnus-cite-face-1 '((((class color)
148 (background dark))
149 (:foreground "light blue"))
150 (((class color)
151 (background light))
152 (:foreground "MidnightBlue"))
153 (t
23f87bed 154 (:italic t)))
eec82323
LMI
155 "Citation face.")
156
157(defface gnus-cite-face-2 '((((class color)
158 (background dark))
159 (:foreground "light cyan"))
160 (((class color)
161 (background light))
162 (:foreground "firebrick"))
163 (t
23f87bed 164 (:italic t)))
eec82323
LMI
165 "Citation face.")
166
167(defface gnus-cite-face-3 '((((class color)
168 (background dark))
169 (:foreground "light yellow"))
170 (((class color)
171 (background light))
172 (:foreground "dark green"))
173 (t
23f87bed 174 (:italic t)))
eec82323
LMI
175 "Citation face.")
176
177(defface gnus-cite-face-4 '((((class color)
178 (background dark))
179 (:foreground "light pink"))
180 (((class color)
181 (background light))
182 (:foreground "OrangeRed"))
183 (t
23f87bed 184 (:italic t)))
eec82323
LMI
185 "Citation face.")
186
187(defface gnus-cite-face-5 '((((class color)
188 (background dark))
189 (:foreground "pale green"))
190 (((class color)
191 (background light))
192 (:foreground "dark khaki"))
193 (t
23f87bed 194 (:italic t)))
eec82323
LMI
195 "Citation face.")
196
197(defface gnus-cite-face-6 '((((class color)
198 (background dark))
199 (:foreground "beige"))
200 (((class color)
201 (background light))
202 (:foreground "dark violet"))
203 (t
23f87bed 204 (:italic t)))
eec82323
LMI
205 "Citation face.")
206
207(defface gnus-cite-face-7 '((((class color)
208 (background dark))
209 (:foreground "orange"))
210 (((class color)
211 (background light))
212 (:foreground "SteelBlue4"))
213 (t
23f87bed 214 (:italic t)))
eec82323
LMI
215 "Citation face.")
216
217(defface gnus-cite-face-8 '((((class color)
218 (background dark))
219 (:foreground "magenta"))
220 (((class color)
221 (background light))
222 (:foreground "magenta"))
223 (t
23f87bed 224 (:italic t)))
eec82323
LMI
225 "Citation face.")
226
227(defface gnus-cite-face-9 '((((class color)
228 (background dark))
229 (:foreground "violet"))
230 (((class color)
231 (background light))
232 (:foreground "violet"))
233 (t
23f87bed 234 (:italic t)))
eec82323
LMI
235 "Citation face.")
236
237(defface gnus-cite-face-10 '((((class color)
238 (background dark))
239 (:foreground "medium purple"))
240 (((class color)
241 (background light))
242 (:foreground "medium purple"))
243 (t
23f87bed 244 (:italic t)))
eec82323
LMI
245 "Citation face.")
246
247(defface gnus-cite-face-11 '((((class color)
248 (background dark))
249 (:foreground "turquoise"))
250 (((class color)
251 (background light))
252 (:foreground "turquoise"))
253 (t
23f87bed 254 (:italic t)))
eec82323
LMI
255 "Citation face.")
256
257(defcustom gnus-cite-face-list
258 '(gnus-cite-face-1 gnus-cite-face-2 gnus-cite-face-3 gnus-cite-face-4
16409b0b
GM
259 gnus-cite-face-5 gnus-cite-face-6 gnus-cite-face-7 gnus-cite-face-8
260 gnus-cite-face-9 gnus-cite-face-10 gnus-cite-face-11)
6748645f 261 "*List of faces used for highlighting citations.
eec82323
LMI
262
263When there are citations from multiple articles in the same message,
264Gnus will try to give each citation from each article its own face.
265This should make it easier to see who wrote what."
266 :group 'gnus-cite
267 :type '(repeat face))
268
269(defcustom gnus-cite-hide-percentage 50
270 "Only hide excess citation if above this percentage of the body."
271 :group 'gnus-cite
272 :type 'number)
273
274(defcustom gnus-cite-hide-absolute 10
275 "Only hide excess citation if above this number of lines in the body."
276 :group 'gnus-cite
277 :type 'integer)
278
eb1666e2
MB
279(defcustom gnus-cite-blank-line-after-header t
280 "If non-nil, put a blank line between the citation header and the button."
a08b59c9 281 :version "21.4"
eb1666e2
MB
282 :group 'gnus-cite
283 :type 'boolean)
284
23f87bed
MB
285;; This has to go here because its default value depends on
286;; gnus-cite-face-list.
287(defcustom gnus-article-boring-faces (cons 'gnus-signature-face
288 gnus-cite-face-list)
289 "List of faces that are not worth reading.
290If an article has more pages below the one you are looking at, but
291nothing on those pages is a word of at least three letters that is not
292in a boring face, then the pages will be skipped."
a08b59c9 293 :version "21.4"
23f87bed
MB
294 :type '(repeat face)
295 :group 'gnus-article-hiding)
296
eec82323
LMI
297;;; Internal Variables:
298
299(defvar gnus-cite-article nil)
6748645f 300(defvar gnus-cite-overlay-list nil)
eec82323
LMI
301
302(defvar gnus-cite-prefix-alist nil)
303;; Alist of citation prefixes.
304;; The cdr is a list of lines with that prefix.
305
306(defvar gnus-cite-attribution-alist nil)
307;; Alist of attribution lines.
308;; The car is a line number.
309;; The cdr is the prefix for the citation started by that line.
310
311(defvar gnus-cite-loose-prefix-alist nil)
312;; Alist of citation prefixes that have no matching attribution.
313;; The cdr is a list of lines with that prefix.
314
315(defvar gnus-cite-loose-attribution-alist nil)
316;; Alist of attribution lines that have no matching citation.
317;; Each member has the form (WROTE IN PREFIX TAG), where
318;; WROTE: is the attribution line number
319;; IN: is the line number of the previous line if part of the same attribution,
320;; PREFIX: Is the citation prefix of the attribution line(s), and
321;; TAG: Is a Supercite tag, if any.
322
6748645f 323(defvar gnus-cited-opened-text-button-line-format-alist
eec82323
LMI
324 `((?b (marker-position beg) ?d)
325 (?e (marker-position end) ?d)
6748645f 326 (?n (count-lines beg end) ?d)
eec82323 327 (?l (- end beg) ?d)))
6748645f
LMI
328(defvar gnus-cited-opened-text-button-line-format-spec nil)
329(defvar gnus-cited-closed-text-button-line-format-alist
330 gnus-cited-opened-text-button-line-format-alist)
331(defvar gnus-cited-closed-text-button-line-format-spec nil)
332
eec82323
LMI
333
334;;; Commands:
335
336(defun gnus-article-highlight-citation (&optional force)
337 "Highlight cited text.
338Each citation in the article will be highlighted with a different face.
339The faces are taken from `gnus-cite-face-list'.
340Attribution lines are highlighted with the same face as the
341corresponding citation merged with `gnus-cite-attribution-face'.
342
343Text is considered cited if at least `gnus-cite-minimum-match-count'
23f87bed 344lines matches `message-cite-prefix-regexp' with the same prefix.
eec82323
LMI
345
346Lines matching `gnus-cite-attribution-suffix' and perhaps
347`gnus-cite-attribution-prefix' are considered attribution lines."
348 (interactive (list 'force))
349 (save-excursion
350 (set-buffer gnus-article-buffer)
351 (gnus-cite-parse-maybe force)
352 (let ((buffer-read-only nil)
353 (alist gnus-cite-prefix-alist)
354 (faces gnus-cite-face-list)
355 (inhibit-point-motion-hooks t)
356 face entry prefix skip numbers number face-alist)
357 ;; Loop through citation prefixes.
358 (while alist
359 (setq entry (car alist)
360 alist (cdr alist)
361 prefix (car entry)
362 numbers (cdr entry)
363 face (car faces)
364 faces (or (cdr faces) gnus-cite-face-list)
365 face-alist (cons (cons prefix face) face-alist))
366 (while numbers
367 (setq number (car numbers)
368 numbers (cdr numbers))
369 (and (not (assq number gnus-cite-attribution-alist))
370 (not (assq number gnus-cite-loose-attribution-alist))
371 (gnus-cite-add-face number prefix face))))
372 ;; Loop through attribution lines.
373 (setq alist gnus-cite-attribution-alist)
374 (while alist
375 (setq entry (car alist)
376 alist (cdr alist)
377 number (car entry)
378 prefix (cdr entry)
379 skip (gnus-cite-find-prefix number)
380 face (cdr (assoc prefix face-alist)))
381 ;; Add attribution button.
16409b0b
GM
382 (goto-char (point-min))
383 (forward-line (1- number))
eec82323 384 (when (re-search-forward gnus-cite-attribution-suffix
23f87bed 385 (gnus-point-at-eol)
eec82323
LMI
386 t)
387 (gnus-article-add-button (match-beginning 1) (match-end 1)
388 'gnus-cite-toggle prefix))
389 ;; Highlight attribution line.
390 (gnus-cite-add-face number skip face)
391 (gnus-cite-add-face number skip gnus-cite-attribution-face))
392 ;; Loop through attribution lines.
393 (setq alist gnus-cite-loose-attribution-alist)
394 (while alist
395 (setq entry (car alist)
396 alist (cdr alist)
397 number (car entry)
398 skip (gnus-cite-find-prefix number))
399 (gnus-cite-add-face number skip gnus-cite-attribution-face)))))
400
401(defun gnus-dissect-cited-text ()
402 "Dissect the article buffer looking for cited text."
403 (save-excursion
404 (set-buffer gnus-article-buffer)
16409b0b 405 (gnus-cite-parse-maybe nil t)
eec82323
LMI
406 (let ((alist gnus-cite-prefix-alist)
407 prefix numbers number marks m)
408 ;; Loop through citation prefixes.
409 (while alist
410 (setq numbers (pop alist)
411 prefix (pop numbers))
412 (while numbers
413 (setq number (pop numbers))
414 (goto-char (point-min))
415 (forward-line number)
416 (push (cons (point-marker) "") marks)
417 (while (and numbers
418 (= (1- number) (car numbers)))
419 (setq number (pop numbers)))
420 (goto-char (point-min))
421 (forward-line (1- number))
422 (push (cons (point-marker) prefix) marks)))
423 ;; Skip to the beginning of the body.
16409b0b 424 (article-goto-body)
eec82323
LMI
425 (push (cons (point-marker) "") marks)
426 ;; Find the end of the body.
427 (goto-char (point-max))
428 (gnus-article-search-signature)
429 (push (cons (point-marker) "") marks)
430 ;; Sort the marks.
6748645f 431 (setq marks (sort marks 'car-less-than-car))
eec82323
LMI
432 (let ((omarks marks))
433 (setq marks nil)
434 (while (cdr omarks)
435 (if (= (caar omarks) (caadr omarks))
436 (progn
437 (unless (equal (cdar omarks) "")
438 (push (car omarks) marks))
439 (unless (equal (cdadr omarks) "")
440 (push (cadr omarks) marks))
441 (unless (and (equal (cdar omarks) "")
442 (equal (cdadr omarks) "")
443 (not (cddr omarks)))
444 (setq omarks (cdr omarks))))
445 (push (car omarks) marks))
446 (setq omarks (cdr omarks)))
447 (when (car omarks)
448 (push (car omarks) marks))
449 (setq marks (setq m (nreverse marks)))
450 (while (cddr m)
451 (if (and (equal (cdadr m) "")
452 (equal (cdar m) (cdaddr m))
453 (goto-char (caadr m))
454 (forward-line 1)
455 (= (point) (caaddr m)))
456 (setcdr m (cdddr m))
457 (setq m (cdr m))))
458 marks))))
459
460(defun gnus-article-fill-cited-article (&optional force width)
461 "Do word wrapping in the current article.
462If WIDTH (the numerical prefix), use that text width when filling."
463 (interactive (list t current-prefix-arg))
464 (save-excursion
465 (set-buffer gnus-article-buffer)
466 (let ((buffer-read-only nil)
467 (inhibit-point-motion-hooks t)
468 (marks (gnus-dissect-cited-text))
469 (adaptive-fill-mode nil)
470 (filladapt-mode nil)
471 (fill-column (if width (prefix-numeric-value width) fill-column)))
472 (save-restriction
473 (while (cdr marks)
eec82323
LMI
474 (narrow-to-region (caar marks) (caadr marks))
475 (let ((adaptive-fill-regexp
476 (concat "^" (regexp-quote (cdar marks)) " *"))
23f87bed
MB
477 (fill-prefix
478 (if (string= (cdar marks) "") ""
479 (concat (cdar marks) " ")))
480 use-hard-newlines)
eec82323
LMI
481 (fill-region (point-min) (point-max)))
482 (set-marker (caar marks) nil)
483 (setq marks (cdr marks)))
484 (when marks
485 (set-marker (caar marks) nil))
486 ;; All this information is now incorrect.
487 (setq gnus-cite-prefix-alist nil
488 gnus-cite-attribution-alist nil
489 gnus-cite-loose-prefix-alist nil
a8151ef7
LMI
490 gnus-cite-loose-attribution-alist nil
491 gnus-cite-article nil)))))
eec82323
LMI
492
493(defun gnus-article-hide-citation (&optional arg force)
494 "Toggle hiding of all cited text except attribution lines.
495See the documentation for `gnus-article-highlight-citation'.
496If given a negative prefix, always show; if given a positive prefix,
497always hide."
498 (interactive (append (gnus-article-hidden-arg) (list 'force)))
6748645f
LMI
499 (gnus-set-format 'cited-opened-text-button t)
500 (gnus-set-format 'cited-closed-text-button t)
eec82323
LMI
501 (save-excursion
502 (set-buffer gnus-article-buffer)
eec82323 503 (let ((buffer-read-only nil)
520aa572 504 marks
eec82323
LMI
505 (inhibit-point-motion-hooks t)
506 (props (nconc (list 'article-type 'cite)
507 gnus-hidden-properties))
520aa572
SZ
508 (point (point-min))
509 found beg end start)
a1506d29
JB
510 (while (setq point
511 (text-property-any point (point-max)
520aa572
SZ
512 'gnus-callback
513 'gnus-article-toggle-cited-text))
514 (setq found t)
515 (goto-char point)
516 (gnus-article-toggle-cited-text
517 (get-text-property point 'gnus-data) arg)
518 (forward-line 1)
519 (setq point (point)))
520 (unless found
521 (setq marks (gnus-dissect-cited-text))
522 (while marks
523 (setq beg nil
524 end nil)
525 (while (and marks (string= (cdar marks) ""))
526 (setq marks (cdr marks)))
527 (when marks
528 (setq beg (caar marks)))
529 (while (and marks (not (string= (cdar marks) "")))
530 (setq marks (cdr marks)))
531 (when marks
eec82323 532 (setq end (caar marks)))
520aa572
SZ
533 ;; Skip past lines we want to leave visible.
534 (when (and beg end gnus-cited-lines-visible)
535 (goto-char beg)
536 (forward-line (if (consp gnus-cited-lines-visible)
537 (car gnus-cited-lines-visible)
538 gnus-cited-lines-visible))
539 (if (>= (point) end)
540 (setq beg nil)
541 (setq beg (point-marker))
542 (when (consp gnus-cited-lines-visible)
543 (goto-char end)
544 (forward-line (- (cdr gnus-cited-lines-visible)))
545 (if (<= (point) beg)
546 (setq beg nil)
16409b0b 547 (setq end (point-marker))))))
520aa572 548 (when (and beg end)
23f87bed 549 (gnus-add-wash-type 'cite)
520aa572
SZ
550 ;; We use markers for the end-points to facilitate later
551 ;; wrapping and mangling of text.
552 (setq beg (set-marker (make-marker) beg)
553 end (set-marker (make-marker) end))
554 (gnus-add-text-properties-when 'article-type nil beg end props)
555 (goto-char beg)
eb1666e2
MB
556 (when (and gnus-cite-blank-line-after-header
557 (not (save-excursion (search-backward "\n\n" nil t))))
520aa572
SZ
558 (insert "\n"))
559 (put-text-property
560 (setq start (point-marker))
561 (progn
eec82323
LMI
562 (gnus-article-add-button
563 (point)
6748645f
LMI
564 (progn (eval gnus-cited-closed-text-button-line-format-spec)
565 (point))
566 `gnus-article-toggle-cited-text
567 (list (cons beg end) start))
eec82323 568 (point))
520aa572
SZ
569 'article-type 'annotation)
570 (set-marker beg (point))))))))
eec82323 571
520aa572
SZ
572(defun gnus-article-toggle-cited-text (args &optional arg)
573 "Toggle hiding the text in REGION.
574ARG can be nil or a number. Positive means hide, negative
575means show, nil means toggle."
6748645f 576 (let* ((region (car args))
16409b0b
GM
577 (beg (car region))
578 (end (cdr region))
6748645f
LMI
579 (start (cadr args))
580 (hidden
520aa572 581 (text-property-any beg (1- end) 'article-type 'cite))
6748645f
LMI
582 (inhibit-point-motion-hooks t)
583 buffer-read-only)
520aa572
SZ
584 (when (or (null arg)
585 (zerop arg)
586 (and (> arg 0) (not hidden))
587 (and (< arg 0) hidden))
588 (if hidden
23f87bed
MB
589 (progn
590 ;; Can't remove 'cite from g-a-wash-types here because
591 ;; multiple citations may be hidden -jas
592 (gnus-remove-text-properties-when
593 'article-type 'cite beg end
594 (cons 'article-type (cons 'cite
595 gnus-hidden-properties))))
596 (gnus-add-wash-type 'cite)
520aa572 597 (gnus-add-text-properties-when
a1506d29 598 'article-type nil beg end
520aa572
SZ
599 (cons 'article-type (cons 'cite
600 gnus-hidden-properties))))
23f87bed
MB
601 (let ((gnus-article-mime-handle-alist-1 gnus-article-mime-handle-alist))
602 (gnus-set-mode-line 'article))
520aa572
SZ
603 (save-excursion
604 (goto-char start)
605 (gnus-delete-line)
606 (put-text-property
607 (point)
608 (progn
609 (gnus-article-add-button
610 (point)
611 (progn (eval
612 (if hidden
613 gnus-cited-opened-text-button-line-format-spec
614 gnus-cited-closed-text-button-line-format-spec))
615 (point))
616 `gnus-article-toggle-cited-text
617 args)
618 (point))
619 'article-type 'annotation)))))
eec82323
LMI
620
621(defun gnus-article-hide-citation-maybe (&optional arg force)
622 "Toggle hiding of cited text that has an attribution line.
623If given a negative prefix, always show; if given a positive prefix,
624always hide.
625This will do nothing unless at least `gnus-cite-hide-percentage'
626percent and at least `gnus-cite-hide-absolute' lines of the body is
627cited text with attributions. When called interactively, these two
628variables are ignored.
629See also the documentation for `gnus-article-highlight-citation'."
6748645f 630 (interactive (append (gnus-article-hidden-arg) '(force)))
23f87bed
MB
631 (with-current-buffer gnus-article-buffer
632 (gnus-delete-wash-type 'cite)
633 (unless (gnus-article-check-hidden-text 'cite arg)
634 (save-excursion
635 (gnus-cite-parse-maybe force)
636 (article-goto-body)
637 (let ((start (point))
638 (atts gnus-cite-attribution-alist)
639 (buffer-read-only nil)
640 (inhibit-point-motion-hooks t)
641 (hidden 0)
642 total)
643 (goto-char (point-max))
644 (gnus-article-search-signature)
645 (setq total (count-lines start (point)))
eec82323 646 (while atts
23f87bed
MB
647 (setq hidden (+ hidden (length (cdr (assoc (cdar atts)
648 gnus-cite-prefix-alist))))
649 atts (cdr atts)))
650 (when (or force
651 (and (> (* 100 hidden) (* gnus-cite-hide-percentage total))
652 (> hidden gnus-cite-hide-absolute)))
653 (gnus-add-wash-type 'cite)
654 (setq atts gnus-cite-attribution-alist)
655 (while atts
656 (setq total (cdr (assoc (cdar atts) gnus-cite-prefix-alist))
657 atts (cdr atts))
658 (while total
659 (setq hidden (car total)
660 total (cdr total))
661 (goto-char (point-min))
662 (forward-line (1- hidden))
663 (unless (assq hidden gnus-cite-attribution-alist)
664 (gnus-add-text-properties
665 (point) (progn (forward-line 1) (point))
666 (nconc (list 'article-type 'cite)
667 gnus-hidden-properties)))))))))
668 (gnus-set-mode-line 'article)))
eec82323
LMI
669
670(defun gnus-article-hide-citation-in-followups ()
671 "Hide cited text in non-root articles."
672 (interactive)
673 (save-excursion
674 (set-buffer gnus-article-buffer)
675 (let ((article (cdr gnus-article-current)))
676 (unless (save-excursion
677 (set-buffer gnus-summary-buffer)
678 (gnus-article-displayed-root-p article))
679 (gnus-article-hide-citation)))))
680
681;;; Internal functions:
682
16409b0b
GM
683(defun gnus-cite-parse-maybe (&optional force no-overlay)
684 "Always parse the buffer."
685 (gnus-cite-localize)
686 ;;Reset parser information.
687 (setq gnus-cite-prefix-alist nil
688 gnus-cite-attribution-alist nil
689 gnus-cite-loose-prefix-alist nil
690 gnus-cite-loose-attribution-alist nil)
691 (unless no-overlay
692 (gnus-cite-delete-overlays))
693 ;; Parse if not too large.
694 (if (and gnus-cite-parse-max-size
695 (> (buffer-size) gnus-cite-parse-max-size))
eec82323 696 ()
16409b0b
GM
697 (setq gnus-cite-article (cons (car gnus-article-current)
698 (cdr gnus-article-current)))
699 (gnus-cite-parse-wrapper)))
700
701(defun gnus-cite-delete-overlays ()
702 (dolist (overlay gnus-cite-overlay-list)
23f87bed
MB
703 (ignore-errors
704 (when (or (not (gnus-overlay-end overlay))
705 (and (>= (gnus-overlay-end overlay) (point-min))
706 (<= (gnus-overlay-end overlay) (point-max))))
707 (setq gnus-cite-overlay-list (delete overlay gnus-cite-overlay-list))
708 (ignore-errors
709 (gnus-delete-overlay overlay))))))
eec82323
LMI
710
711(defun gnus-cite-parse-wrapper ()
16409b0b
GM
712 ;; Wrap chopped gnus-cite-parse.
713 (article-goto-body)
714 (let ((inhibit-point-motion-hooks t))
715 (save-excursion
716 (gnus-cite-parse-attributions))
717 (save-excursion
718 (gnus-cite-parse))
719 (save-excursion
720 (gnus-cite-connect-attributions))))
eec82323
LMI
721
722(defun gnus-cite-parse ()
723 ;; Parse and connect citation prefixes and attribution lines.
724
725 ;; Parse current buffer searching for citation prefixes.
726 (let ((line (1+ (count-lines (point-min) (point))))
727 (case-fold-search t)
728 (max (save-excursion
729 (goto-char (point-max))
730 (gnus-article-search-signature)
731 (point)))
23f87bed
MB
732 (prefix-regexp (concat "^\\(" message-cite-prefix-regexp "\\)"))
733 alist entry start begin end numbers prefix guess-limit)
eec82323
LMI
734 ;; Get all potential prefixes in `alist'.
735 (while (< (point) max)
736 ;; Each line.
737 (setq begin (point)
23f87bed
MB
738 guess-limit (progn (skip-chars-forward "^> \t\r\n") (point))
739 end (gnus-point-at-bol 2)
eec82323
LMI
740 start end)
741 (goto-char begin)
742 ;; Ignore standard Supercite attribution prefix.
23f87bed
MB
743 (when (and (< guess-limit (+ begin gnus-cite-max-prefix))
744 (looking-at gnus-supercite-regexp))
eec82323
LMI
745 (if (match-end 1)
746 (setq end (1+ (match-end 1)))
747 (setq end (1+ begin))))
748 ;; Ignore very long prefixes.
23f87bed
MB
749 (when (> end (+ begin gnus-cite-max-prefix))
750 (setq end (+ begin gnus-cite-max-prefix)))
751 ;; Ignore quoted envelope From_.
752 (when (and gnus-cite-ignore-quoted-from
753 (prog2
754 (setq case-fold-search nil)
755 (looking-at ">From ")
756 (setq case-fold-search t)))
757 (setq end (1+ begin)))
758 (while (re-search-forward prefix-regexp (1- end) t)
eec82323
LMI
759 ;; Each prefix.
760 (setq end (match-end 0)
761 prefix (buffer-substring begin end))
762 (gnus-set-text-properties 0 (length prefix) nil prefix)
763 (setq entry (assoc prefix alist))
764 (if entry
765 (setcdr entry (cons line (cdr entry)))
766 (push (list prefix line) alist))
767 (goto-char begin))
768 (goto-char start)
769 (setq line (1+ line)))
23f87bed
MB
770 ;; Horrible special case for some Microsoft mailers.
771 (goto-char (point-min))
772 (when (re-search-forward gnus-cite-unsightly-citation-regexp max t)
773 (setq begin (count-lines (point-min) (point)))
774 (setq end (count-lines (point-min) max))
775 (setq entry nil)
776 (while (< begin end)
777 (push begin entry)
778 (setq begin (1+ begin)))
779 (push (cons "" entry) alist))
eec82323
LMI
780 ;; We got all the potential prefixes. Now create
781 ;; `gnus-cite-prefix-alist' containing the oldest prefix for each
23f87bed 782 ;; line that appears at least `gnus-cite-minimum-match-count'
eec82323
LMI
783 ;; times. First sort them by length. Longer is older.
784 (setq alist (sort alist (lambda (a b)
785 (> (length (car a)) (length (car b))))))
786 (while alist
787 (setq entry (car alist)
788 prefix (car entry)
789 numbers (cdr entry)
790 alist (cdr alist))
791 (cond ((null numbers)
792 ;; No lines with this prefix that wasn't also part of
793 ;; a longer prefix.
794 )
795 ((< (length numbers) gnus-cite-minimum-match-count)
796 ;; Too few lines with this prefix. We keep it a bit
797 ;; longer in case it is an exact match for an attribution
798 ;; line, but we don't remove the line from other
799 ;; prefixes.
800 (push entry gnus-cite-prefix-alist))
801 (t
802 (push entry
803 gnus-cite-prefix-alist)
804 ;; Remove articles from other prefixes.
805 (let ((loop alist)
806 current)
807 (while loop
808 (setq current (car loop)
809 loop (cdr loop))
810 (setcdr current
811 (gnus-set-difference (cdr current) numbers)))))))))
812
813(defun gnus-cite-parse-attributions ()
814 (let (al-alist)
815 ;; Parse attributions
816 (while (re-search-forward gnus-cite-attribution-suffix (point-max) t)
817 (let* ((start (match-beginning 0))
818 (end (match-end 0))
819 (wrote (count-lines (point-min) end))
820 (prefix (gnus-cite-find-prefix wrote))
821 ;; Check previous line for an attribution leader.
822 (tag (progn
823 (beginning-of-line 1)
824 (when (looking-at gnus-supercite-secondary-regexp)
825 (buffer-substring (match-beginning 1)
826 (match-end 1)))))
827 (in (progn
828 (goto-char start)
829 (and (re-search-backward gnus-cite-attribution-prefix
830 (save-excursion
831 (beginning-of-line 0)
832 (point))
833 t)
834 (not (re-search-forward gnus-cite-attribution-suffix
835 start t))
836 (count-lines (point-min) (1+ (point)))))))
837 (when (eq wrote in)
838 (setq in nil))
839 (goto-char end)
840 ;; don't add duplicates
841 (let ((al (buffer-substring (save-excursion (beginning-of-line 0)
842 (1+ (point)))
843 end)))
844 (if (not (assoc al al-alist))
845 (progn
846 (push (list wrote in prefix tag)
847 gnus-cite-loose-attribution-alist)
848 (push (cons al t) al-alist))))))))
849
850(defun gnus-cite-connect-attributions ()
851 ;; Connect attributions to citations
852
853 ;; No citations have been connected to attribution lines yet.
854 (setq gnus-cite-loose-prefix-alist (append gnus-cite-prefix-alist nil))
855
856 ;; Parse current buffer searching for attribution lines.
857 ;; Find exact supercite citations.
858 (gnus-cite-match-attributions 'small nil
859 (lambda (prefix tag)
860 (when tag
861 (concat "\\`"
862 (regexp-quote prefix) "[ \t]*"
863 (regexp-quote tag) ">"))))
864 ;; Find loose supercite citations after attributions.
865 (gnus-cite-match-attributions 'small t
866 (lambda (prefix tag)
867 (when tag
868 (concat "\\<"
869 (regexp-quote tag)
870 "\\>"))))
871 ;; Find loose supercite citations anywhere.
872 (gnus-cite-match-attributions 'small nil
873 (lambda (prefix tag)
874 (when tag
875 (concat "\\<"
876 (regexp-quote tag)
877 "\\>"))))
878 ;; Find nested citations after attributions.
879 (gnus-cite-match-attributions 'small-if-unique t
880 (lambda (prefix tag)
881 (concat "\\`" (regexp-quote prefix) ".+")))
882 ;; Find nested citations anywhere.
883 (gnus-cite-match-attributions 'small nil
884 (lambda (prefix tag)
885 (concat "\\`" (regexp-quote prefix) ".+")))
886 ;; Remove loose prefixes with too few lines.
887 (let ((alist gnus-cite-loose-prefix-alist)
888 entry)
889 (while alist
890 (setq entry (car alist)
891 alist (cdr alist))
892 (when (< (length (cdr entry)) gnus-cite-minimum-match-count)
893 (setq gnus-cite-prefix-alist
894 (delq entry gnus-cite-prefix-alist)
895 gnus-cite-loose-prefix-alist
896 (delq entry gnus-cite-loose-prefix-alist)))))
897 ;; Find flat attributions.
898 (gnus-cite-match-attributions 'first t nil)
899 ;; Find any attributions (are we getting desperate yet?).
900 (gnus-cite-match-attributions 'first nil nil))
901
902(defun gnus-cite-match-attributions (sort after fun)
903 ;; Match all loose attributions and citations (SORT AFTER FUN) .
904 ;;
905 ;; If SORT is `small', the citation with the shortest prefix will be
906 ;; used, if it is `first' the first prefix will be used, if it is
907 ;; `small-if-unique' the shortest prefix will be used if the
908 ;; attribution line does not share its own prefix with other
909 ;; loose attribution lines, otherwise the first prefix will be used.
910 ;;
911 ;; If AFTER is non-nil, only citations after the attribution line
912 ;; will be considered.
913 ;;
914 ;; If FUN is non-nil, it will be called with the arguments (WROTE
915 ;; PREFIX TAG) and expected to return a regular expression. Only
916 ;; citations whose prefix matches the regular expression will be
917 ;; considered.
918 ;;
919 ;; WROTE is the attribution line number.
920 ;; PREFIX is the attribution line prefix.
921 ;; TAG is the Supercite tag on the attribution line.
922 (let ((atts gnus-cite-loose-attribution-alist)
923 (case-fold-search t)
924 att wrote in prefix tag regexp limit smallest best size)
925 (while atts
926 (setq att (car atts)
927 atts (cdr atts)
928 wrote (nth 0 att)
929 in (nth 1 att)
930 prefix (nth 2 att)
931 tag (nth 3 att)
932 regexp (if fun (funcall fun prefix tag) "")
933 size (cond ((eq sort 'small) t)
934 ((eq sort 'first) nil)
935 (t (< (length (gnus-cite-find-loose prefix)) 2)))
936 limit (if after wrote -1)
937 smallest 1000000
938 best nil)
939 (let ((cites gnus-cite-loose-prefix-alist)
940 cite candidate numbers first compare)
941 (while cites
942 (setq cite (car cites)
943 cites (cdr cites)
944 candidate (car cite)
945 numbers (cdr cite)
946 first (apply 'min numbers)
947 compare (if size (length candidate) first))
948 (and (> first limit)
949 regexp
950 (string-match regexp candidate)
951 (< compare smallest)
952 (setq best cite
953 smallest compare))))
954 (if (null best)
955 ()
956 (setq gnus-cite-loose-attribution-alist
957 (delq att gnus-cite-loose-attribution-alist))
958 (push (cons wrote (car best)) gnus-cite-attribution-alist)
959 (when in
960 (push (cons in (car best)) gnus-cite-attribution-alist))
961 (when (memq best gnus-cite-loose-prefix-alist)
962 (let ((loop gnus-cite-prefix-alist)
963 (numbers (cdr best))
964 current)
965 (setq gnus-cite-loose-prefix-alist
966 (delq best gnus-cite-loose-prefix-alist))
967 (while loop
968 (setq current (car loop)
969 loop (cdr loop))
970 (if (eq current best)
971 ()
972 (setcdr current (gnus-set-difference (cdr current) numbers))
973 (when (null (cdr current))
974 (setq gnus-cite-loose-prefix-alist
975 (delq current gnus-cite-loose-prefix-alist)
976 atts (delq current atts)))))))))))
977
978(defun gnus-cite-find-loose (prefix)
979 ;; Return a list of loose attribution lines prefixed by PREFIX.
980 (let* ((atts gnus-cite-loose-attribution-alist)
981 att line lines)
982 (while atts
983 (setq att (car atts)
984 line (car att)
985 atts (cdr atts))
986 (when (string-equal (gnus-cite-find-prefix line) prefix)
987 (push line lines)))
988 lines))
989
990(defun gnus-cite-add-face (number prefix face)
991 ;; At line NUMBER, ignore PREFIX and add FACE to the rest of the line.
992 (when face
993 (let ((inhibit-point-motion-hooks t)
6748645f 994 from to overlay)
16409b0b
GM
995 (goto-char (point-min))
996 (when (zerop (forward-line (1- number)))
eec82323
LMI
997 (forward-char (length prefix))
998 (skip-chars-forward " \t")
999 (setq from (point))
1000 (end-of-line 1)
1001 (skip-chars-backward " \t")
1002 (setq to (point))
1003 (when (< from to)
6748645f
LMI
1004 (push (setq overlay (gnus-make-overlay from to))
1005 gnus-cite-overlay-list)
1006 (gnus-overlay-put overlay 'face face))))))
eec82323
LMI
1007
1008(defun gnus-cite-toggle (prefix)
1009 (save-excursion
1010 (set-buffer gnus-article-buffer)
16409b0b 1011 (gnus-cite-parse-maybe nil t)
eec82323
LMI
1012 (let ((buffer-read-only nil)
1013 (numbers (cdr (assoc prefix gnus-cite-prefix-alist)))
1014 (inhibit-point-motion-hooks t)
1015 number)
1016 (while numbers
1017 (setq number (car numbers)
1018 numbers (cdr numbers))
16409b0b
GM
1019 (goto-char (point-min))
1020 (forward-line (1- number))
eec82323 1021 (cond ((get-text-property (point) 'invisible)
23f87bed
MB
1022 ;; Can't remove 'cite from g-a-wash-types here because
1023 ;; multiple citations may be hidden -jas
eec82323
LMI
1024 (remove-text-properties (point) (progn (forward-line 1) (point))
1025 gnus-hidden-properties))
1026 ((assq number gnus-cite-attribution-alist))
1027 (t
23f87bed 1028 (gnus-add-wash-type 'cite)
eec82323
LMI
1029 (gnus-add-text-properties
1030 (point) (progn (forward-line 1) (point))
1031 (nconc (list 'article-type 'cite)
23f87bed
MB
1032 gnus-hidden-properties))))
1033 (let ((gnus-article-mime-handle-alist-1
1034 gnus-article-mime-handle-alist))
1035 (gnus-set-mode-line 'article))))))
eec82323
LMI
1036
1037(defun gnus-cite-find-prefix (line)
1038 ;; Return citation prefix for LINE.
1039 (let ((alist gnus-cite-prefix-alist)
1040 (prefix "")
1041 entry)
1042 (while alist
1043 (setq entry (car alist)
1044 alist (cdr alist))
1045 (when (memq line (cdr entry))
1046 (setq prefix (car entry))))
1047 prefix))
1048
6748645f
LMI
1049(defun gnus-cite-localize ()
1050 "Make the citation variables local to the article buffer."
1051 (let ((vars '(gnus-cite-article
1052 gnus-cite-overlay-list gnus-cite-prefix-alist
1053 gnus-cite-attribution-alist gnus-cite-loose-prefix-alist
1054 gnus-cite-loose-attribution-alist)))
1055 (while vars
1056 (make-local-variable (pop vars)))))
eec82323 1057
23f87bed
MB
1058(defun gnus-cited-line-p ()
1059 "Say whether the current line is a cited line."
1060 (save-excursion
1061 (beginning-of-line)
1062 (let ((found nil))
1063 (dolist (prefix (mapcar 'car gnus-cite-prefix-alist))
1064 (when (string= (buffer-substring (point) (+ (length prefix) (point)))
1065 prefix)
1066 (setq found t)))
1067 found)))
1068
eec82323
LMI
1069(gnus-ems-redefine)
1070
1071(provide 'gnus-cite)
1072
16409b0b
GM
1073;; Local Variables:
1074;; coding: iso-8859-1
1075;; End:
1076
ab5796a9 1077;;; arch-tag: 1997b044-6067-471e-8c8f-dc903093098a
eec82323 1078;;; gnus-cite.el ends here