1 ;;; gnus-sum.el --- summary mode commands for Gnus
2 ;; Copyright (C) 1996,97 Free Software Foundation, Inc.
4 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
35 (defcustom gnus-kill-summary-on-exit t
36 "*If non-nil, kill the summary buffer when you exit from it.
37 If nil, the summary will become a \"*Dead Summary*\" buffer, and
38 it will be killed sometime later."
39 :group 'gnus-summary-exit
42 (defcustom gnus-fetch-old-headers nil
43 "*Non-nil means that Gnus will try to build threads by grabbing old headers.
44 If an unread article in the group refers to an older, already read (or
45 just marked as read) article, the old article will not normally be
46 displayed in the Summary buffer. If this variable is non-nil, Gnus
47 will attempt to grab the headers to the old articles, and thereby
48 build complete threads. If it has the value `some', only enough
49 headers to connect otherwise loose threads will be displayed.
50 This variable can also be a number. In that case, no more than that
51 number of old headers will be fetched.
53 The server has to support NOV for any of this to work."
55 :type '(choice (const :tag "off" nil)
58 (sexp :menu-tag "other" t)))
60 (defcustom gnus-summary-make-false-root 'adopt
61 "*nil means that Gnus won't gather loose threads.
62 If the root of a thread has expired or been read in a previous
63 session, the information necessary to build a complete thread has been
64 lost. Instead of having many small sub-threads from this original thread
65 scattered all over the summary buffer, Gnus can gather them.
67 If non-nil, Gnus will try to gather all loose sub-threads from an
68 original thread into one large thread.
70 If this variable is non-nil, it should be one of `none', `adopt',
73 If this variable is `none', Gnus will not make a false root, but just
74 present the sub-threads after another.
75 If this variable is `dummy', Gnus will create a dummy root that will
76 have all the sub-threads as children.
77 If this variable is `adopt', Gnus will make one of the \"children\"
78 the parent and mark all the step-children as such.
79 If this variable is `empty', the \"children\" are printed with empty
80 subject fields. (Or rather, they will be printed with a string
81 given by the `gnus-summary-same-subject' variable.)"
83 :type '(choice (const :tag "off" nil)
89 (defcustom gnus-summary-gather-exclude-subject "^ *$\\|^(none)$"
90 "*A regexp to match subjects to be excluded from loose thread gathering.
91 As loose thread gathering is done on subjects only, that means that
92 there can be many false gatherings performed. By rooting out certain
93 common subjects, gathering might become saner."
97 (defcustom gnus-summary-gather-subject-limit nil
98 "*Maximum length of subject comparisons when gathering loose threads.
99 Use nil to compare full subjects. Setting this variable to a low
100 number will help gather threads that have been corrupted by
101 newsreaders chopping off subject lines, but it might also mean that
102 unrelated articles that have subject that happen to begin with the
103 same few characters will be incorrectly gathered.
105 If this variable is `fuzzy', Gnus will use a fuzzy algorithm when
108 :type '(choice (const :tag "off" nil)
110 (sexp :menu-tag "on" t)))
112 (defcustom gnus-simplify-ignored-prefixes nil
113 "*Regexp, matches for which are removed from subject lines when simplifying fuzzily."
115 :type '(choice (const :tag "off" nil)
118 (defcustom gnus-build-sparse-threads nil
119 "*If non-nil, fill in the gaps in threads.
120 If `some', only fill in the gaps that are needed to tie loose threads
121 together. If `more', fill in all leaf nodes that Gnus can find. If
122 non-nil and non-`some', fill in all gaps that Gnus manages to guess."
124 :type '(choice (const :tag "off" nil)
127 (sexp :menu-tag "all" t)))
129 (defcustom gnus-summary-thread-gathering-function
130 'gnus-gather-threads-by-subject
131 "Function used for gathering loose threads.
132 There are two pre-defined functions: `gnus-gather-threads-by-subject',
133 which only takes Subjects into consideration; and
134 `gnus-gather-threads-by-references', which compared the References
135 headers of the articles to find matches."
137 :type '(set (function-item gnus-gather-threads-by-subject)
138 (function-item gnus-gather-threads-by-references)
139 (function :tag "other")))
141 ;; Added by Per Abrahamsen <amanda@iesd.auc.dk>.
142 (defcustom gnus-summary-same-subject ""
143 "*String indicating that the current article has the same subject as the previous.
144 This variable will only be used if the value of
145 `gnus-summary-make-false-root' is `empty'."
146 :group 'gnus-summary-format
149 (defcustom gnus-summary-goto-unread t
150 "*If t, marking commands will go to the next unread article.
151 If `never', commands that usually go to the next unread article, will
152 go to the next article, whether it is read or not.
153 If nil, only the marking commands will go to the next (un)read article."
154 :group 'gnus-summary-marks
155 :link '(custom-manual "(gnus)Setting Marks")
156 :type '(choice (const :tag "off" nil)
158 (sexp :menu-tag "on" t)))
160 (defcustom gnus-summary-default-score 0
161 "*Default article score level.
162 All scores generated by the score files will be added to this score.
163 If this variable is nil, scoring will be disabled."
164 :group 'gnus-score-default
165 :type '(choice (const :tag "disable")
168 (defcustom gnus-summary-zcore-fuzz 0
169 "*Fuzziness factor for the zcore in the summary buffer.
170 Articles with scores closer than this to `gnus-summary-default-score'
172 :group 'gnus-summary-format
175 (defcustom gnus-simplify-subject-fuzzy-regexp nil
176 "*Strings to be removed when doing fuzzy matches.
177 This can either be a regular expression or list of regular expressions
178 that will be removed from subject strings if fuzzy subject
179 simplification is selected."
181 :type '(repeat regexp))
183 (defcustom gnus-show-threads t
184 "*If non-nil, display threads in summary mode."
188 (defcustom gnus-thread-hide-subtree nil
189 "*If non-nil, hide all threads initially.
190 If threads are hidden, you have to run the command
191 `gnus-summary-show-thread' by hand or use `gnus-select-article-hook'
192 to expose hidden threads."
196 (defcustom gnus-thread-hide-killed t
197 "*If non-nil, hide killed threads automatically."
201 (defcustom gnus-thread-ignore-subject nil
202 "*If non-nil, ignore subjects and do all threading based on the Reference header.
203 If nil, which is the default, articles that have different subjects
204 from their parents will start separate threads."
208 (defcustom gnus-thread-operation-ignore-subject t
209 "*If non-nil, subjects will be ignored when doing thread commands.
210 This affects commands like `gnus-summary-kill-thread' and
211 `gnus-summary-lower-thread'.
213 If this variable is nil, articles in the same thread with different
214 subjects will not be included in the operation in question. If this
215 variable is `fuzzy', only articles that have subjects that are fuzzily
216 equal will be included."
218 :type '(choice (const :tag "off" nil)
222 (defcustom gnus-thread-indent-level 4
223 "*Number that says how much each sub-thread should be indented."
227 (defcustom gnus-auto-extend-newsgroup t
228 "*If non-nil, extend newsgroup forward and backward when requested."
229 :group 'gnus-summary-choose
232 (defcustom gnus-auto-select-first t
233 "*If nil, don't select the first unread article when entering a group.
234 If this variable is `best', select the highest-scored unread article
235 in the group. If neither nil nor `best', select the first unread
238 If you want to prevent automatic selection of the first unread article
239 in some newsgroups, set the variable to nil in
240 `gnus-select-group-hook'."
241 :group 'gnus-group-select
242 :type '(choice (const :tag "none" nil)
244 (sexp :menu-tag "first" t)))
246 (defcustom gnus-auto-select-next t
247 "*If non-nil, offer to go to the next group from the end of the previous.
248 If the value is t and the next newsgroup is empty, Gnus will exit
249 summary mode and go back to group mode. If the value is neither nil
250 nor t, Gnus will select the following unread newsgroup. In
251 particular, if the value is the symbol `quietly', the next unread
252 newsgroup will be selected without any confirmation, and if it is
253 `almost-quietly', the next group will be selected without any
254 confirmation if you are located on the last article in the group.
255 Finally, if this variable is `slightly-quietly', the `Z n' command
256 will go to the next group without confirmation."
257 :group 'gnus-summary-maneuvering
258 :type '(choice (const :tag "off" nil)
260 (const almost-quietly)
261 (const slightly-quietly)
262 (sexp :menu-tag "on" t)))
264 (defcustom gnus-auto-select-same nil
265 "*If non-nil, select the next article with the same subject."
266 :group 'gnus-summary-maneuvering
269 (defcustom gnus-summary-check-current nil
270 "*If non-nil, consider the current article when moving.
271 The \"unread\" movement commands will stay on the same line if the
272 current article is unread."
273 :group 'gnus-summary-maneuvering
276 (defcustom gnus-auto-center-summary t
277 "*If non-nil, always center the current summary buffer.
278 In particular, if `vertical' do only vertical recentering. If non-nil
279 and non-`vertical', do both horizontal and vertical recentering."
280 :group 'gnus-summary-maneuvering
281 :type '(choice (const :tag "none" nil)
283 (sexp :menu-tag "both" t)))
285 (defcustom gnus-show-all-headers nil
286 "*If non-nil, don't hide any headers."
287 :group 'gnus-article-hiding
288 :group 'gnus-article-headers
291 (defcustom gnus-summary-ignore-duplicates nil
292 "*If non-nil, ignore articles with identical Message-ID headers."
296 (defcustom gnus-single-article-buffer t
297 "*If non-nil, display all articles in the same buffer.
298 If nil, each group will get its own article buffer."
299 :group 'gnus-article-various
302 (defcustom gnus-break-pages t
303 "*If non-nil, do page breaking on articles.
304 The page delimiter is specified by the `gnus-page-delimiter'
306 :group 'gnus-article-various
309 (defcustom gnus-show-mime nil
310 "*If non-nil, do mime processing of articles.
311 The articles will simply be fed to the function given by
312 `gnus-show-mime-method'."
313 :group 'gnus-article-mime
316 (defcustom gnus-move-split-methods nil
317 "*Variable used to suggest where articles are to be moved to.
318 It uses the same syntax as the `gnus-split-methods' variable."
319 :group 'gnus-summary-mail
320 :type '(repeat (choice (list function)
321 (cons regexp (repeat string))
324 (defcustom gnus-unread-mark ?
325 "*Mark used for unread articles."
326 :group 'gnus-summary-marks
329 (defcustom gnus-ticked-mark ?!
330 "*Mark used for ticked articles."
331 :group 'gnus-summary-marks
334 (defcustom gnus-dormant-mark ??
335 "*Mark used for dormant articles."
336 :group 'gnus-summary-marks
339 (defcustom gnus-del-mark ?r
340 "*Mark used for del'd articles."
341 :group 'gnus-summary-marks
344 (defcustom gnus-read-mark ?R
345 "*Mark used for read articles."
346 :group 'gnus-summary-marks
349 (defcustom gnus-expirable-mark ?E
350 "*Mark used for expirable articles."
351 :group 'gnus-summary-marks
354 (defcustom gnus-killed-mark ?K
355 "*Mark used for killed articles."
356 :group 'gnus-summary-marks
359 (defcustom gnus-souped-mark ?F
360 "*Mark used for killed articles."
361 :group 'gnus-summary-marks
364 (defcustom gnus-kill-file-mark ?X
365 "*Mark used for articles killed by kill files."
366 :group 'gnus-summary-marks
369 (defcustom gnus-low-score-mark ?Y
370 "*Mark used for articles with a low score."
371 :group 'gnus-summary-marks
374 (defcustom gnus-catchup-mark ?C
375 "*Mark used for articles that are caught up."
376 :group 'gnus-summary-marks
379 (defcustom gnus-replied-mark ?A
380 "*Mark used for articles that have been replied to."
381 :group 'gnus-summary-marks
384 (defcustom gnus-cached-mark ?*
385 "*Mark used for articles that are in the cache."
386 :group 'gnus-summary-marks
389 (defcustom gnus-saved-mark ?S
390 "*Mark used for articles that have been saved to."
391 :group 'gnus-summary-marks
394 (defcustom gnus-ancient-mark ?O
395 "*Mark used for ancient articles."
396 :group 'gnus-summary-marks
399 (defcustom gnus-sparse-mark ?Q
400 "*Mark used for sparsely reffed articles."
401 :group 'gnus-summary-marks
404 (defcustom gnus-canceled-mark ?G
405 "*Mark used for canceled articles."
406 :group 'gnus-summary-marks
409 (defcustom gnus-duplicate-mark ?M
410 "*Mark used for duplicate articles."
411 :group 'gnus-summary-marks
414 (defcustom gnus-score-over-mark ?+
415 "*Score mark used for articles with high scores."
416 :group 'gnus-summary-marks
419 (defcustom gnus-score-below-mark ?-
420 "*Score mark used for articles with low scores."
421 :group 'gnus-summary-marks
424 (defcustom gnus-empty-thread-mark ?
425 "*There is no thread under the article."
426 :group 'gnus-summary-marks
429 (defcustom gnus-not-empty-thread-mark ?=
430 "*There is a thread under the article."
431 :group 'gnus-summary-marks
434 (defcustom gnus-view-pseudo-asynchronously nil
435 "*If non-nil, Gnus will view pseudo-articles asynchronously."
436 :group 'gnus-extract-view
439 (defcustom gnus-view-pseudos nil
440 "*If `automatic', pseudo-articles will be viewed automatically.
441 If `not-confirm', pseudos will be viewed automatically, and the user
442 will not be asked to confirm the command."
443 :group 'gnus-extract-view
444 :type '(choice (const :tag "off" nil)
446 (const not-confirm)))
448 (defcustom gnus-view-pseudos-separately t
449 "*If non-nil, one pseudo-article will be created for each file to be viewed.
450 If nil, all files that use the same viewing command will be given as a
451 list of parameters to that command."
452 :group 'gnus-extract-view
455 (defcustom gnus-insert-pseudo-articles t
456 "*If non-nil, insert pseudo-articles when decoding articles."
457 :group 'gnus-extract-view
460 (defcustom gnus-summary-dummy-line-format
462 "*The format specification for the dummy roots in the summary buffer.
463 It works along the same lines as a normal formatting string,
464 with some simple extensions.
467 :group 'gnus-threading
470 (defcustom gnus-summary-mode-line-format "Gnus: %%b [%A] %Z"
471 "*The format specification for the summary mode line.
472 It works along the same lines as a normal formatting string,
473 with some simple extensions:
476 %p Unprefixed group name
477 %A Current article number
479 %U Number of unread articles in the group
480 %e Number of unselected articles in the group
481 %Z A string with unread/unselected article counts
482 %g Shortish group name
483 %S Subject of the current article
485 %s Current score file name
486 %d Number of dormant articles
487 %r Number of articles that have been marked as read in this session
488 %E Number of articles expunged by the score files"
489 :group 'gnus-summary-format
492 (defcustom gnus-summary-mark-below 0
493 "*Mark all articles with a score below this variable as read.
494 This variable is local to each summary buffer and usually set by the
496 :group 'gnus-score-default
499 (defcustom gnus-article-sort-functions '(gnus-article-sort-by-number)
500 "*List of functions used for sorting articles in the summary buffer.
501 This variable is only used when not using a threaded display."
502 :group 'gnus-summary-sort
503 :type '(repeat (choice (function-item gnus-article-sort-by-number)
504 (function-item gnus-article-sort-by-author)
505 (function-item gnus-article-sort-by-subject)
506 (function-item gnus-article-sort-by-date)
507 (function-item gnus-article-sort-by-score)
508 (function :tag "other"))))
510 (defcustom gnus-thread-sort-functions '(gnus-thread-sort-by-number)
511 "*List of functions used for sorting threads in the summary buffer.
512 By default, threads are sorted by article number.
514 Each function takes two threads and return non-nil if the first thread
515 should be sorted before the other. If you use more than one function,
516 the primary sort function should be the last. You should probably
517 always include `gnus-thread-sort-by-number' in the list of sorting
518 functions -- preferably first.
520 Ready-made functions include `gnus-thread-sort-by-number',
521 `gnus-thread-sort-by-author', `gnus-thread-sort-by-subject',
522 `gnus-thread-sort-by-date', `gnus-thread-sort-by-score' and
523 `gnus-thread-sort-by-total-score' (see `gnus-thread-score-function')."
524 :group 'gnus-summary-sort
525 :type '(repeat (choice (function-item gnus-thread-sort-by-number)
526 (function-item gnus-thread-sort-by-author)
527 (function-item gnus-thread-sort-by-subject)
528 (function-item gnus-thread-sort-by-date)
529 (function-item gnus-thread-sort-by-score)
530 (function-item gnus-thread-sort-by-total-score)
531 (function :tag "other"))))
533 (defcustom gnus-thread-score-function '+
534 "*Function used for calculating the total score of a thread.
536 The function is called with the scores of the article and each
537 subthread and should then return the score of the thread.
539 Some functions you can use are `+', `max', or `min'."
540 :group 'gnus-summary-sort
543 (defcustom gnus-summary-expunge-below nil
544 "All articles that have a score less than this variable will be expunged."
545 :group 'gnus-score-default
546 :type '(choice (const :tag "off" nil)
549 (defcustom gnus-thread-expunge-below nil
550 "All threads that have a total score less than this variable will be expunged.
551 See `gnus-thread-score-function' for en explanation of what a
552 \"thread score\" is."
553 :group 'gnus-treading
554 :group 'gnus-score-default
555 :type '(choice (const :tag "off" nil)
558 (defcustom gnus-summary-mode-hook nil
559 "*A hook for Gnus summary mode.
560 This hook is run before any variables are set in the summary buffer."
561 :group 'gnus-summary-various
564 (defcustom gnus-summary-menu-hook nil
565 "*Hook run after the creation of the summary mode menu."
566 :group 'gnus-summary-visual
569 (defcustom gnus-summary-exit-hook nil
570 "*A hook called on exit from the summary buffer.
571 It will be called with point in the group buffer."
572 :group 'gnus-summary-exit
575 (defcustom gnus-summary-prepare-hook nil
576 "*A hook called after the summary buffer has been generated.
577 If you want to modify the summary buffer, you can use this hook."
578 :group 'gnus-summary-various
581 (defcustom gnus-summary-generate-hook nil
582 "*A hook run just before generating the summary buffer.
583 This hook is commonly used to customize threading variables and the
585 :group 'gnus-summary-various
588 (defcustom gnus-select-group-hook nil
589 "*A hook called when a newsgroup is selected.
591 If you'd like to simplify subjects like the
592 `gnus-summary-next-same-subject' command does, you can use the
595 (setq gnus-select-group-hook
598 (mapcar (lambda (header)
599 (mail-header-set-subject
601 (gnus-simplify-subject
602 (mail-header-subject header) 're-only)))
603 gnus-newsgroup-headers))))"
604 :group 'gnus-group-select
607 (defcustom gnus-select-article-hook nil
608 "*A hook called when an article is selected."
609 :group 'gnus-summary-choose
612 (defcustom gnus-visual-mark-article-hook
613 (list 'gnus-highlight-selected-summary)
614 "*Hook run after selecting an article in the summary buffer.
615 It is meant to be used for highlighting the article in some way. It
616 is not run if `gnus-visual' is nil."
617 :group 'gnus-summary-visual
620 (defcustom gnus-parse-headers-hook
621 (list 'gnus-hack-decode-rfc1522 'gnus-decode-rfc1522)
622 "*A hook called before parsing the headers."
626 (defcustom gnus-exit-group-hook nil
627 "*A hook called when exiting (not quitting) summary mode."
631 (defcustom gnus-summary-update-hook
632 (list 'gnus-summary-highlight-line)
633 "*A hook called when a summary line is changed.
634 The hook will not be called if `gnus-visual' is nil.
636 The default function `gnus-summary-highlight-line' will
637 highlight the line according to the `gnus-summary-highlight'
639 :group 'gnus-summary-visual
642 (defcustom gnus-mark-article-hook '(gnus-summary-mark-read-and-unread-as-read)
643 "*A hook called when an article is selected for the first time.
644 The hook is intended to mark an article as read (or unread)
645 automatically when it is selected."
646 :group 'gnus-summary-choose
649 (defcustom gnus-group-no-more-groups-hook nil
650 "*A hook run when returning to group mode having no more (unread) groups."
651 :group 'gnus-group-select
654 (defcustom gnus-ps-print-hook nil
655 "*A hook run before ps-printing something from Gnus."
659 (defcustom gnus-summary-selected-face 'gnus-summary-selected-face
660 "Face used for highlighting the current article in the summary buffer."
661 :group 'gnus-summary-visual
664 (defcustom gnus-summary-highlight
665 '(((= mark gnus-canceled-mark)
666 . gnus-summary-cancelled-face)
667 ((and (> score default)
668 (or (= mark gnus-dormant-mark)
669 (= mark gnus-ticked-mark)))
670 . gnus-summary-high-ticked-face)
671 ((and (< score default)
672 (or (= mark gnus-dormant-mark)
673 (= mark gnus-ticked-mark)))
674 . gnus-summary-low-ticked-face)
675 ((or (= mark gnus-dormant-mark)
676 (= mark gnus-ticked-mark))
677 . gnus-summary-normal-ticked-face)
678 ((and (> score default) (= mark gnus-ancient-mark))
679 . gnus-summary-high-ancient-face)
680 ((and (< score default) (= mark gnus-ancient-mark))
681 . gnus-summary-low-ancient-face)
682 ((= mark gnus-ancient-mark)
683 . gnus-summary-normal-ancient-face)
684 ((and (> score default) (= mark gnus-unread-mark))
685 . gnus-summary-high-unread-face)
686 ((and (< score default) (= mark gnus-unread-mark))
687 . gnus-summary-low-unread-face)
688 ((and (= mark gnus-unread-mark))
689 . gnus-summary-normal-unread-face)
691 . gnus-summary-high-read-face)
693 . gnus-summary-low-read-face)
695 . gnus-summary-normal-read-face))
696 "Controls the highlighting of summary buffer lines.
698 A list of (FORM . FACE) pairs. When deciding how a a particular
699 summary line should be displayed, each form is evaluated. The content
700 of the face field after the first true form is used. You can change
701 how those summary lines are displayed, by editing the face field.
703 You can use the following variables in the FORM field.
705 score: The articles score
706 default: The default article score.
707 below: The score below which articles are automatically marked as read.
708 mark: The articles mark."
709 :group 'gnus-summary-visual
710 :type '(repeat (cons (sexp :tag "Form" nil)
714 ;;; Internal variables
716 (defvar gnus-scores-exclude-files nil)
717 (defvar gnus-page-broken nil)
719 (defvar gnus-original-article nil)
720 (defvar gnus-article-internal-prepare-hook nil)
721 (defvar gnus-newsgroup-process-stack nil)
723 (defvar gnus-thread-indent-array nil)
724 (defvar gnus-thread-indent-array-level gnus-thread-indent-level)
726 ;; Avoid highlighting in kill files.
727 (defvar gnus-summary-inhibit-highlight nil)
728 (defvar gnus-newsgroup-selected-overlay nil)
729 (defvar gnus-inhibit-limiting nil)
730 (defvar gnus-newsgroup-adaptive-score-file nil)
731 (defvar gnus-current-score-file nil)
732 (defvar gnus-current-move-group nil)
733 (defvar gnus-current-copy-group nil)
734 (defvar gnus-current-crosspost-group nil)
736 (defvar gnus-newsgroup-dependencies nil)
737 (defvar gnus-newsgroup-adaptive nil)
738 (defvar gnus-summary-display-article-function nil)
739 (defvar gnus-summary-highlight-line-function nil
740 "Function called after highlighting a summary line.")
742 (defvar gnus-summary-line-format-alist
743 `((?N ,(macroexpand '(mail-header-number gnus-tmp-header)) ?d)
744 (?S ,(macroexpand '(mail-header-subject gnus-tmp-header)) ?s)
745 (?s gnus-tmp-subject-or-nil ?s)
746 (?n gnus-tmp-name ?s)
747 (?A (car (cdr (funcall gnus-extract-address-components gnus-tmp-from)))
749 (?a (or (car (funcall gnus-extract-address-components gnus-tmp-from))
751 (?F gnus-tmp-from ?s)
752 (?x ,(macroexpand '(mail-header-xref gnus-tmp-header)) ?s)
753 (?D ,(macroexpand '(mail-header-date gnus-tmp-header)) ?s)
754 (?d (gnus-dd-mmm (mail-header-date gnus-tmp-header)) ?s)
755 (?o (gnus-date-iso8601 gnus-tmp-header) ?s)
756 (?M ,(macroexpand '(mail-header-id gnus-tmp-header)) ?s)
757 (?r ,(macroexpand '(mail-header-references gnus-tmp-header)) ?s)
758 (?c (or (mail-header-chars gnus-tmp-header) 0) ?d)
759 (?L gnus-tmp-lines ?d)
760 (?I gnus-tmp-indentation ?s)
761 (?T (if (= gnus-tmp-level 0) "" (make-string (frame-width) ? )) ?s)
762 (?R gnus-tmp-replied ?c)
763 (?\[ gnus-tmp-opening-bracket ?c)
764 (?\] gnus-tmp-closing-bracket ?c)
765 (?\> (make-string gnus-tmp-level ? ) ?s)
766 (?\< (make-string (max 0 (- 20 gnus-tmp-level)) ? ) ?s)
767 (?i gnus-tmp-score ?d)
768 (?z gnus-tmp-score-char ?c)
769 (?l (bbb-grouplens-score gnus-tmp-header) ?s)
770 (?V (gnus-thread-total-score (and (boundp 'thread) (car thread))) ?d)
771 (?U gnus-tmp-unread ?c)
772 (?t (gnus-summary-number-of-articles-in-thread
773 (and (boundp 'thread) (car thread)) gnus-tmp-level)
775 (?e (gnus-summary-number-of-articles-in-thread
776 (and (boundp 'thread) (car thread)) gnus-tmp-level t)
778 (?u gnus-tmp-user-defined ?s)
779 (?P (gnus-pick-line-number) ?d))
780 "An alist of format specifications that can appear in summary lines,
781 and what variables they correspond with, along with the type of the
782 variable (string, integer, character, etc).")
784 (defvar gnus-summary-dummy-line-format-alist
785 `((?S gnus-tmp-subject ?s)
786 (?N gnus-tmp-number ?d)
787 (?u gnus-tmp-user-defined ?s)))
789 (defvar gnus-summary-mode-line-format-alist
790 `((?G gnus-tmp-group-name ?s)
791 (?g (gnus-short-group-name gnus-tmp-group-name) ?s)
792 (?p (gnus-group-real-name gnus-tmp-group-name) ?s)
793 (?A gnus-tmp-article-number ?d)
794 (?Z gnus-tmp-unread-and-unselected ?s)
796 (?U gnus-tmp-unread-and-unticked ?d)
797 (?S gnus-tmp-subject ?s)
798 (?e gnus-tmp-unselected ?d)
799 (?u gnus-tmp-user-defined ?s)
800 (?d (length gnus-newsgroup-dormant) ?d)
801 (?t (length gnus-newsgroup-marked) ?d)
802 (?r (length gnus-newsgroup-reads) ?d)
803 (?E gnus-newsgroup-expunged-tally ?d)
804 (?s (gnus-current-score-file-nondirectory) ?s)))
806 (defvar gnus-last-search-regexp nil
807 "Default regexp for article search command.")
809 (defvar gnus-last-shell-command nil
810 "Default shell command on article.")
812 (defvar gnus-newsgroup-begin nil)
813 (defvar gnus-newsgroup-end nil)
814 (defvar gnus-newsgroup-last-rmail nil)
815 (defvar gnus-newsgroup-last-mail nil)
816 (defvar gnus-newsgroup-last-folder nil)
817 (defvar gnus-newsgroup-last-file nil)
818 (defvar gnus-newsgroup-auto-expire nil)
819 (defvar gnus-newsgroup-active nil)
821 (defvar gnus-newsgroup-data nil)
822 (defvar gnus-newsgroup-data-reverse nil)
823 (defvar gnus-newsgroup-limit nil)
824 (defvar gnus-newsgroup-limits nil)
826 (defvar gnus-newsgroup-unreads nil
827 "List of unread articles in the current newsgroup.")
829 (defvar gnus-newsgroup-unselected nil
830 "List of unselected unread articles in the current newsgroup.")
832 (defvar gnus-newsgroup-reads nil
833 "Alist of read articles and article marks in the current newsgroup.")
835 (defvar gnus-newsgroup-expunged-tally nil)
837 (defvar gnus-newsgroup-marked nil
838 "List of ticked articles in the current newsgroup (a subset of unread art).")
840 (defvar gnus-newsgroup-killed nil
841 "List of ranges of articles that have been through the scoring process.")
843 (defvar gnus-newsgroup-cached nil
844 "List of articles that come from the article cache.")
846 (defvar gnus-newsgroup-saved nil
847 "List of articles that have been saved.")
849 (defvar gnus-newsgroup-kill-headers nil)
851 (defvar gnus-newsgroup-replied nil
852 "List of articles that have been replied to in the current newsgroup.")
854 (defvar gnus-newsgroup-expirable nil
855 "List of articles in the current newsgroup that can be expired.")
857 (defvar gnus-newsgroup-processable nil
858 "List of articles in the current newsgroup that can be processed.")
860 (defvar gnus-newsgroup-bookmarks nil
861 "List of articles in the current newsgroup that have bookmarks.")
863 (defvar gnus-newsgroup-dormant nil
864 "List of dormant articles in the current newsgroup.")
866 (defvar gnus-newsgroup-scored nil
867 "List of scored articles in the current newsgroup.")
869 (defvar gnus-newsgroup-headers nil
870 "List of article headers in the current newsgroup.")
872 (defvar gnus-newsgroup-threads nil)
874 (defvar gnus-newsgroup-prepared nil
875 "Whether the current group has been prepared properly.")
877 (defvar gnus-newsgroup-ancient nil
878 "List of `gnus-fetch-old-headers' articles in the current newsgroup.")
880 (defvar gnus-newsgroup-sparse nil)
882 (defvar gnus-current-article nil)
883 (defvar gnus-article-current nil)
884 (defvar gnus-current-headers nil)
885 (defvar gnus-have-all-headers nil)
886 (defvar gnus-last-article nil)
887 (defvar gnus-newsgroup-history nil)
889 (defconst gnus-summary-local-variables
890 '(gnus-newsgroup-name
891 gnus-newsgroup-begin gnus-newsgroup-end
892 gnus-newsgroup-last-rmail gnus-newsgroup-last-mail
893 gnus-newsgroup-last-folder gnus-newsgroup-last-file
894 gnus-newsgroup-auto-expire gnus-newsgroup-unreads
895 gnus-newsgroup-unselected gnus-newsgroup-marked
896 gnus-newsgroup-reads gnus-newsgroup-saved
897 gnus-newsgroup-replied gnus-newsgroup-expirable
898 gnus-newsgroup-processable gnus-newsgroup-killed
899 gnus-newsgroup-bookmarks gnus-newsgroup-dormant
900 gnus-newsgroup-headers gnus-newsgroup-threads
901 gnus-newsgroup-prepared gnus-summary-highlight-line-function
902 gnus-current-article gnus-current-headers gnus-have-all-headers
903 gnus-last-article gnus-article-internal-prepare-hook
904 gnus-newsgroup-dependencies gnus-newsgroup-selected-overlay
905 gnus-newsgroup-scored gnus-newsgroup-kill-headers
906 gnus-thread-expunge-below
907 gnus-score-alist gnus-current-score-file gnus-summary-expunge-below
908 (gnus-summary-mark-below . global)
909 gnus-newsgroup-active gnus-scores-exclude-files
910 gnus-newsgroup-history gnus-newsgroup-ancient
911 gnus-newsgroup-sparse gnus-newsgroup-process-stack
912 (gnus-newsgroup-adaptive . gnus-use-adaptive-scoring)
913 gnus-newsgroup-adaptive-score-file (gnus-reffed-article-number . -1)
914 (gnus-newsgroup-expunged-tally . 0)
915 gnus-cache-removable-articles gnus-newsgroup-cached
916 gnus-newsgroup-data gnus-newsgroup-data-reverse
917 gnus-newsgroup-limit gnus-newsgroup-limits)
918 "Variables that are buffer-local to the summary buffers.")
920 ;; Byte-compiler warning.
921 (defvar gnus-article-mode-map)
923 ;; Subject simplification.
925 (defsubst gnus-simplify-subject-re (subject)
926 "Remove \"Re:\" from subject lines."
927 (if (string-match "^[Rr][Ee]: *" subject)
928 (substring subject (match-end 0))
931 (defun gnus-simplify-subject (subject &optional re-only)
932 "Remove `Re:' and words in parentheses.
933 If RE-ONLY is non-nil, strip leading `Re:'s only."
934 (let ((case-fold-search t)) ;Ignore case.
935 ;; Remove `Re:', `Re^N:', `Re(n)', and `Re[n]:'.
936 (when (string-match "\\`\\(re\\([[(^][0-9]+[])]?\\)?:[ \t]*\\)+" subject)
937 (setq subject (substring subject (match-end 0))))
938 ;; Remove uninteresting prefixes.
939 (when (and (not re-only)
940 gnus-simplify-ignored-prefixes
941 (string-match gnus-simplify-ignored-prefixes subject))
942 (setq subject (substring subject (match-end 0))))
943 ;; Remove words in parentheses from end.
945 (while (string-match "[ \t\n]*([^()]*)[ \t\n]*\\'" subject)
946 (setq subject (substring subject 0 (match-beginning 0)))))
947 ;; Return subject string.
950 ;; Remove any leading "re:"s, any trailing paren phrases, and simplify
952 (defsubst gnus-simplify-buffer-fuzzy-step (regexp &optional newtext)
953 (goto-char (point-min))
954 (while (re-search-forward regexp nil t)
955 (replace-match (or newtext ""))))
957 (defun gnus-simplify-buffer-fuzzy ()
958 "Simplify string in the buffer fuzzily.
959 The string in the accessible portion of the current buffer is simplified.
960 It is assumed to be a single-line subject.
961 Whitespace is generally cleaned up, and miscellaneous leading/trailing
962 matter is removed. Additional things can be deleted by setting
963 gnus-simplify-subject-fuzzy-regexp."
964 (let ((case-fold-search t)
966 (gnus-simplify-buffer-fuzzy-step "\t" " ")
968 (while (not (eq modified-tick (buffer-modified-tick)))
969 (setq modified-tick (buffer-modified-tick))
971 ((listp gnus-simplify-subject-fuzzy-regexp)
972 (mapcar 'gnus-simplify-buffer-fuzzy-step
973 gnus-simplify-subject-fuzzy-regexp))
974 (gnus-simplify-subject-fuzzy-regexp
975 (gnus-simplify-buffer-fuzzy-step gnus-simplify-subject-fuzzy-regexp)))
976 (gnus-simplify-buffer-fuzzy-step "^ *\\[[-+?*!][-+?*!]\\] *")
977 (gnus-simplify-buffer-fuzzy-step
978 "^ *\\(re\\|fw\\|fwd\\)[[{(^0-9]*[])}]?[:;] *")
979 (gnus-simplify-buffer-fuzzy-step "^[[].*:\\( .*\\)[]]$" "\\1"))
981 (gnus-simplify-buffer-fuzzy-step " *[[{(][^()\n]*[]})] *$")
982 (gnus-simplify-buffer-fuzzy-step " +" " ")
983 (gnus-simplify-buffer-fuzzy-step " $")
984 (gnus-simplify-buffer-fuzzy-step "^ +")))
986 (defun gnus-simplify-subject-fuzzy (subject)
987 "Simplify a subject string fuzzily.
988 See gnus-simplify-buffer-fuzzy for details."
990 (gnus-set-work-buffer)
991 (let ((case-fold-search t))
993 (inline (gnus-simplify-buffer-fuzzy))
996 (defsubst gnus-simplify-subject-fully (subject)
997 "Simplify a subject string according to gnus-summary-gather-subject-limit."
999 ((null gnus-summary-gather-subject-limit)
1000 (gnus-simplify-subject-re subject))
1001 ((eq gnus-summary-gather-subject-limit 'fuzzy)
1002 (gnus-simplify-subject-fuzzy subject))
1003 ((numberp gnus-summary-gather-subject-limit)
1004 (gnus-limit-string (gnus-simplify-subject-re subject)
1005 gnus-summary-gather-subject-limit))
1009 (defsubst gnus-subject-equal (s1 s2 &optional simple-first)
1010 "Check whether two subjects are equal. If optional argument
1011 simple-first is t, first argument is already simplified."
1013 ((null simple-first)
1014 (equal (gnus-simplify-subject-fully s1)
1015 (gnus-simplify-subject-fully s2)))
1018 (gnus-simplify-subject-fully s2)))))
1020 (defun gnus-summary-bubble-group ()
1021 "Increase the score of the current group.
1022 This is a handy function to add to `gnus-summary-exit-hook' to
1023 increase the score of each group you read."
1024 (gnus-group-add-score gnus-newsgroup-name))
1028 ;;; Gnus summary mode
1031 (put 'gnus-summary-mode 'mode-class 'special)
1034 ;; Non-orthogonal keys
1036 (gnus-define-keys gnus-summary-mode-map
1037 " " gnus-summary-next-page
1038 "\177" gnus-summary-prev-page
1039 [delete] gnus-summary-prev-page
1040 "\r" gnus-summary-scroll-up
1041 "n" gnus-summary-next-unread-article
1042 "p" gnus-summary-prev-unread-article
1043 "N" gnus-summary-next-article
1044 "P" gnus-summary-prev-article
1045 "\M-\C-n" gnus-summary-next-same-subject
1046 "\M-\C-p" gnus-summary-prev-same-subject
1047 "\M-n" gnus-summary-next-unread-subject
1048 "\M-p" gnus-summary-prev-unread-subject
1049 "." gnus-summary-first-unread-article
1050 "," gnus-summary-best-unread-article
1051 "\M-s" gnus-summary-search-article-forward
1052 "\M-r" gnus-summary-search-article-backward
1053 "<" gnus-summary-beginning-of-article
1054 ">" gnus-summary-end-of-article
1055 "j" gnus-summary-goto-article
1056 "^" gnus-summary-refer-parent-article
1057 "\M-^" gnus-summary-refer-article
1058 "u" gnus-summary-tick-article-forward
1059 "!" gnus-summary-tick-article-forward
1060 "U" gnus-summary-tick-article-backward
1061 "d" gnus-summary-mark-as-read-forward
1062 "D" gnus-summary-mark-as-read-backward
1063 "E" gnus-summary-mark-as-expirable
1064 "\M-u" gnus-summary-clear-mark-forward
1065 "\M-U" gnus-summary-clear-mark-backward
1066 "k" gnus-summary-kill-same-subject-and-select
1067 "\C-k" gnus-summary-kill-same-subject
1068 "\M-\C-k" gnus-summary-kill-thread
1069 "\M-\C-l" gnus-summary-lower-thread
1070 "e" gnus-summary-edit-article
1071 "#" gnus-summary-mark-as-processable
1072 "\M-#" gnus-summary-unmark-as-processable
1073 "\M-\C-t" gnus-summary-toggle-threads
1074 "\M-\C-s" gnus-summary-show-thread
1075 "\M-\C-h" gnus-summary-hide-thread
1076 "\M-\C-f" gnus-summary-next-thread
1077 "\M-\C-b" gnus-summary-prev-thread
1078 "\M-\C-u" gnus-summary-up-thread
1079 "\M-\C-d" gnus-summary-down-thread
1080 "&" gnus-summary-execute-command
1081 "c" gnus-summary-catchup-and-exit
1082 "\C-w" gnus-summary-mark-region-as-read
1083 "\C-t" gnus-summary-toggle-truncation
1084 "?" gnus-summary-mark-as-dormant
1085 "\C-c\M-\C-s" gnus-summary-limit-include-expunged
1086 "\C-c\C-s\C-n" gnus-summary-sort-by-number
1087 "\C-c\C-s\C-l" gnus-summary-sort-by-lines
1088 "\C-c\C-s\C-a" gnus-summary-sort-by-author
1089 "\C-c\C-s\C-s" gnus-summary-sort-by-subject
1090 "\C-c\C-s\C-d" gnus-summary-sort-by-date
1091 "\C-c\C-s\C-i" gnus-summary-sort-by-score
1092 "=" gnus-summary-expand-window
1093 "\C-x\C-s" gnus-summary-reselect-current-group
1094 "\M-g" gnus-summary-rescan-group
1095 "w" gnus-summary-stop-page-breaking
1096 "\C-c\C-r" gnus-summary-caesar-message
1097 "\M-t" gnus-summary-toggle-mime
1098 "f" gnus-summary-followup
1099 "F" gnus-summary-followup-with-original
1100 "C" gnus-summary-cancel-article
1101 "r" gnus-summary-reply
1102 "R" gnus-summary-reply-with-original
1103 "\C-c\C-f" gnus-summary-mail-forward
1104 "o" gnus-summary-save-article
1105 "\C-o" gnus-summary-save-article-mail
1106 "|" gnus-summary-pipe-output
1107 "\M-k" gnus-summary-edit-local-kill
1108 "\M-K" gnus-summary-edit-global-kill
1110 "\C-c\C-d" gnus-summary-describe-group
1111 "q" gnus-summary-exit
1112 "Q" gnus-summary-exit-no-update
1113 "\C-c\C-i" gnus-info-find-node
1114 gnus-mouse-2 gnus-mouse-pick-article
1115 "m" gnus-summary-mail-other-window
1116 "a" gnus-summary-post-news
1117 "x" gnus-summary-limit-to-unread
1118 "s" gnus-summary-isearch-article
1119 "t" gnus-article-hide-headers
1120 "g" gnus-summary-show-article
1121 "l" gnus-summary-goto-last-article
1122 "\C-c\C-v\C-v" gnus-uu-decode-uu-view
1123 "\C-d" gnus-summary-enter-digest-group
1124 "\M-\C-d" gnus-summary-read-document
1126 "*" gnus-cache-enter-article
1127 "\M-*" gnus-cache-remove-article
1128 "\M-&" gnus-summary-universal-argument
1129 "\C-l" gnus-recenter
1130 "I" gnus-summary-increase-score
1131 "L" gnus-summary-lower-score
1133 "V" gnus-summary-score-map
1134 "X" gnus-uu-extract-map
1135 "S" gnus-summary-send-map)
1137 ;; Sort of orthogonal keymap
1138 (gnus-define-keys (gnus-summary-mark-map "M" gnus-summary-mode-map)
1139 "t" gnus-summary-tick-article-forward
1140 "!" gnus-summary-tick-article-forward
1141 "d" gnus-summary-mark-as-read-forward
1142 "r" gnus-summary-mark-as-read-forward
1143 "c" gnus-summary-clear-mark-forward
1144 " " gnus-summary-clear-mark-forward
1145 "e" gnus-summary-mark-as-expirable
1146 "x" gnus-summary-mark-as-expirable
1147 "?" gnus-summary-mark-as-dormant
1148 "b" gnus-summary-set-bookmark
1149 "B" gnus-summary-remove-bookmark
1150 "#" gnus-summary-mark-as-processable
1151 "\M-#" gnus-summary-unmark-as-processable
1152 "S" gnus-summary-limit-include-expunged
1153 "C" gnus-summary-catchup
1154 "H" gnus-summary-catchup-to-here
1155 "\C-c" gnus-summary-catchup-all
1156 "k" gnus-summary-kill-same-subject-and-select
1157 "K" gnus-summary-kill-same-subject
1158 "P" gnus-uu-mark-map)
1160 (gnus-define-keys (gnus-summary-mscore-map "V" gnus-summary-mark-map)
1161 "c" gnus-summary-clear-above
1162 "u" gnus-summary-tick-above
1163 "m" gnus-summary-mark-above
1164 "k" gnus-summary-kill-below)
1166 (gnus-define-keys (gnus-summary-limit-map "/" gnus-summary-mode-map)
1167 "/" gnus-summary-limit-to-subject
1168 "n" gnus-summary-limit-to-articles
1169 "w" gnus-summary-pop-limit
1170 "s" gnus-summary-limit-to-subject
1171 "a" gnus-summary-limit-to-author
1172 "u" gnus-summary-limit-to-unread
1173 "m" gnus-summary-limit-to-marks
1174 "v" gnus-summary-limit-to-score
1175 "D" gnus-summary-limit-include-dormant
1176 "d" gnus-summary-limit-exclude-dormant
1177 "t" gnus-summary-limit-to-age
1178 "E" gnus-summary-limit-include-expunged
1179 "c" gnus-summary-limit-exclude-childless-dormant
1180 "C" gnus-summary-limit-mark-excluded-as-read)
1182 (gnus-define-keys (gnus-summary-goto-map "G" gnus-summary-mode-map)
1183 "n" gnus-summary-next-unread-article
1184 "p" gnus-summary-prev-unread-article
1185 "N" gnus-summary-next-article
1186 "P" gnus-summary-prev-article
1187 "\C-n" gnus-summary-next-same-subject
1188 "\C-p" gnus-summary-prev-same-subject
1189 "\M-n" gnus-summary-next-unread-subject
1190 "\M-p" gnus-summary-prev-unread-subject
1191 "f" gnus-summary-first-unread-article
1192 "b" gnus-summary-best-unread-article
1193 "j" gnus-summary-goto-article
1194 "g" gnus-summary-goto-subject
1195 "l" gnus-summary-goto-last-article
1196 "o" gnus-summary-pop-article)
1198 (gnus-define-keys (gnus-summary-thread-map "T" gnus-summary-mode-map)
1199 "k" gnus-summary-kill-thread
1200 "l" gnus-summary-lower-thread
1201 "i" gnus-summary-raise-thread
1202 "T" gnus-summary-toggle-threads
1203 "t" gnus-summary-rethread-current
1204 "^" gnus-summary-reparent-thread
1205 "s" gnus-summary-show-thread
1206 "S" gnus-summary-show-all-threads
1207 "h" gnus-summary-hide-thread
1208 "H" gnus-summary-hide-all-threads
1209 "n" gnus-summary-next-thread
1210 "p" gnus-summary-prev-thread
1211 "u" gnus-summary-up-thread
1212 "o" gnus-summary-top-thread
1213 "d" gnus-summary-down-thread
1214 "#" gnus-uu-mark-thread
1215 "\M-#" gnus-uu-unmark-thread)
1217 (gnus-define-keys (gnus-summary-buffer-map "Y" gnus-summary-mode-map)
1218 "g" gnus-summary-prepare
1219 "c" gnus-summary-insert-cached-articles)
1221 (gnus-define-keys (gnus-summary-exit-map "Z" gnus-summary-mode-map)
1222 "c" gnus-summary-catchup-and-exit
1223 "C" gnus-summary-catchup-all-and-exit
1224 "E" gnus-summary-exit-no-update
1225 "Q" gnus-summary-exit
1226 "Z" gnus-summary-exit
1227 "n" gnus-summary-catchup-and-goto-next-group
1228 "R" gnus-summary-reselect-current-group
1229 "G" gnus-summary-rescan-group
1230 "N" gnus-summary-next-group
1231 "s" gnus-summary-save-newsrc
1232 "P" gnus-summary-prev-group)
1234 (gnus-define-keys (gnus-summary-article-map "A" gnus-summary-mode-map)
1235 " " gnus-summary-next-page
1236 "n" gnus-summary-next-page
1237 "\177" gnus-summary-prev-page
1238 [delete] gnus-summary-prev-page
1239 "p" gnus-summary-prev-page
1240 "\r" gnus-summary-scroll-up
1241 "<" gnus-summary-beginning-of-article
1242 ">" gnus-summary-end-of-article
1243 "b" gnus-summary-beginning-of-article
1244 "e" gnus-summary-end-of-article
1245 "^" gnus-summary-refer-parent-article
1246 "r" gnus-summary-refer-parent-article
1247 "R" gnus-summary-refer-references
1248 "g" gnus-summary-show-article
1249 "s" gnus-summary-isearch-article
1250 "P" gnus-summary-print-article)
1252 (gnus-define-keys (gnus-summary-wash-map "W" gnus-summary-mode-map)
1253 "b" gnus-article-add-buttons
1254 "B" gnus-article-add-buttons-to-head
1255 "o" gnus-article-treat-overstrike
1256 "e" gnus-article-emphasize
1257 "w" gnus-article-fill-cited-article
1258 "c" gnus-article-remove-cr
1259 "q" gnus-article-de-quoted-unreadable
1260 "f" gnus-article-display-x-face
1261 "l" gnus-summary-stop-page-breaking
1262 "r" gnus-summary-caesar-message
1263 "t" gnus-article-hide-headers
1264 "v" gnus-summary-verbose-headers
1265 "m" gnus-summary-toggle-mime
1266 "h" gnus-article-treat-html)
1268 (gnus-define-keys (gnus-summary-wash-hide-map "W" gnus-summary-wash-map)
1269 "a" gnus-article-hide
1270 "h" gnus-article-hide-headers
1271 "b" gnus-article-hide-boring-headers
1272 "s" gnus-article-hide-signature
1273 "c" gnus-article-hide-citation
1274 "p" gnus-article-hide-pgp
1275 "P" gnus-article-hide-pem
1276 "\C-c" gnus-article-hide-citation-maybe)
1278 (gnus-define-keys (gnus-summary-wash-highlight-map "H" gnus-summary-wash-map)
1279 "a" gnus-article-highlight
1280 "h" gnus-article-highlight-headers
1281 "c" gnus-article-highlight-citation
1282 "s" gnus-article-highlight-signature)
1284 (gnus-define-keys (gnus-summary-wash-time-map "T" gnus-summary-wash-map)
1285 "z" gnus-article-date-ut
1286 "u" gnus-article-date-ut
1287 "l" gnus-article-date-local
1288 "e" gnus-article-date-lapsed
1289 "o" gnus-article-date-original
1290 "s" gnus-article-date-user)
1292 (gnus-define-keys (gnus-summary-wash-empty-map "E" gnus-summary-wash-map)
1293 "t" gnus-article-remove-trailing-blank-lines
1294 "l" gnus-article-strip-leading-blank-lines
1295 "m" gnus-article-strip-multiple-blank-lines
1296 "a" gnus-article-strip-blank-lines
1297 "s" gnus-article-strip-leading-space)
1299 (gnus-define-keys (gnus-summary-help-map "H" gnus-summary-mode-map)
1301 "f" gnus-summary-fetch-faq
1302 "d" gnus-summary-describe-group
1303 "h" gnus-summary-describe-briefly
1304 "i" gnus-info-find-node)
1306 (gnus-define-keys (gnus-summary-backend-map "B" gnus-summary-mode-map)
1307 "e" gnus-summary-expire-articles
1308 "\M-\C-e" gnus-summary-expire-articles-now
1309 "\177" gnus-summary-delete-article
1310 [delete] gnus-summary-delete-article
1311 "m" gnus-summary-move-article
1312 "r" gnus-summary-respool-article
1313 "w" gnus-summary-edit-article
1314 "c" gnus-summary-copy-article
1315 "B" gnus-summary-crosspost-article
1316 "q" gnus-summary-respool-query
1317 "i" gnus-summary-import-article
1318 "p" gnus-summary-article-posted-p)
1320 (gnus-define-keys (gnus-summary-save-map "O" gnus-summary-mode-map)
1321 "o" gnus-summary-save-article
1322 "m" gnus-summary-save-article-mail
1323 "F" gnus-summary-write-article-file
1324 "r" gnus-summary-save-article-rmail
1325 "f" gnus-summary-save-article-file
1326 "b" gnus-summary-save-article-body-file
1327 "h" gnus-summary-save-article-folder
1328 "v" gnus-summary-save-article-vm
1329 "p" gnus-summary-pipe-output
1330 "s" gnus-soup-add-article))
1332 (defun gnus-summary-make-menu-bar ()
1333 (gnus-turn-off-edit-menu 'summary)
1335 (unless (boundp 'gnus-summary-misc-menu)
1338 gnus-summary-kill-menu gnus-summary-mode-map ""
1343 ["Enter score..." gnus-summary-score-entry t]
1344 ["Customize" gnus-score-customize t])
1345 (gnus-make-score-map 'increase)
1346 (gnus-make-score-map 'lower)
1348 ["Kill below" gnus-summary-kill-below t]
1349 ["Mark above" gnus-summary-mark-above t]
1350 ["Tick above" gnus-summary-tick-above t]
1351 ["Clear above" gnus-summary-clear-above t])
1352 ["Current score" gnus-summary-current-score t]
1353 ["Set score" gnus-summary-set-score t]
1354 ["Switch current score file..." gnus-score-change-score-file t]
1355 ["Set mark below..." gnus-score-set-mark-below t]
1356 ["Set expunge below..." gnus-score-set-expunge-below t]
1357 ["Edit current score file" gnus-score-edit-current-scores t]
1358 ["Edit score file" gnus-score-edit-file t]
1359 ["Trace score" gnus-score-find-trace t]
1360 ["Find words" gnus-score-find-favourite-words t]
1361 ["Rescore buffer" gnus-summary-rescore t]
1362 ["Increase score..." gnus-summary-increase-score t]
1363 ["Lower score..." gnus-summary-lower-score t]))))
1366 ["Ask" (gnus-score-set-default 'gnus-score-default-header nil)
1368 :selected (null gnus-score-default-header)]
1369 ["From" (gnus-score-set-default 'gnus-score-default-header 'a)
1371 :selected (eq gnus-score-default-header 'a)]
1372 ["Subject" (gnus-score-set-default 'gnus-score-default-header 's)
1374 :selected (eq gnus-score-default-header 's)]
1376 (gnus-score-set-default 'gnus-score-default-header 'b)
1378 :selected (eq gnus-score-default-header 'b )]
1380 (gnus-score-set-default 'gnus-score-default-header 'h)
1382 :selected (eq gnus-score-default-header 'h )]
1383 ["Message-ID" (gnus-score-set-default 'gnus-score-default-header 'i)
1385 :selected (eq gnus-score-default-header 'i )]
1386 ["Thread" (gnus-score-set-default 'gnus-score-default-header 't)
1388 :selected (eq gnus-score-default-header 't )]
1390 (gnus-score-set-default 'gnus-score-default-header 'x)
1392 :selected (eq gnus-score-default-header 'x )]
1393 ["Lines" (gnus-score-set-default 'gnus-score-default-header 'l)
1395 :selected (eq gnus-score-default-header 'l )]
1396 ["Date" (gnus-score-set-default 'gnus-score-default-header 'd)
1398 :selected (eq gnus-score-default-header 'd )]
1399 ["Followups to author"
1400 (gnus-score-set-default 'gnus-score-default-header 'f)
1402 :selected (eq gnus-score-default-header 'f )])
1404 ["Ask" (gnus-score-set-default 'gnus-score-default-type nil)
1406 :selected (null gnus-score-default-type)]
1407 ;; The `:active' key is commented out in the following,
1408 ;; because the GNU Emacs hack to support radio buttons use
1409 ;; active to indicate which button is selected.
1410 ["Substring" (gnus-score-set-default 'gnus-score-default-type 's)
1412 ;; :active (not (memq gnus-score-default-header '(l d)))
1413 :selected (eq gnus-score-default-type 's)]
1414 ["Regexp" (gnus-score-set-default 'gnus-score-default-type 'r)
1416 ;; :active (not (memq gnus-score-default-header '(l d)))
1417 :selected (eq gnus-score-default-type 'r)]
1418 ["Exact" (gnus-score-set-default 'gnus-score-default-type 'e)
1420 ;; :active (not (memq gnus-score-default-header '(l d)))
1421 :selected (eq gnus-score-default-type 'e)]
1422 ["Fuzzy" (gnus-score-set-default 'gnus-score-default-type 'f)
1424 ;; :active (not (memq gnus-score-default-header '(l d)))
1425 :selected (eq gnus-score-default-type 'f)]
1426 ["Before date" (gnus-score-set-default 'gnus-score-default-type 'b)
1428 ;; :active (eq (gnus-score-default-header 'd))
1429 :selected (eq gnus-score-default-type 'b)]
1430 ["At date" (gnus-score-set-default 'gnus-score-default-type 'n)
1432 ;; :active (eq (gnus-score-default-header 'd))
1433 :selected (eq gnus-score-default-type 'n)]
1434 ["After date" (gnus-score-set-default 'gnus-score-default-type 'a)
1436 ;; :active (eq (gnus-score-default-header 'd))
1437 :selected (eq gnus-score-default-type 'a)]
1439 (gnus-score-set-default 'gnus-score-default-type '<)
1441 ;; :active (eq (gnus-score-default-header 'l))
1442 :selected (eq gnus-score-default-type '<)]
1444 (gnus-score-set-default 'gnus-score-default-type '=)
1446 ;; :active (eq (gnus-score-default-header 'l))
1447 :selected (eq gnus-score-default-type '=)]
1448 ["Greater than number"
1449 (gnus-score-set-default 'gnus-score-default-type '>)
1451 ;; :active (eq (gnus-score-default-header 'l))
1452 :selected (eq gnus-score-default-type '>)])
1453 ["Default fold" gnus-score-default-fold-toggle
1455 :selected gnus-score-default-fold]
1457 ["Ask" (gnus-score-set-default 'gnus-score-default-duration nil)
1459 :selected (null gnus-score-default-duration)]
1461 (gnus-score-set-default 'gnus-score-default-duration 'p)
1463 :selected (eq gnus-score-default-duration 'p)]
1465 (gnus-score-set-default 'gnus-score-default-duration 't)
1467 :selected (eq gnus-score-default-duration 't)]
1469 (gnus-score-set-default 'gnus-score-default-duration 'i)
1471 :selected (eq gnus-score-default-duration 'i)]))
1474 gnus-summary-article-menu gnus-summary-mode-map ""
1477 ["All" gnus-article-hide t]
1478 ["Headers" gnus-article-hide-headers t]
1479 ["Signature" gnus-article-hide-signature t]
1480 ["Citation" gnus-article-hide-citation t]
1481 ["PGP" gnus-article-hide-pgp t]
1482 ["Boring headers" gnus-article-hide-boring-headers t])
1484 ["All" gnus-article-highlight t]
1485 ["Headers" gnus-article-highlight-headers t]
1486 ["Signature" gnus-article-highlight-signature t]
1487 ["Citation" gnus-article-highlight-citation t])
1489 ["Local" gnus-article-date-local t]
1490 ["UT" gnus-article-date-ut t]
1491 ["Original" gnus-article-date-original t]
1492 ["Lapsed" gnus-article-date-lapsed t]
1493 ["User-defined" gnus-article-date-user t])
1496 ["Leading" gnus-article-strip-leading-blank-lines t]
1497 ["Multiple" gnus-article-strip-multiple-blank-lines t]
1498 ["Trailing" gnus-article-remove-trailing-blank-lines t]
1499 ["All of the above" gnus-article-strip-blank-lines t]
1500 ["Leading space" gnus-article-strip-leading-space t])
1501 ["Overstrike" gnus-article-treat-overstrike t]
1502 ["Emphasis" gnus-article-emphasize t]
1503 ["Word wrap" gnus-article-fill-cited-article t]
1504 ["CR" gnus-article-remove-cr t]
1505 ["Show X-Face" gnus-article-display-x-face t]
1506 ["Quoted-Printable" gnus-article-de-quoted-unreadable t]
1507 ["UnHTMLize" gnus-article-treat-html t]
1508 ["Rot 13" gnus-summary-caesar-message t]
1509 ["Unix pipe" gnus-summary-pipe-message t]
1510 ["Add buttons" gnus-article-add-buttons t]
1511 ["Add buttons to head" gnus-article-add-buttons-to-head t]
1512 ["Stop page breaking" gnus-summary-stop-page-breaking t]
1513 ["Toggle MIME" gnus-summary-toggle-mime t]
1514 ["Verbose header" gnus-summary-verbose-headers t]
1515 ["Toggle header" gnus-summary-toggle-header t])
1517 ["Save in default format" gnus-summary-save-article t]
1518 ["Save in file" gnus-summary-save-article-file t]
1519 ["Save in Unix mail format" gnus-summary-save-article-mail t]
1520 ["Write to file" gnus-summary-write-article-mail t]
1521 ["Save in MH folder" gnus-summary-save-article-folder t]
1522 ["Save in VM folder" gnus-summary-save-article-vm t]
1523 ["Save in RMAIL mbox" gnus-summary-save-article-rmail t]
1524 ["Save body in file" gnus-summary-save-article-body-file t]
1525 ["Pipe through a filter" gnus-summary-pipe-output t]
1526 ["Add to SOUP packet" gnus-soup-add-article t]
1527 ["Print" gnus-summary-print-article t])
1529 ["Respool article..." gnus-summary-respool-article t]
1530 ["Move article..." gnus-summary-move-article
1531 (gnus-check-backend-function
1532 'request-move-article gnus-newsgroup-name)]
1533 ["Copy article..." gnus-summary-copy-article t]
1534 ["Crosspost article..." gnus-summary-crosspost-article
1535 (gnus-check-backend-function
1536 'request-replace-article gnus-newsgroup-name)]
1537 ["Import file..." gnus-summary-import-article t]
1538 ["Check if posted" gnus-summary-article-posted-p t]
1539 ["Edit article" gnus-summary-edit-article
1540 (not (gnus-group-read-only-p))]
1541 ["Delete article" gnus-summary-delete-article
1542 (gnus-check-backend-function
1543 'request-expire-articles gnus-newsgroup-name)]
1544 ["Query respool" gnus-summary-respool-query t]
1545 ["Delete expirable articles" gnus-summary-expire-articles-now
1546 (gnus-check-backend-function
1547 'request-expire-articles gnus-newsgroup-name)])
1549 ["Uudecode" gnus-uu-decode-uu t]
1550 ["Uudecode and save" gnus-uu-decode-uu-and-save t]
1551 ["Unshar" gnus-uu-decode-unshar t]
1552 ["Unshar and save" gnus-uu-decode-unshar-and-save t]
1553 ["Save" gnus-uu-decode-save t]
1554 ["Binhex" gnus-uu-decode-binhex t]
1555 ["Postscript" gnus-uu-decode-postscript t])
1557 ["Enter article" gnus-cache-enter-article t]
1558 ["Remove article" gnus-cache-remove-article t])
1559 ["Enter digest buffer" gnus-summary-enter-digest-group t]
1560 ["Isearch article..." gnus-summary-isearch-article t]
1561 ["Beginning of the article" gnus-summary-beginning-of-article t]
1562 ["End of the article" gnus-summary-end-of-article t]
1563 ["Fetch parent of article" gnus-summary-refer-parent-article t]
1564 ["Fetch referenced articles" gnus-summary-refer-references t]
1565 ["Fetch article with id..." gnus-summary-refer-article t]
1566 ["Redisplay" gnus-summary-show-article t]))
1569 gnus-summary-thread-menu gnus-summary-mode-map ""
1571 ["Toggle threading" gnus-summary-toggle-threads t]
1572 ["Hide threads" gnus-summary-hide-all-threads t]
1573 ["Show threads" gnus-summary-show-all-threads t]
1574 ["Hide thread" gnus-summary-hide-thread t]
1575 ["Show thread" gnus-summary-show-thread t]
1576 ["Go to next thread" gnus-summary-next-thread t]
1577 ["Go to previous thread" gnus-summary-prev-thread t]
1578 ["Go down thread" gnus-summary-down-thread t]
1579 ["Go up thread" gnus-summary-up-thread t]
1580 ["Top of thread" gnus-summary-top-thread t]
1581 ["Mark thread as read" gnus-summary-kill-thread t]
1582 ["Lower thread score" gnus-summary-lower-thread t]
1583 ["Raise thread score" gnus-summary-raise-thread t]
1584 ["Rethread current" gnus-summary-rethread-current t]
1588 gnus-summary-post-menu gnus-summary-mode-map ""
1590 ["Post an article" gnus-summary-post-news t]
1591 ["Followup" gnus-summary-followup t]
1592 ["Followup and yank" gnus-summary-followup-with-original t]
1593 ["Supersede article" gnus-summary-supersede-article t]
1594 ["Cancel article" gnus-summary-cancel-article t]
1595 ["Reply" gnus-summary-reply t]
1596 ["Reply and yank" gnus-summary-reply-with-original t]
1597 ["Wide reply" gnus-summary-wide-reply t]
1598 ["Wide reply and yank" gnus-summary-wide-reply-with-original t]
1599 ["Mail forward" gnus-summary-mail-forward t]
1600 ["Post forward" gnus-summary-post-forward t]
1601 ["Digest and mail" gnus-uu-digest-mail-forward t]
1602 ["Digest and post" gnus-uu-digest-post-forward t]
1603 ["Resend message" gnus-summary-resend-message t]
1604 ["Send bounced mail" gnus-summary-resend-bounced-mail t]
1605 ["Send a mail" gnus-summary-mail-other-window t]
1606 ["Uuencode and post" gnus-uu-post-news t]
1607 ["Followup via news" gnus-summary-followup-to-mail t]
1608 ["Followup via news and yank"
1609 gnus-summary-followup-to-mail-with-original t]
1611 ;;["Send" gnus-summary-send-draft t]
1612 ;;["Send bounced" gnus-resend-bounced-mail t])
1616 gnus-summary-misc-menu gnus-summary-mode-map ""
1619 ["Mark as read" gnus-summary-mark-as-read-forward t]
1620 ["Mark same subject and select"
1621 gnus-summary-kill-same-subject-and-select t]
1622 ["Mark same subject" gnus-summary-kill-same-subject t]
1623 ["Catchup" gnus-summary-catchup t]
1624 ["Catchup all" gnus-summary-catchup-all t]
1625 ["Catchup to here" gnus-summary-catchup-to-here t]
1626 ["Catchup region" gnus-summary-mark-region-as-read t]
1627 ["Mark excluded" gnus-summary-limit-mark-excluded-as-read t])
1629 ["Tick" gnus-summary-tick-article-forward t]
1630 ["Mark as dormant" gnus-summary-mark-as-dormant t]
1631 ["Remove marks" gnus-summary-clear-mark-forward t]
1632 ["Set expirable mark" gnus-summary-mark-as-expirable t]
1633 ["Set bookmark" gnus-summary-set-bookmark t]
1634 ["Remove bookmark" gnus-summary-remove-bookmark t])
1636 ["Marks..." gnus-summary-limit-to-marks t]
1637 ["Subject..." gnus-summary-limit-to-subject t]
1638 ["Author..." gnus-summary-limit-to-author t]
1639 ["Age..." gnus-summary-limit-to-age t]
1640 ["Score" gnus-summary-limit-to-score t]
1641 ["Unread" gnus-summary-limit-to-unread t]
1642 ["Non-dormant" gnus-summary-limit-exclude-dormant t]
1643 ["Articles" gnus-summary-limit-to-articles t]
1644 ["Pop limit" gnus-summary-pop-limit t]
1645 ["Show dormant" gnus-summary-limit-include-dormant t]
1646 ["Hide childless dormant"
1647 gnus-summary-limit-exclude-childless-dormant t]
1648 ;;["Hide thread" gnus-summary-limit-exclude-thread t]
1649 ["Show expunged" gnus-summary-show-all-expunged t])
1651 ["Set mark" gnus-summary-mark-as-processable t]
1652 ["Remove mark" gnus-summary-unmark-as-processable t]
1653 ["Remove all marks" gnus-summary-unmark-all-processable t]
1654 ["Mark above" gnus-uu-mark-over t]
1655 ["Mark series" gnus-uu-mark-series t]
1656 ["Mark region" gnus-uu-mark-region t]
1657 ["Mark by regexp..." gnus-uu-mark-by-regexp t]
1658 ["Mark all" gnus-uu-mark-all t]
1659 ["Mark buffer" gnus-uu-mark-buffer t]
1660 ["Mark sparse" gnus-uu-mark-sparse t]
1661 ["Mark thread" gnus-uu-mark-thread t]
1662 ["Unmark thread" gnus-uu-unmark-thread t]
1663 ("Process Mark Sets"
1664 ["Kill" gnus-summary-kill-process-mark t]
1665 ["Yank" gnus-summary-yank-process-mark
1666 gnus-newsgroup-process-stack]
1667 ["Save" gnus-summary-save-process-mark t]))
1669 ["Page forward" gnus-summary-next-page t]
1670 ["Page backward" gnus-summary-prev-page t]
1671 ["Line forward" gnus-summary-scroll-up t])
1673 ["Next unread article" gnus-summary-next-unread-article t]
1674 ["Previous unread article" gnus-summary-prev-unread-article t]
1675 ["Next article" gnus-summary-next-article t]
1676 ["Previous article" gnus-summary-prev-article t]
1677 ["Next unread subject" gnus-summary-next-unread-subject t]
1678 ["Previous unread subject" gnus-summary-prev-unread-subject t]
1679 ["Next article same subject" gnus-summary-next-same-subject t]
1680 ["Previous article same subject" gnus-summary-prev-same-subject t]
1681 ["First unread article" gnus-summary-first-unread-article t]
1682 ["Best unread article" gnus-summary-best-unread-article t]
1683 ["Go to subject number..." gnus-summary-goto-subject t]
1684 ["Go to article number..." gnus-summary-goto-article t]
1685 ["Go to the last article" gnus-summary-goto-last-article t]
1686 ["Pop article off history" gnus-summary-pop-article t])
1688 ["Sort by number" gnus-summary-sort-by-number t]
1689 ["Sort by author" gnus-summary-sort-by-author t]
1690 ["Sort by subject" gnus-summary-sort-by-subject t]
1691 ["Sort by date" gnus-summary-sort-by-date t]
1692 ["Sort by score" gnus-summary-sort-by-score t]
1693 ["Sort by lines" gnus-summary-sort-by-lines t])
1695 ["Fetch group FAQ" gnus-summary-fetch-faq t]
1696 ["Describe group" gnus-summary-describe-group t]
1697 ["Read manual" gnus-info-find-node t])
1699 ["Pick and read" gnus-pick-mode t]
1700 ["Binary" gnus-binary-mode t])
1702 ["Regenerate" gnus-summary-prepare t]
1703 ["Insert cached articles" gnus-summary-insert-cached-articles t]
1704 ["Toggle threading" gnus-summary-toggle-threads t])
1705 ["Filter articles..." gnus-summary-execute-command t]
1706 ["Run command on subjects..." gnus-summary-universal-argument t]
1707 ["Search articles forward..." gnus-summary-search-article-forward t]
1708 ["Search articles backward..." gnus-summary-search-article-backward t]
1709 ["Toggle line truncation" gnus-summary-toggle-truncation t]
1710 ["Expand window" gnus-summary-expand-window t]
1711 ["Expire expirable articles" gnus-summary-expire-articles
1712 (gnus-check-backend-function
1713 'request-expire-articles gnus-newsgroup-name)]
1714 ["Edit local kill file" gnus-summary-edit-local-kill t]
1715 ["Edit main kill file" gnus-summary-edit-global-kill t]
1717 ["Catchup and exit" gnus-summary-catchup-and-exit t]
1718 ["Catchup all and exit" gnus-summary-catchup-and-exit t]
1719 ["Catchup and goto next" gnus-summary-catchup-and-goto-next-group t]
1720 ["Exit group" gnus-summary-exit t]
1721 ["Exit group without updating" gnus-summary-exit-no-update t]
1722 ["Exit and goto next group" gnus-summary-next-group t]
1723 ["Exit and goto prev group" gnus-summary-prev-group t]
1724 ["Reselect group" gnus-summary-reselect-current-group t]
1725 ["Rescan group" gnus-summary-rescan-group t]
1726 ["Update dribble" gnus-summary-save-newsrc t])))
1728 (run-hooks 'gnus-summary-menu-hook)))
1730 (defun gnus-score-set-default (var value)
1731 "A version of set that updates the GNU Emacs menu-bar."
1733 ;; It is the message that forces the active status to be updated.
1736 (defun gnus-make-score-map (type)
1737 "Make a summary score map of type TYPE."
1740 (let ((headers '(("author" "from" string)
1741 ("subject" "subject" string)
1742 ("article body" "body" string)
1743 ("article head" "head" string)
1744 ("xref" "xref" string)
1745 ("lines" "lines" number)
1746 ("followups to author" "followup" string)))
1747 (types '((number ("less than" <)
1750 (string ("substring" s)
1754 (perms '(("temporary" (current-time-string))
1762 (if (eq type 'lower)
1767 (setq header (car headers))
1773 (let ((ts (cdr (assoc (nth 2 header) types)))
1789 'gnus-summary-score-entry
1791 (if (or (string= (nth 1 header)
1793 (string= (nth 1 header)
1796 (list 'gnus-summary-header
1798 (list 'quote (nth 1 (car ts)))
1799 (list 'gnus-score-default nil)
1805 (list (nreverse outp))))
1808 (list (nreverse outt))))
1810 (setq headers (cdr headers)))
1811 (list (nreverse outh))))))))
1815 (defun gnus-summary-mode (&optional group)
1816 "Major mode for reading articles.
1818 All normal editing commands are switched off.
1819 \\<gnus-summary-mode-map>
1820 Each line in this buffer represents one article. To read an
1821 article, you can, for instance, type `\\[gnus-summary-next-page]'. To move forwards
1822 and backwards while displaying articles, type `\\[gnus-summary-next-unread-article]' and `\\[gnus-summary-prev-unread-article]',
1825 You can also post articles and send mail from this buffer. To
1826 follow up an article, type `\\[gnus-summary-followup]'. To mail a reply to the author
1827 of an article, type `\\[gnus-summary-reply]'.
1829 There are approx. one gazillion commands you can execute in this
1830 buffer; read the info pages for more information (`\\[gnus-info-find-node]').
1832 The following commands are available:
1834 \\{gnus-summary-mode-map}"
1836 (when (gnus-visual-p 'summary-menu 'menu)
1837 (gnus-summary-make-menu-bar))
1838 (kill-all-local-variables)
1839 (gnus-summary-make-local-variables)
1840 (gnus-make-thread-indent-array)
1841 (gnus-simplify-mode-line)
1842 (setq major-mode 'gnus-summary-mode)
1843 (setq mode-name "Summary")
1844 (make-local-variable 'minor-mode-alist)
1845 (use-local-map gnus-summary-mode-map)
1846 (buffer-disable-undo (current-buffer))
1847 (setq buffer-read-only t) ;Disable modification
1848 (setq truncate-lines t)
1849 (setq selective-display t)
1850 (setq selective-display-ellipses t) ;Display `...'
1851 (gnus-summary-set-display-table)
1852 (gnus-set-default-directory)
1853 (setq gnus-newsgroup-name group)
1854 (make-local-variable 'gnus-summary-line-format)
1855 (make-local-variable 'gnus-summary-line-format-spec)
1856 (make-local-variable 'gnus-summary-mark-positions)
1857 (make-local-hook 'post-command-hook)
1858 (add-hook 'post-command-hook 'gnus-clear-inboxes-moved nil t)
1859 (run-hooks 'gnus-summary-mode-hook)
1860 (gnus-update-format-specifications nil 'summary 'summary-mode 'summary-dummy)
1861 (gnus-update-summary-mark-positions))
1863 (defun gnus-summary-make-local-variables ()
1864 "Make all the local summary buffer variables."
1865 (let ((locals gnus-summary-local-variables)
1867 (while (setq local (pop locals))
1870 (if (eq (cdr local) 'global)
1871 ;; Copy the global value of the variable.
1872 (setq global (symbol-value (car local)))
1873 ;; Use the value from the list.
1874 (setq global (eval (cdr local))))
1875 (make-local-variable (car local))
1876 (set (car local) global))
1877 ;; Simple nil-valued local variable.
1878 (make-local-variable local)
1881 (defun gnus-summary-clear-local-variables ()
1882 (let ((locals gnus-summary-local-variables))
1884 (if (consp (car locals))
1885 (and (vectorp (caar locals))
1886 (set (caar locals) nil))
1887 (and (vectorp (car locals))
1888 (set (car locals) nil)))
1889 (setq locals (cdr locals)))))
1891 ;; Summary data functions.
1893 (defmacro gnus-data-number (data)
1896 (defmacro gnus-data-set-number (data number)
1897 `(setcar ,data ,number))
1899 (defmacro gnus-data-mark (data)
1902 (defmacro gnus-data-set-mark (data mark)
1903 `(setcar (nthcdr 1 ,data) ,mark))
1905 (defmacro gnus-data-pos (data)
1908 (defmacro gnus-data-set-pos (data pos)
1909 `(setcar (nthcdr 2 ,data) ,pos))
1911 (defmacro gnus-data-header (data)
1914 (defmacro gnus-data-set-header (data header)
1915 `(setf (nth 3 ,data) ,header))
1917 (defmacro gnus-data-level (data)
1920 (defmacro gnus-data-unread-p (data)
1921 `(= (nth 1 ,data) gnus-unread-mark))
1923 (defmacro gnus-data-read-p (data)
1924 `(/= (nth 1 ,data) gnus-unread-mark))
1926 (defmacro gnus-data-pseudo-p (data)
1927 `(consp (nth 3 ,data)))
1929 (defmacro gnus-data-find (number)
1930 `(assq ,number gnus-newsgroup-data))
1932 (defmacro gnus-data-find-list (number &optional data)
1933 `(let ((bdata ,(or data 'gnus-newsgroup-data)))
1934 (memq (assq ,number bdata)
1937 (defmacro gnus-data-make (number mark pos header level)
1938 `(list ,number ,mark ,pos ,header ,level))
1940 (defun gnus-data-enter (after-article number mark pos header level offset)
1941 (let ((data (gnus-data-find-list after-article)))
1943 (error "No such article: %d" after-article))
1944 (setcdr data (cons (gnus-data-make number mark pos header level)
1946 (setq gnus-newsgroup-data-reverse nil)
1947 (gnus-data-update-list (cddr data) offset)))
1949 (defun gnus-data-enter-list (after-article list &optional offset)
1951 (let ((data (and after-article (gnus-data-find-list after-article)))
1953 (or data (not after-article) (error "No such article: %d" after-article))
1954 ;; Find the last element in the list to be spliced into the main
1957 (setq list (cdr list)))
1960 (setcdr list gnus-newsgroup-data)
1961 (setq gnus-newsgroup-data ilist)
1963 (gnus-data-update-list (cdr list) offset)))
1964 (setcdr list (cdr data))
1967 (gnus-data-update-list (cdr list) offset)))
1968 (setq gnus-newsgroup-data-reverse nil))))
1970 (defun gnus-data-remove (article &optional offset)
1971 (let ((data gnus-newsgroup-data))
1972 (if (= (gnus-data-number (car data)) article)
1974 (setq gnus-newsgroup-data (cdr gnus-newsgroup-data)
1975 gnus-newsgroup-data-reverse nil)
1977 (gnus-data-update-list gnus-newsgroup-data offset)))
1979 (when (= (gnus-data-number (cadr data)) article)
1980 (setcdr data (cddr data))
1982 (gnus-data-update-list (cdr data) offset))
1984 gnus-newsgroup-data-reverse nil))
1985 (setq data (cdr data))))))
1987 (defmacro gnus-data-list (backward)
1989 (or gnus-newsgroup-data-reverse
1990 (setq gnus-newsgroup-data-reverse
1991 (reverse gnus-newsgroup-data)))
1992 gnus-newsgroup-data))
1994 (defun gnus-data-update-list (data offset)
1995 "Add OFFSET to the POS of all data entries in DATA."
1997 (setcar (nthcdr 2 (car data)) (+ offset (nth 2 (car data))))
1998 (setq data (cdr data))))
2000 (defun gnus-data-compute-positions ()
2001 "Compute the positions of all articles."
2002 (let ((data gnus-newsgroup-data)
2005 (when (setq pos (text-property-any
2006 (point-min) (point-max)
2007 'gnus-number (gnus-data-number (car data))))
2008 (gnus-data-set-pos (car data) (+ pos 3)))
2009 (setq data (cdr data)))))
2011 (defun gnus-summary-article-pseudo-p (article)
2012 "Say whether this article is a pseudo article or not."
2013 (not (vectorp (gnus-data-header (gnus-data-find article)))))
2015 (defmacro gnus-summary-article-sparse-p (article)
2016 "Say whether this article is a sparse article or not."
2017 `(memq ,article gnus-newsgroup-sparse))
2019 (defmacro gnus-summary-article-ancient-p (article)
2020 "Say whether this article is a sparse article or not."
2021 `(memq ,article gnus-newsgroup-ancient))
2023 (defun gnus-article-parent-p (number)
2024 "Say whether this article is a parent or not."
2025 (let ((data (gnus-data-find-list number)))
2026 (and (cdr data) ; There has to be an article after...
2027 (< (gnus-data-level (car data)) ; And it has to have a higher level.
2028 (gnus-data-level (nth 1 data))))))
2030 (defun gnus-article-children (number)
2031 "Return a list of all children to NUMBER."
2032 (let* ((data (gnus-data-find-list number))
2033 (level (gnus-data-level (car data)))
2035 (setq data (cdr data))
2037 (= (gnus-data-level (car data)) (1+ level)))
2038 (push (gnus-data-number (car data)) children)
2039 (setq data (cdr data)))
2042 (defmacro gnus-summary-skip-intangible ()
2043 "If the current article is intangible, then jump to a different article."
2044 '(let ((to (get-text-property (point) 'gnus-intangible)))
2045 (and to (gnus-summary-goto-subject to))))
2047 (defmacro gnus-summary-article-intangible-p ()
2048 "Say whether this article is intangible or not."
2049 '(get-text-property (point) 'gnus-intangible))
2051 (defun gnus-article-read-p (article)
2052 "Say whether ARTICLE is read or not."
2053 (not (or (memq article gnus-newsgroup-marked)
2054 (memq article gnus-newsgroup-unreads)
2055 (memq article gnus-newsgroup-unselected)
2056 (memq article gnus-newsgroup-dormant))))
2058 ;; Some summary mode macros.
2060 (defmacro gnus-summary-article-number ()
2061 "The article number of the article on the current line.
2062 If there isn's an article number here, then we return the current
2065 (gnus-summary-skip-intangible)
2066 (or (get-text-property (point) 'gnus-number)
2067 (gnus-summary-last-subject))))
2069 (defmacro gnus-summary-article-header (&optional number)
2070 `(gnus-data-header (gnus-data-find
2071 ,(or number '(gnus-summary-article-number)))))
2073 (defmacro gnus-summary-thread-level (&optional number)
2074 `(if (and (eq gnus-summary-make-false-root 'dummy)
2075 (get-text-property (point) 'gnus-intangible))
2077 (gnus-data-level (gnus-data-find
2078 ,(or number '(gnus-summary-article-number))))))
2080 (defmacro gnus-summary-article-mark (&optional number)
2081 `(gnus-data-mark (gnus-data-find
2082 ,(or number '(gnus-summary-article-number)))))
2084 (defmacro gnus-summary-article-pos (&optional number)
2085 `(gnus-data-pos (gnus-data-find
2086 ,(or number '(gnus-summary-article-number)))))
2088 (defalias 'gnus-summary-subject-string 'gnus-summary-article-subject)
2089 (defmacro gnus-summary-article-subject (&optional number)
2090 "Return current subject string or nil if nothing."
2093 `(gnus-data-header (assq ,number gnus-newsgroup-data))
2094 '(gnus-data-header (assq (gnus-summary-article-number)
2095 gnus-newsgroup-data)))))
2098 (mail-header-subject headers))))
2100 (defmacro gnus-summary-article-score (&optional number)
2101 "Return current article score."
2102 `(or (cdr (assq ,(or number '(gnus-summary-article-number))
2103 gnus-newsgroup-scored))
2104 gnus-summary-default-score 0))
2106 (defun gnus-summary-article-children (&optional number)
2107 (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))))
2108 (level (gnus-data-level (car data)))
2110 (while (and (setq data (cdr data))
2111 (> (setq l (gnus-data-level (car data))) level))
2112 (and (= (1+ level) l)
2113 (push (gnus-data-number (car data))
2115 (nreverse children)))
2117 (defun gnus-summary-article-parent (&optional number)
2118 (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))
2119 (gnus-data-list t)))
2120 (level (gnus-data-level (car data))))
2122 () ; This is a root.
2123 ;; We search until we find an article with a level less than
2124 ;; this one. That function has to be the parent.
2125 (while (and (setq data (cdr data))
2126 (not (< (gnus-data-level (car data)) level))))
2127 (and data (gnus-data-number (car data))))))
2129 (defun gnus-unread-mark-p (mark)
2130 "Say whether MARK is the unread mark."
2131 (= mark gnus-unread-mark))
2133 (defun gnus-read-mark-p (mark)
2134 "Say whether MARK is one of the marks that mark as read.
2135 This is all marks except unread, ticked, dormant, and expirable."
2136 (not (or (= mark gnus-unread-mark)
2137 (= mark gnus-ticked-mark)
2138 (= mark gnus-dormant-mark)
2139 (= mark gnus-expirable-mark))))
2141 (defmacro gnus-article-mark (number)
2143 ((memq ,number gnus-newsgroup-unreads) gnus-unread-mark)
2144 ((memq ,number gnus-newsgroup-marked) gnus-ticked-mark)
2145 ((memq ,number gnus-newsgroup-dormant) gnus-dormant-mark)
2146 ((memq ,number gnus-newsgroup-expirable) gnus-expirable-mark)
2147 (t (or (cdr (assq ,number gnus-newsgroup-reads))
2148 gnus-ancient-mark))))
2150 ;; Saving hidden threads.
2152 (put 'gnus-save-hidden-threads 'lisp-indent-function 0)
2153 (put 'gnus-save-hidden-threads 'edebug-form-spec '(body))
2155 (defmacro gnus-save-hidden-threads (&rest forms)
2156 "Save hidden threads, eval FORMS, and restore the hidden threads."
2157 (let ((config (make-symbol "config")))
2158 `(let ((,config (gnus-hidden-threads-configuration)))
2162 (gnus-restore-hidden-threads-configuration ,config)))))
2164 (defun gnus-hidden-threads-configuration ()
2165 "Return the current hidden threads configuration."
2168 (goto-char (point-min))
2169 (while (search-forward "\r" nil t)
2170 (push (1- (point)) config))
2173 (defun gnus-restore-hidden-threads-configuration (config)
2174 "Restore hidden threads configuration from CONFIG."
2175 (let (point buffer-read-only)
2176 (while (setq point (pop config))
2177 (when (and (< point (point-max))
2179 (= (following-char) ?\n))
2180 (subst-char-in-region point (1+ point) ?\n ?\r)))))
2182 ;; Various summary mode internalish functions.
2184 (defun gnus-mouse-pick-article (e)
2187 (gnus-summary-next-page nil t))
2189 (defun gnus-summary-set-display-table ()
2190 ;; Change the display table. Odd characters have a tendency to mess
2191 ;; up nicely formatted displays - we make all possible glyphs
2192 ;; display only a single character.
2194 ;; We start from the standard display table, if any.
2195 (let ((table (or (copy-sequence standard-display-table)
2196 (make-display-table)))
2198 ;; Nix out all the control chars...
2199 (while (>= (setq i (1- i)) 0)
2200 (aset table i [??]))
2201 ;; ... but not newline and cr, of course. (cr is necessary for the
2202 ;; selective display).
2203 (aset table ?\n nil)
2204 (aset table ?\r nil)
2205 ;; We nix out any glyphs over 126 that are not set already.
2207 (while (>= (setq i (1- i)) 127)
2208 ;; Only modify if the entry is nil.
2209 (unless (aref table i)
2210 (aset table i [??]))))
2211 (setq buffer-display-table table)))
2213 (defun gnus-summary-setup-buffer (group)
2214 "Initialize summary buffer."
2215 (let ((buffer (concat "*Summary " group "*")))
2216 (if (get-buffer buffer)
2219 (setq gnus-summary-buffer (current-buffer))
2220 (not gnus-newsgroup-prepared))
2221 ;; Fix by Sudish Joseph <joseph@cis.ohio-state.edu>
2222 (setq gnus-summary-buffer (set-buffer (get-buffer-create buffer)))
2223 (gnus-add-current-to-buffer-list)
2224 (gnus-summary-mode group)
2226 (gnus-carpal-setup-buffer 'summary))
2227 (unless gnus-single-article-buffer
2228 (make-local-variable 'gnus-article-buffer)
2229 (make-local-variable 'gnus-article-current)
2230 (make-local-variable 'gnus-original-article-buffer))
2231 (setq gnus-newsgroup-name group)
2234 (defun gnus-set-global-variables ()
2235 ;; Set the global equivalents of the summary buffer-local variables
2236 ;; to the latest values they had. These reflect the summary buffer
2237 ;; that was in action when the last article was fetched.
2238 (when (eq major-mode 'gnus-summary-mode)
2239 (setq gnus-summary-buffer (current-buffer))
2240 (let ((name gnus-newsgroup-name)
2241 (marked gnus-newsgroup-marked)
2242 (unread gnus-newsgroup-unreads)
2243 (headers gnus-current-headers)
2244 (data gnus-newsgroup-data)
2245 (summary gnus-summary-buffer)
2246 (article-buffer gnus-article-buffer)
2247 (original gnus-original-article-buffer)
2248 (gac gnus-article-current)
2249 (reffed gnus-reffed-article-number)
2250 (score-file gnus-current-score-file))
2252 (set-buffer gnus-group-buffer)
2253 (setq gnus-newsgroup-name name)
2254 (setq gnus-newsgroup-marked marked)
2255 (setq gnus-newsgroup-unreads unread)
2256 (setq gnus-current-headers headers)
2257 (setq gnus-newsgroup-data data)
2258 (setq gnus-article-current gac)
2259 (setq gnus-summary-buffer summary)
2260 (setq gnus-article-buffer article-buffer)
2261 (setq gnus-original-article-buffer original)
2262 (setq gnus-reffed-article-number reffed)
2263 (setq gnus-current-score-file score-file)
2264 ;; The article buffer also has local variables.
2265 (when (gnus-buffer-live-p gnus-article-buffer)
2266 (set-buffer gnus-article-buffer)
2267 (setq gnus-summary-buffer summary))))))
2269 (defun gnus-summary-article-unread-p (article)
2270 "Say whether ARTICLE is unread or not."
2271 (memq article gnus-newsgroup-unreads))
2273 (defun gnus-summary-first-article-p (&optional article)
2274 "Return whether ARTICLE is the first article in the buffer."
2275 (if (not (setq article (or article (gnus-summary-article-number))))
2277 (eq article (caar gnus-newsgroup-data))))
2279 (defun gnus-summary-last-article-p (&optional article)
2280 "Return whether ARTICLE is the last article in the buffer."
2281 (if (not (setq article (or article (gnus-summary-article-number))))
2282 t ; All non-existent numbers are the last article. :-)
2283 (not (cdr (gnus-data-find-list article)))))
2285 (defun gnus-make-thread-indent-array ()
2287 (unless (and gnus-thread-indent-array
2288 (= gnus-thread-indent-level gnus-thread-indent-array-level))
2289 (setq gnus-thread-indent-array (make-vector 201 "")
2290 gnus-thread-indent-array-level gnus-thread-indent-level)
2292 (aset gnus-thread-indent-array n
2293 (make-string (* n gnus-thread-indent-level) ? ))
2296 (defun gnus-update-summary-mark-positions ()
2297 "Compute where the summary marks are to go."
2299 (when (and gnus-summary-buffer
2300 (get-buffer gnus-summary-buffer)
2301 (buffer-name (get-buffer gnus-summary-buffer)))
2302 (set-buffer gnus-summary-buffer))
2303 (let ((gnus-replied-mark 129)
2304 (gnus-score-below-mark 130)
2305 (gnus-score-over-mark 130)
2306 (spec gnus-summary-line-format-spec)
2307 thread gnus-visual pos)
2309 (gnus-set-work-buffer)
2310 (let ((gnus-summary-line-format-spec spec))
2311 (gnus-summary-insert-line
2312 [0 "" "" "" "" "" 0 0 ""] 0 nil 128 t nil "" nil 1)
2313 (goto-char (point-min))
2314 (setq pos (list (cons 'unread (and (search-forward "\200" nil t)
2316 (goto-char (point-min))
2317 (push (cons 'replied (and (search-forward "\201" nil t)
2320 (goto-char (point-min))
2321 (push (cons 'score (and (search-forward "\202" nil t) (- (point) 2)))
2323 (setq gnus-summary-mark-positions pos))))
2325 (defun gnus-summary-insert-dummy-line (gnus-tmp-subject gnus-tmp-number)
2326 "Insert a dummy root in the summary buffer."
2328 (gnus-add-text-properties
2329 (point) (progn (eval gnus-summary-dummy-line-format-spec) (point))
2330 (list 'gnus-number gnus-tmp-number 'gnus-intangible gnus-tmp-number)))
2332 (defun gnus-summary-insert-line (gnus-tmp-header
2333 gnus-tmp-level gnus-tmp-current
2334 gnus-tmp-unread gnus-tmp-replied
2335 gnus-tmp-expirable gnus-tmp-subject-or-nil
2336 &optional gnus-tmp-dummy gnus-tmp-score
2338 (let* ((gnus-tmp-indentation (aref gnus-thread-indent-array gnus-tmp-level))
2339 (gnus-tmp-lines (mail-header-lines gnus-tmp-header))
2340 (gnus-tmp-score (or gnus-tmp-score gnus-summary-default-score 0))
2341 (gnus-tmp-score-char
2342 (if (or (null gnus-summary-default-score)
2343 (<= (abs (- gnus-tmp-score gnus-summary-default-score))
2344 gnus-summary-zcore-fuzz))
2346 (if (< gnus-tmp-score gnus-summary-default-score)
2347 gnus-score-below-mark gnus-score-over-mark)))
2349 (cond (gnus-tmp-process gnus-process-mark)
2350 ((memq gnus-tmp-current gnus-newsgroup-cached)
2352 (gnus-tmp-replied gnus-replied-mark)
2353 ((memq gnus-tmp-current gnus-newsgroup-saved)
2355 (t gnus-unread-mark)))
2356 (gnus-tmp-from (mail-header-from gnus-tmp-header))
2359 ((string-match "<[^>]+> *$" gnus-tmp-from)
2360 (let ((beg (match-beginning 0)))
2361 (or (and (string-match "^\"[^\"]*\"" gnus-tmp-from)
2362 (substring gnus-tmp-from (1+ (match-beginning 0))
2363 (1- (match-end 0))))
2364 (substring gnus-tmp-from 0 beg))))
2365 ((string-match "(.+)" gnus-tmp-from)
2366 (substring gnus-tmp-from
2367 (1+ (match-beginning 0)) (1- (match-end 0))))
2369 (gnus-tmp-subject (mail-header-subject gnus-tmp-header))
2370 (gnus-tmp-number (mail-header-number gnus-tmp-header))
2371 (gnus-tmp-opening-bracket (if gnus-tmp-dummy ?\< ?\[))
2372 (gnus-tmp-closing-bracket (if gnus-tmp-dummy ?\> ?\]))
2373 (buffer-read-only nil))
2374 (when (string= gnus-tmp-name "")
2375 (setq gnus-tmp-name gnus-tmp-from))
2376 (unless (numberp gnus-tmp-lines)
2377 (setq gnus-tmp-lines 0))
2378 (gnus-put-text-property
2380 (progn (eval gnus-summary-line-format-spec) (point))
2381 'gnus-number gnus-tmp-number)
2382 (when (gnus-visual-p 'summary-highlight 'highlight)
2384 (run-hooks 'gnus-summary-update-hook)
2387 (defun gnus-summary-update-line (&optional dont-update)
2388 ;; Update summary line after change.
2389 (when (and gnus-summary-default-score
2390 (not gnus-summary-inhibit-highlight))
2391 (let* ((gnus-summary-inhibit-highlight t) ; Prevent recursion.
2392 (article (gnus-summary-article-number))
2393 (score (gnus-summary-article-score article)))
2395 (if (and gnus-summary-mark-below
2396 (< (gnus-summary-article-score)
2397 gnus-summary-mark-below))
2398 ;; This article has a low score, so we mark it as read.
2399 (when (memq article gnus-newsgroup-unreads)
2400 (gnus-summary-mark-article-as-read gnus-low-score-mark))
2401 (when (eq (gnus-summary-article-mark) gnus-low-score-mark)
2402 ;; This article was previously marked as read on account
2403 ;; of a low score, but now it has risen, so we mark it as
2405 (gnus-summary-mark-article-as-unread gnus-unread-mark)))
2406 (gnus-summary-update-mark
2407 (if (or (null gnus-summary-default-score)
2408 (<= (abs (- score gnus-summary-default-score))
2409 gnus-summary-zcore-fuzz))
2411 (if (< score gnus-summary-default-score)
2412 gnus-score-below-mark gnus-score-over-mark))
2414 ;; Do visual highlighting.
2415 (when (gnus-visual-p 'summary-highlight 'highlight)
2416 (run-hooks 'gnus-summary-update-hook)))))
2418 (defvar gnus-tmp-new-adopts nil)
2420 (defun gnus-summary-number-of-articles-in-thread (thread &optional level char)
2421 "Return the number of articles in THREAD.
2422 This may be 0 in some cases -- if none of the articles in
2423 the thread are to be displayed."
2425 ;; Fix by Luc Van Eycken <Luc.VanEycken@esat.kuleuven.ac.be>.
2427 ((not (listp thread))
2429 ((and (consp thread) (cdr thread))
2432 'gnus-summary-number-of-articles-in-thread (cdr thread))))
2435 ((memq (mail-header-number (car thread)) gnus-newsgroup-limit)
2438 (when (and level (zerop level) gnus-tmp-new-adopts)
2441 'gnus-summary-number-of-articles-in-thread
2442 gnus-tmp-new-adopts))))
2444 (if (> number 1) gnus-not-empty-thread-mark
2445 gnus-empty-thread-mark)
2448 (defun gnus-summary-set-local-parameters (group)
2449 "Go through the local params of GROUP and set all variable specs in that list."
2450 (let ((params (gnus-group-find-parameter group))
2453 (setq elem (car params)
2454 params (cdr params))
2455 (and (consp elem) ; Has to be a cons.
2456 (consp (cdr elem)) ; The cdr has to be a list.
2457 (symbolp (car elem)) ; Has to be a symbol in there.
2458 (not (memq (car elem)
2459 '(quit-config to-address to-list to-group)))
2460 (ignore-errors ; So we set it.
2461 (make-local-variable (car elem))
2462 (set (car elem) (eval (nth 1 elem))))))))
2464 (defun gnus-summary-read-group (group &optional show-all no-article
2465 kill-buffer no-display)
2466 "Start reading news in newsgroup GROUP.
2467 If SHOW-ALL is non-nil, already read articles are also listed.
2468 If NO-ARTICLE is non-nil, no article is selected initially.
2469 If NO-DISPLAY, don't generate a summary buffer."
2473 (let ((gnus-auto-select-next nil))
2474 (gnus-summary-read-group-1
2475 group show-all no-article
2476 kill-buffer no-display))))
2477 (eq gnus-auto-select-next 'quietly))
2478 (set-buffer gnus-group-buffer)
2479 (if (not (equal group (gnus-group-group-name)))
2480 (setq group (gnus-group-group-name))
2484 (defun gnus-summary-read-group-1 (group show-all no-article
2485 kill-buffer no-display)
2486 ;; Killed foreign groups can't be entered.
2487 (when (and (not (gnus-group-native-p group))
2488 (not (gnus-gethash group gnus-newsrc-hashtb)))
2489 (error "Dead non-native groups can't be entered"))
2490 (gnus-message 5 "Retrieving newsgroup: %s..." group)
2491 (let* ((new-group (gnus-summary-setup-buffer group))
2492 (quit-config (gnus-group-quit-config group))
2493 (did-select (and new-group (gnus-select-newsgroup group show-all))))
2495 ;; This summary buffer exists already, so we just select it.
2497 (gnus-set-global-variables)
2499 (gnus-kill-or-deaden-summary kill-buffer))
2500 (gnus-configure-windows 'summary 'force)
2501 (gnus-set-mode-line 'summary)
2502 (gnus-summary-position-point)
2505 ;; We couldn't select this group.
2507 (when (and (eq major-mode 'gnus-summary-mode)
2508 (not (equal (current-buffer) kill-buffer)))
2509 (kill-buffer (current-buffer))
2510 (if (not quit-config)
2512 (set-buffer gnus-group-buffer)
2513 (gnus-group-jump-to-group group)
2514 (gnus-group-next-unread-group 1))
2515 (gnus-handle-ephemeral-exit quit-config)))
2516 (gnus-message 3 "Can't select group")
2518 ;; The user did a `C-g' while prompting for number of articles,
2519 ;; so we exit this group.
2520 ((eq did-select 'quit)
2521 (and (eq major-mode 'gnus-summary-mode)
2522 (not (equal (current-buffer) kill-buffer))
2523 (kill-buffer (current-buffer)))
2525 (gnus-kill-or-deaden-summary kill-buffer))
2526 (if (not quit-config)
2528 (set-buffer gnus-group-buffer)
2529 (gnus-group-jump-to-group group)
2530 (gnus-group-next-unread-group 1)
2531 (gnus-configure-windows 'group 'force))
2532 (gnus-handle-ephemeral-exit quit-config))
2533 ;; Finally signal the quit.
2535 ;; The group was successfully selected.
2537 (gnus-set-global-variables)
2538 ;; Save the active value in effect when the group was entered.
2539 (setq gnus-newsgroup-active
2541 (gnus-active gnus-newsgroup-name)))
2542 ;; You can change the summary buffer in some way with this hook.
2543 (run-hooks 'gnus-select-group-hook)
2544 ;; Set any local variables in the group parameters.
2545 (gnus-summary-set-local-parameters gnus-newsgroup-name)
2546 (gnus-update-format-specifications
2547 nil 'summary 'summary-mode 'summary-dummy)
2548 ;; Do score processing.
2549 (when gnus-use-scoring
2550 (gnus-possibly-score-headers))
2551 ;; Check whether to fill in the gaps in the threads.
2552 (when gnus-build-sparse-threads
2553 (gnus-build-sparse-threads))
2554 ;; Find the initial limit.
2555 (if gnus-show-threads
2557 (let ((gnus-newsgroup-dormant nil))
2558 (gnus-summary-initial-limit show-all))
2559 (gnus-summary-initial-limit show-all))
2560 (setq gnus-newsgroup-limit
2562 (lambda (header) (mail-header-number header))
2563 gnus-newsgroup-headers)))
2564 ;; Generate the summary buffer.
2566 (gnus-summary-prepare))
2567 (when gnus-use-trees
2568 (gnus-tree-open group)
2569 (setq gnus-summary-highlight-line-function
2570 'gnus-tree-highlight-article))
2571 ;; If the summary buffer is empty, but there are some low-scored
2572 ;; articles or some excluded dormants, we include these in the
2574 (when (and (zerop (buffer-size))
2576 (cond (gnus-newsgroup-dormant
2577 (gnus-summary-limit-include-dormant))
2578 ((and gnus-newsgroup-scored show-all)
2579 (gnus-summary-limit-include-expunged t))))
2580 ;; Function `gnus-apply-kill-file' must be called in this hook.
2581 (run-hooks 'gnus-apply-kill-hook)
2582 (if (and (zerop (buffer-size))
2585 ;; This newsgroup is empty.
2586 (gnus-summary-catchup-and-exit nil t)
2587 (gnus-message 6 "No unread news")
2589 (gnus-kill-or-deaden-summary kill-buffer))
2590 ;; Return nil from this function.
2592 ;; Hide conversation thread subtrees. We cannot do this in
2593 ;; gnus-summary-prepare-hook since kill processing may not
2594 ;; work with hidden articles.
2595 (and gnus-show-threads
2596 gnus-thread-hide-subtree
2597 (gnus-summary-hide-all-threads))
2598 ;; Show first unread article if requested.
2599 (if (and (not no-article)
2601 gnus-newsgroup-unreads
2602 gnus-auto-select-first)
2603 (unless (if (eq gnus-auto-select-first 'best)
2604 (gnus-summary-best-unread-article)
2605 (gnus-summary-first-unread-article))
2606 (gnus-configure-windows 'summary))
2607 ;; Don't select any articles, just move point to the first
2608 ;; article in the group.
2609 (goto-char (point-min))
2610 (gnus-summary-position-point)
2611 (gnus-set-mode-line 'summary)
2612 (gnus-configure-windows 'summary 'force))
2614 (gnus-kill-or-deaden-summary kill-buffer))
2615 (when (get-buffer-window gnus-group-buffer t)
2616 ;; Gotta use windows, because recenter does weird stuff if
2617 ;; the current buffer ain't the displayed window.
2618 (let ((owin (selected-window)))
2619 (select-window (get-buffer-window gnus-group-buffer t))
2620 (when (gnus-group-goto-group group)
2622 (select-window owin)))
2623 ;; Mark this buffer as "prepared".
2624 (setq gnus-newsgroup-prepared t)
2627 (defun gnus-summary-prepare ()
2628 "Generate the summary buffer."
2630 (let ((buffer-read-only nil))
2632 (setq gnus-newsgroup-data nil
2633 gnus-newsgroup-data-reverse nil)
2634 (run-hooks 'gnus-summary-generate-hook)
2635 ;; Generate the buffer, either with threads or without.
2636 (when gnus-newsgroup-headers
2637 (gnus-summary-prepare-threads
2638 (if gnus-show-threads
2639 (gnus-sort-gathered-threads
2640 (funcall gnus-summary-thread-gathering-function
2642 (gnus-cut-threads (gnus-make-threads)))))
2643 ;; Unthreaded display.
2644 (gnus-sort-articles gnus-newsgroup-headers))))
2645 (setq gnus-newsgroup-data (nreverse gnus-newsgroup-data))
2646 ;; Call hooks for modifying summary buffer.
2647 (goto-char (point-min))
2648 (run-hooks 'gnus-summary-prepare-hook)))
2650 (defsubst gnus-general-simplify-subject (subject)
2651 "Simply subject by the same rules as gnus-gather-threads-by-subject."
2654 ;; Truncate the subject.
2655 ((numberp gnus-summary-gather-subject-limit)
2656 (setq subject (gnus-simplify-subject-re subject))
2657 (if (> (length subject) gnus-summary-gather-subject-limit)
2658 (substring subject 0 gnus-summary-gather-subject-limit)
2660 ;; Fuzzily simplify it.
2661 ((eq 'fuzzy gnus-summary-gather-subject-limit)
2662 (gnus-simplify-subject-fuzzy subject))
2663 ;; Just remove the leading "Re:".
2665 (gnus-simplify-subject-re subject))))
2667 (if (and gnus-summary-gather-exclude-subject
2668 (string-match gnus-summary-gather-exclude-subject subject))
2669 nil ; This article shouldn't be gathered
2672 (defun gnus-summary-simplify-subject-query ()
2673 "Query where the respool algorithm would put this article."
2675 (gnus-set-global-variables)
2676 (gnus-summary-select-article)
2677 (message (gnus-general-simplify-subject (gnus-summary-article-subject))))
2679 (defun gnus-gather-threads-by-subject (threads)
2680 "Gather threads by looking at Subject headers."
2681 (if (not gnus-summary-make-false-root)
2683 (let ((hashtb (gnus-make-hashtable 1024))
2686 subject hthread whole-subject)
2688 (setq subject (gnus-general-simplify-subject
2689 (setq whole-subject (mail-header-subject
2692 (if (setq hthread (gnus-gethash subject hashtb))
2694 ;; We enter a dummy root into the thread, if we
2695 ;; haven't done that already.
2696 (unless (stringp (caar hthread))
2697 (setcar hthread (list whole-subject (car hthread))))
2698 ;; We add this new gathered thread to this gathered
2700 (setcdr (car hthread)
2701 (nconc (cdar hthread) (list (car threads))))
2702 ;; Remove it from the list of threads.
2703 (setcdr prev (cdr threads))
2704 (setq threads prev))
2705 ;; Enter this thread into the hash table.
2706 (gnus-sethash subject threads hashtb)))
2708 (setq threads (cdr threads)))
2711 (defun gnus-gather-threads-by-references (threads)
2712 "Gather threads by looking at References headers."
2713 (let ((idhashtb (gnus-make-hashtable 1024))
2714 (thhashtb (gnus-make-hashtable 1024))
2717 ids references id gthread gid entered ref)
2719 (when (setq references (mail-header-references (caar threads)))
2720 (setq id (mail-header-id (caar threads))
2721 ids (gnus-split-references references)
2723 (while (setq ref (pop ids))
2724 (setq ids (delete ref ids))
2725 (if (not (setq gid (gnus-gethash ref idhashtb)))
2727 (gnus-sethash ref id idhashtb)
2728 (gnus-sethash id threads thhashtb))
2729 (setq gthread (gnus-gethash gid thhashtb))
2731 ;; We enter a dummy root into the thread, if we
2732 ;; haven't done that already.
2733 (unless (stringp (caar gthread))
2734 (setcar gthread (list (mail-header-subject (caar gthread))
2736 ;; We add this new gathered thread to this gathered
2738 (setcdr (car gthread)
2739 (nconc (cdar gthread) (list (car threads)))))
2740 ;; Add it into the thread hash table.
2741 (gnus-sethash id gthread thhashtb)
2743 ;; Remove it from the list of threads.
2744 (setcdr prev (cdr threads))
2745 (setq threads prev))))
2747 (setq threads (cdr threads)))
2750 (defun gnus-sort-gathered-threads (threads)
2751 "Sort subtreads inside each gathered thread by article number."
2752 (let ((result threads))
2754 (when (stringp (caar threads))
2755 (setcdr (car threads)
2756 (sort (cdar threads) 'gnus-thread-sort-by-number)))
2757 (setq threads (cdr threads)))
2760 (defun gnus-thread-loop-p (root thread)
2761 "Say whether ROOT is in THREAD."
2762 (let ((stack (list thread))
2765 (while (setq thread (pop stack))
2766 (setq th (cdr thread))
2768 (not (eq (caar th) root)))
2771 ;; We have found a loop.
2773 (setcdr thread (delq (car th) (cdr thread)))
2774 (if (boundp (setq ref-dep (intern "none"
2775 gnus-newsgroup-dependencies)))
2776 (setcdr (symbol-value ref-dep)
2777 (nconc (cdr (symbol-value ref-dep))
2779 (set ref-dep (list nil (car th))))
2782 ;; Push all the subthreads onto the stack.
2783 (push (cdr thread) stack)))
2786 (defun gnus-make-threads ()
2787 "Go through the dependency hashtb and find the roots. Return all threads."
2789 (while (catch 'infloop
2792 ;; Deal with self-referencing References loops.
2793 (when (and (car (symbol-value refs))
2800 (car (symbol-value refs)) thread))
2801 (cdr (symbol-value refs)))))))
2804 (unless (car (symbol-value refs))
2805 ;; These threads do not refer back to any other articles,
2806 ;; so they're roots.
2807 (setq threads (append (cdr (symbol-value refs)) threads))))
2808 gnus-newsgroup-dependencies)))
2811 (defun gnus-build-sparse-threads ()
2812 (let ((headers gnus-newsgroup-headers)
2813 (deps gnus-newsgroup-dependencies)
2814 header references generation relations
2815 cthread subject child end pthread relation)
2816 ;; First we create an alist of generations/relations, where
2817 ;; generations is how much we trust the relation, and the relation
2819 (gnus-message 7 "Making sparse threads...")
2821 (nnheader-set-temp-buffer " *gnus sparse threads*")
2822 (while (setq header (pop headers))
2823 (when (and (setq references (mail-header-references header))
2824 (not (string= references "")))
2826 (setq child (mail-header-id header)
2827 subject (mail-header-subject header))
2829 (while (search-backward ">" nil t)
2830 (setq end (1+ (point)))
2831 (when (search-backward "<" nil t)
2832 (push (list (incf generation)
2833 child (setq child (buffer-substring (point) end))
2836 (push (list (1+ generation) child nil subject) relations)
2838 (kill-buffer (current-buffer)))
2839 ;; Sort over trustworthiness.
2840 (setq relations (sort relations (lambda (r1 r2) (< (car r1) (car r2)))))
2841 (while (setq relation (pop relations))
2842 (when (if (boundp (setq cthread (intern (cadr relation) deps)))
2843 (unless (car (symbol-value cthread))
2844 ;; Make this article the parent of these threads.
2845 (setcar (symbol-value cthread)
2846 (vector gnus-reffed-article-number
2850 (or (caddr relation) "") 0 0 "")))
2851 (set cthread (list (vector gnus-reffed-article-number
2853 "" "" (cadr relation)
2854 (or (caddr relation) "") 0 0 ""))))
2855 (push gnus-reffed-article-number gnus-newsgroup-limit)
2856 (push gnus-reffed-article-number gnus-newsgroup-sparse)
2857 (push (cons gnus-reffed-article-number gnus-sparse-mark)
2858 gnus-newsgroup-reads)
2859 (decf gnus-reffed-article-number)
2860 ;; Make this new thread the child of its parent.
2861 (if (boundp (setq pthread (intern (or (caddr relation) "none") deps)))
2862 (setcdr (symbol-value pthread)
2863 (nconc (cdr (symbol-value pthread))
2864 (list (symbol-value cthread))))
2865 (set pthread (list nil (symbol-value cthread))))))
2866 (gnus-message 7 "Making sparse threads...done")))
2868 (defun gnus-build-old-threads ()
2869 ;; Look at all the articles that refer back to old articles, and
2870 ;; fetch the headers for the articles that aren't there. This will
2871 ;; build complete threads - if the roots haven't been expired by the
2876 (when (not (car (symbol-value refs)))
2877 (setq heads (cdr (symbol-value refs)))
2879 (if (memq (mail-header-number (caar heads))
2880 gnus-newsgroup-dormant)
2881 (setq heads (cdr heads))
2882 (setq id (symbol-name refs))
2883 (while (and (setq id (gnus-build-get-header id))
2884 (not (car (gnus-gethash
2885 id gnus-newsgroup-dependencies)))))
2886 (setq heads nil)))))
2887 gnus-newsgroup-dependencies)))
2889 (defun gnus-build-get-header (id)
2890 ;; Look through the buffer of NOV lines and find the header to
2891 ;; ID. Enter this line into the dependencies hash table, and return
2892 ;; the id of the parent article (if any).
2893 (let ((deps gnus-newsgroup-dependencies)
2897 (set-buffer nntp-server-buffer)
2898 (let ((case-fold-search nil))
2899 (goto-char (point-min))
2900 (while (and (not found)
2901 (search-forward id nil t))
2903 (setq found (looking-at
2904 (format "^[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t%s"
2905 (regexp-quote id))))
2906 (or found (beginning-of-line 2)))
2910 (setq header (gnus-nov-parse-line
2911 (read (current-buffer)) deps))
2912 (gnus-parent-id (mail-header-references header))))))
2914 (let ((number (mail-header-number header)))
2915 (push number gnus-newsgroup-limit)
2916 (push header gnus-newsgroup-headers)
2917 (if (memq number gnus-newsgroup-unselected)
2919 (push number gnus-newsgroup-unreads)
2920 (setq gnus-newsgroup-unselected
2921 (delq number gnus-newsgroup-unselected)))
2922 (push number gnus-newsgroup-ancient)))))))
2924 (defun gnus-summary-update-article-line (article header)
2925 "Update the line for ARTICLE using HEADERS."
2926 (let* ((id (mail-header-id header))
2927 (thread (gnus-id-to-thread id)))
2929 (error "Article in no thread"))
2930 ;; Update the thread.
2931 (setcar thread header)
2932 (gnus-summary-goto-subject article)
2933 (let* ((datal (gnus-data-find-list article))
2935 (length (when (cdr datal)
2936 (- (gnus-data-pos data)
2937 (gnus-data-pos (cadr datal)))))
2938 (buffer-read-only nil)
2939 (level (gnus-summary-thread-level)))
2941 (gnus-summary-insert-line
2942 header level nil (gnus-article-mark article)
2943 (memq article gnus-newsgroup-replied)
2944 (memq article gnus-newsgroup-expirable)
2945 ;; Only insert the Subject string when it's different
2946 ;; from the previous Subject string.
2947 (if (gnus-subject-equal
2949 (mail-header-subject
2952 (gnus-data-find-list
2954 (gnus-data-list t)))))
2955 ;; Error on the side of excessive subjects.
2957 (mail-header-subject header))
2959 (mail-header-subject header))
2960 nil (cdr (assq article gnus-newsgroup-scored))
2961 (memq article gnus-newsgroup-processable))
2963 (gnus-data-update-list
2964 (cdr datal) (- length (- (gnus-data-pos data) (point))))))))
2966 (defun gnus-summary-update-article (article &optional iheader)
2967 "Update ARTICLE in the summary buffer."
2968 (set-buffer gnus-summary-buffer)
2969 (let* ((header (or iheader (gnus-summary-article-header article)))
2970 (id (mail-header-id header))
2971 (data (gnus-data-find article))
2972 (thread (gnus-id-to-thread id))
2973 (references (mail-header-references header))
2977 (when (and references
2978 (not (equal "" references)))
2981 (buffer-read-only nil)
2983 (number (mail-header-number header))
2986 ;; !!! Should this be in or not?
2988 (setcar thread nil))
2990 (delq thread parent))
2991 (if (gnus-summary-insert-subject id header iheader)
2992 ;; Set the (possibly) new article number in the data structure.
2993 (gnus-data-set-number data (gnus-id-to-article id))
2997 (defun gnus-rebuild-thread (id)
2998 "Rebuild the thread containing ID."
2999 (let ((buffer-read-only nil)
3000 old-pos current thread data)
3001 (if (not gnus-show-threads)
3002 (setq thread (list (car (gnus-id-to-thread id))))
3003 ;; Get the thread this article is part of.
3004 (setq thread (gnus-remove-thread id)))
3005 (setq old-pos (gnus-point-at-bol))
3006 (setq current (save-excursion
3007 (and (zerop (forward-line -1))
3008 (gnus-summary-article-number))))
3009 ;; If this is a gathered thread, we have to go some re-gathering.
3010 (when (stringp (car thread))
3011 (let ((subject (car thread))
3013 (setq thread (cdr thread))
3015 (unless (memq (setq thr (gnus-id-to-thread
3017 (mail-header-id (caar thread)))))
3020 (setq thread (cdr thread)))
3021 ;; We now have all (unique) roots.
3022 (if (= (length roots) 1)
3023 ;; All the loose roots are now one solid root.
3024 (setq thread (car roots))
3025 (setq thread (cons subject (gnus-sort-threads roots))))))
3027 ;; We then insert this thread into the summary buffer.
3028 (let (gnus-newsgroup-data gnus-newsgroup-threads)
3029 (if gnus-show-threads
3030 (gnus-summary-prepare-threads (gnus-cut-threads (list thread)))
3031 (gnus-summary-prepare-unthreaded thread))
3032 (setq data (nreverse gnus-newsgroup-data))
3033 (setq threads gnus-newsgroup-threads))
3034 ;; We splice the new data into the data structure.
3035 (gnus-data-enter-list current data (- (point) old-pos))
3036 (setq gnus-newsgroup-threads (nconc threads gnus-newsgroup-threads)))))
3038 (defun gnus-number-to-header (number)
3039 "Return the header for article NUMBER."
3040 (let ((headers gnus-newsgroup-headers))
3042 (not (= number (mail-header-number (car headers)))))
3047 (defun gnus-parent-headers (headers &optional generation)
3048 "Return the headers of the GENERATIONeth parent of HEADERS."
3050 (setq generation 1))
3051 (let (references parent)
3052 (while (and headers (not (zerop generation)))
3053 (setq references (mail-header-references headers))
3054 (when (and references
3055 (setq parent (gnus-parent-id references))
3056 (setq headers (car (gnus-id-to-thread parent))))
3060 (defun gnus-id-to-thread (id)
3061 "Return the (sub-)thread where ID appears."
3062 (gnus-gethash id gnus-newsgroup-dependencies))
3064 (defun gnus-id-to-article (id)
3065 "Return the article number of ID."
3066 (let ((thread (gnus-id-to-thread id)))
3069 (mail-header-number (car thread)))))
3071 (defun gnus-id-to-header (id)
3072 "Return the article headers of ID."
3073 (car (gnus-id-to-thread id)))
3075 (defun gnus-article-displayed-root-p (article)
3076 "Say whether ARTICLE is a root(ish) article."
3077 (let ((level (gnus-summary-thread-level article))
3078 (refs (mail-header-references (gnus-summary-article-header article)))
3084 ((null (gnus-parent-id refs)) t)
3086 (null (setq particle (gnus-id-to-article
3087 (gnus-parent-id refs))))
3088 (null (gnus-summary-thread-level particle)))))))
3090 (defun gnus-root-id (id)
3091 "Return the id of the root of the thread where ID appears."
3093 (while (and id (setq prev (car (gnus-gethash
3094 id gnus-newsgroup-dependencies))))
3096 id (gnus-parent-id (mail-header-references prev))))
3099 (defun gnus-remove-thread (id &optional dont-remove)
3100 "Remove the thread that has ID in it."
3101 (let ((dep gnus-newsgroup-dependencies)
3102 headers thread last-id)
3103 ;; First go up in this thread until we find the root.
3104 (setq last-id (gnus-root-id id))
3105 (setq headers (list (car (gnus-id-to-thread last-id))
3106 (caadr (gnus-id-to-thread last-id))))
3107 ;; We have now found the real root of this thread. It might have
3108 ;; been gathered into some loose thread, so we have to search
3109 ;; through the threads to find the thread we wanted.
3110 (let ((threads gnus-newsgroup-threads)
3113 (setq sub (car threads))
3114 (if (stringp (car sub))
3115 ;; This is a gathered thread, so we look at the roots
3116 ;; below it to find whether this article is in this
3119 (setq sub (cdr sub))
3121 (when (member (caar sub) headers)
3122 (setq thread (car threads)
3125 (setq sub (cdr sub))))
3126 ;; It's an ordinary thread, so we check it.
3127 (when (eq (car sub) (car headers))
3130 (setq threads (cdr threads)))
3131 ;; If this article is in no thread, then it's a root.
3134 (setq gnus-newsgroup-threads (delq thread gnus-newsgroup-threads)))
3135 (setq thread (gnus-gethash last-id dep)))
3138 thread ; We return this thread.
3140 (if (stringp (car thread))
3142 ;; If we use dummy roots, then we have to remove the
3143 ;; dummy root as well.
3144 (when (eq gnus-summary-make-false-root 'dummy)
3146 (gnus-data-compute-positions))
3147 (setq thread (cdr thread))
3149 (gnus-remove-thread-1 (car thread))
3150 (setq thread (cdr thread))))
3151 (gnus-remove-thread-1 thread))))))))
3153 (defun gnus-remove-thread-1 (thread)
3154 "Remove the thread THREAD recursively."
3155 (let ((number (mail-header-number (pop thread)))
3157 (setq thread (reverse thread))
3159 (gnus-remove-thread-1 (pop thread)))
3160 (when (setq d (gnus-data-find number))
3161 (goto-char (gnus-data-pos d))
3164 (- (gnus-point-at-bol)
3166 (1+ (gnus-point-at-eol))
3167 (gnus-delete-line)))))))
3169 (defun gnus-sort-threads (threads)
3171 (if (not gnus-thread-sort-functions)
3173 (gnus-message 7 "Sorting threads...")
3175 (sort threads (gnus-make-sort-function gnus-thread-sort-functions))
3176 (gnus-message 7 "Sorting threads...done"))))
3178 (defun gnus-sort-articles (articles)
3180 (when gnus-article-sort-functions
3181 (gnus-message 7 "Sorting articles...")
3183 (setq gnus-newsgroup-headers
3184 (sort articles (gnus-make-sort-function
3185 gnus-article-sort-functions)))
3186 (gnus-message 7 "Sorting articles...done"))))
3188 ;; Written by Hallvard B Furuseth <h.b.furuseth@usit.uio.no>.
3189 (defmacro gnus-thread-header (thread)
3190 ;; Return header of first article in THREAD.
3191 ;; Note that THREAD must never, ever be anything else than a variable -
3192 ;; using some other form will lead to serious barfage.
3193 (or (symbolp thread) (signal 'wrong-type-argument '(symbolp thread)))
3194 ;; (8% speedup to gnus-summary-prepare, just for fun :-)
3195 (list 'byte-code "\10\211:\203\17\0\211@;\203\16\0A@@\207" ;
3198 (defsubst gnus-article-sort-by-number (h1 h2)
3199 "Sort articles by article number."
3200 (< (mail-header-number h1)
3201 (mail-header-number h2)))
3203 (defun gnus-thread-sort-by-number (h1 h2)
3204 "Sort threads by root article number."
3205 (gnus-article-sort-by-number
3206 (gnus-thread-header h1) (gnus-thread-header h2)))
3208 (defsubst gnus-article-sort-by-lines (h1 h2)
3209 "Sort articles by article Lines header."
3210 (< (mail-header-lines h1)
3211 (mail-header-lines h2)))
3213 (defun gnus-thread-sort-by-lines (h1 h2)
3214 "Sort threads by root article Lines header."
3215 (gnus-article-sort-by-lines
3216 (gnus-thread-header h1) (gnus-thread-header h2)))
3218 (defsubst gnus-article-sort-by-author (h1 h2)
3219 "Sort articles by root author."
3221 (let ((extract (funcall
3222 gnus-extract-address-components
3223 (mail-header-from h1))))
3224 (or (car extract) (cadr extract) ""))
3225 (let ((extract (funcall
3226 gnus-extract-address-components
3227 (mail-header-from h2))))
3228 (or (car extract) (cadr extract) ""))))
3230 (defun gnus-thread-sort-by-author (h1 h2)
3231 "Sort threads by root author."
3232 (gnus-article-sort-by-author
3233 (gnus-thread-header h1) (gnus-thread-header h2)))
3235 (defsubst gnus-article-sort-by-subject (h1 h2)
3236 "Sort articles by root subject."
3238 (downcase (gnus-simplify-subject-re (mail-header-subject h1)))
3239 (downcase (gnus-simplify-subject-re (mail-header-subject h2)))))
3241 (defun gnus-thread-sort-by-subject (h1 h2)
3242 "Sort threads by root subject."
3243 (gnus-article-sort-by-subject
3244 (gnus-thread-header h1) (gnus-thread-header h2)))
3246 (defsubst gnus-article-sort-by-date (h1 h2)
3247 "Sort articles by root article date."
3249 (gnus-date-get-time (mail-header-date h1))
3250 (gnus-date-get-time (mail-header-date h2))))
3252 (defun gnus-thread-sort-by-date (h1 h2)
3253 "Sort threads by root article date."
3254 (gnus-article-sort-by-date
3255 (gnus-thread-header h1) (gnus-thread-header h2)))
3257 (defsubst gnus-article-sort-by-score (h1 h2)
3258 "Sort articles by root article score.
3259 Unscored articles will be counted as having a score of zero."
3260 (> (or (cdr (assq (mail-header-number h1)
3261 gnus-newsgroup-scored))
3262 gnus-summary-default-score 0)
3263 (or (cdr (assq (mail-header-number h2)
3264 gnus-newsgroup-scored))
3265 gnus-summary-default-score 0)))
3267 (defun gnus-thread-sort-by-score (h1 h2)
3268 "Sort threads by root article score."
3269 (gnus-article-sort-by-score
3270 (gnus-thread-header h1) (gnus-thread-header h2)))
3272 (defun gnus-thread-sort-by-total-score (h1 h2)
3273 "Sort threads by the sum of all scores in the thread.
3274 Unscored articles will be counted as having a score of zero."
3275 (> (gnus-thread-total-score h1) (gnus-thread-total-score h2)))
3277 (defun gnus-thread-total-score (thread)
3278 ;; This function find the total score of THREAD.
3279 (cond ((null thread)
3282 (if (stringp (car thread))
3283 (apply gnus-thread-score-function 0
3284 (mapcar 'gnus-thread-total-score-1 (cdr thread)))
3285 (gnus-thread-total-score-1 thread)))
3287 (gnus-thread-total-score-1 (list thread)))))
3289 (defun gnus-thread-total-score-1 (root)
3290 ;; This function find the total score of the thread below ROOT.
3291 (setq root (car root))
3292 (apply gnus-thread-score-function
3294 (mapcar 'gnus-thread-total-score
3295 (cdr (gnus-gethash (mail-header-id root)
3296 gnus-newsgroup-dependencies)))
3297 (when (> (mail-header-number root) 0)
3298 (list (or (cdr (assq (mail-header-number root)
3299 gnus-newsgroup-scored))
3300 gnus-summary-default-score 0))))
3301 (list gnus-summary-default-score)
3304 ;; Added by Per Abrahamsen <amanda@iesd.auc.dk>.
3305 (defvar gnus-tmp-prev-subject nil)
3306 (defvar gnus-tmp-false-parent nil)
3307 (defvar gnus-tmp-root-expunged nil)
3308 (defvar gnus-tmp-dummy-line nil)
3310 (defun gnus-summary-prepare-threads (threads)
3311 "Prepare summary buffer from THREADS and indentation LEVEL.
3312 THREADS is either a list of `(PARENT [(CHILD1 [(GRANDCHILD ...]...) ...])'
3313 or a straight list of headers."
3314 (gnus-message 7 "Generating summary...")
3316 (setq gnus-newsgroup-threads threads)
3319 (let ((gnus-tmp-level 0)
3320 (default-score (or gnus-summary-default-score 0))
3321 (gnus-visual-p (gnus-visual-p 'summary-highlight 'highlight))
3322 thread number subject stack state gnus-tmp-gathered beg-match
3323 new-roots gnus-tmp-new-adopts thread-end
3324 gnus-tmp-header gnus-tmp-unread
3325 gnus-tmp-replied gnus-tmp-subject-or-nil
3326 gnus-tmp-dummy gnus-tmp-indentation gnus-tmp-lines gnus-tmp-score
3327 gnus-tmp-score-char gnus-tmp-from gnus-tmp-name
3328 gnus-tmp-number gnus-tmp-opening-bracket gnus-tmp-closing-bracket)
3330 (setq gnus-tmp-prev-subject nil)
3332 (if (vectorp (car threads))
3333 ;; If this is a straight (sic) list of headers, then a
3334 ;; threaded summary display isn't required, so we just create
3335 ;; an unthreaded one.
3336 (gnus-summary-prepare-unthreaded threads)
3338 ;; Do the threaded display.
3340 (while (or threads stack gnus-tmp-new-adopts new-roots)
3342 (if (and (= gnus-tmp-level 0)
3343 (not (setq gnus-tmp-dummy-line nil))
3346 (not gnus-tmp-false-parent)
3347 (or gnus-tmp-new-adopts new-roots))
3348 (if gnus-tmp-new-adopts
3349 (setq gnus-tmp-level (if gnus-tmp-root-expunged 0 1)
3350 thread (list (car gnus-tmp-new-adopts))
3351 gnus-tmp-header (caar thread)
3352 gnus-tmp-new-adopts (cdr gnus-tmp-new-adopts))
3354 (setq thread (list (car new-roots))
3355 gnus-tmp-header (caar thread)
3356 new-roots (cdr new-roots))))
3359 ;; If there are some threads, we do them before the
3360 ;; threads on the stack.
3361 (setq thread threads
3362 gnus-tmp-header (caar thread))
3363 ;; There were no current threads, so we pop something off
3365 (setq state (car stack)
3366 gnus-tmp-level (car state)
3369 gnus-tmp-header (caar thread))))
3371 (setq gnus-tmp-false-parent nil)
3372 (setq gnus-tmp-root-expunged nil)
3373 (setq thread-end nil)
3375 (if (stringp gnus-tmp-header)
3376 ;; The header is a dummy root.
3378 ((eq gnus-summary-make-false-root 'adopt)
3379 ;; We let the first article adopt the rest.
3380 (setq gnus-tmp-new-adopts (nconc gnus-tmp-new-adopts
3382 (setq gnus-tmp-gathered
3384 (lambda (h) (mail-header-number (car h)))
3387 (setq thread (cons (list (caar thread)
3390 (setq gnus-tmp-level -1
3391 gnus-tmp-false-parent t))
3392 ((eq gnus-summary-make-false-root 'empty)
3393 ;; We print adopted articles with empty subject fields.
3394 (setq gnus-tmp-gathered
3396 (lambda (h) (mail-header-number (car h)))
3399 (setq gnus-tmp-level -1))
3400 ((eq gnus-summary-make-false-root 'dummy)
3401 ;; We remember that we probably want to output a dummy
3403 (setq gnus-tmp-dummy-line gnus-tmp-header)
3404 (setq gnus-tmp-prev-subject gnus-tmp-header))
3406 ;; We do not make a root for the gathered
3407 ;; sub-threads at all.
3408 (setq gnus-tmp-level -1)))
3410 (setq number (mail-header-number gnus-tmp-header)
3411 subject (mail-header-subject gnus-tmp-header))
3414 ;; If the thread has changed subject, we might want to make
3415 ;; this subthread into a root.
3416 ((and (null gnus-thread-ignore-subject)
3417 (not (zerop gnus-tmp-level))
3418 gnus-tmp-prev-subject
3420 (gnus-subject-equal gnus-tmp-prev-subject subject))))
3421 (setq new-roots (nconc new-roots (list (car thread)))
3423 gnus-tmp-header nil))
3424 ;; If the article lies outside the current limit,
3425 ;; then we do not display it.
3426 ((not (memq number gnus-newsgroup-limit))
3427 (setq gnus-tmp-gathered
3429 (lambda (h) (mail-header-number (car h)))
3432 (setq gnus-tmp-new-adopts (if (cdar thread)
3433 (append gnus-tmp-new-adopts
3435 gnus-tmp-new-adopts)
3437 gnus-tmp-header nil)
3438 (when (zerop gnus-tmp-level)
3439 (setq gnus-tmp-root-expunged t)))
3440 ;; Perhaps this article is to be marked as read?
3441 ((and gnus-summary-mark-below
3442 (< (or (cdr (assq number gnus-newsgroup-scored))
3444 gnus-summary-mark-below)
3445 ;; Don't touch sparse articles.
3446 (not (gnus-summary-article-sparse-p number))
3447 (not (gnus-summary-article-ancient-p number)))
3448 (setq gnus-newsgroup-unreads
3449 (delq number gnus-newsgroup-unreads))
3450 (if gnus-newsgroup-auto-expire
3451 (push number gnus-newsgroup-expirable)
3452 (push (cons number gnus-low-score-mark)
3453 gnus-newsgroup-reads))))
3455 (when gnus-tmp-header
3456 ;; We may have an old dummy line to output before this
3458 (when gnus-tmp-dummy-line
3459 (gnus-summary-insert-dummy-line
3460 gnus-tmp-dummy-line (mail-header-number gnus-tmp-header))
3461 (setq gnus-tmp-dummy-line nil))
3463 ;; Compute the mark.
3464 (setq gnus-tmp-unread (gnus-article-mark number))
3466 (push (gnus-data-make number gnus-tmp-unread (1+ (point))
3467 gnus-tmp-header gnus-tmp-level)
3468 gnus-newsgroup-data)
3470 ;; Actually insert the line.
3472 gnus-tmp-subject-or-nil
3474 ((and gnus-thread-ignore-subject
3475 gnus-tmp-prev-subject
3476 (not (inline (gnus-subject-equal
3477 gnus-tmp-prev-subject subject))))
3479 ((zerop gnus-tmp-level)
3480 (if (and (eq gnus-summary-make-false-root 'empty)
3481 (memq number gnus-tmp-gathered)
3482 gnus-tmp-prev-subject
3483 (inline (gnus-subject-equal
3484 gnus-tmp-prev-subject subject)))
3485 gnus-summary-same-subject
3487 (t gnus-summary-same-subject)))
3488 (if (and (eq gnus-summary-make-false-root 'adopt)
3489 (= gnus-tmp-level 1)
3490 (memq number gnus-tmp-gathered))
3491 (setq gnus-tmp-opening-bracket ?\<
3492 gnus-tmp-closing-bracket ?\>)
3493 (setq gnus-tmp-opening-bracket ?\[
3494 gnus-tmp-closing-bracket ?\]))
3496 gnus-tmp-indentation
3497 (aref gnus-thread-indent-array gnus-tmp-level)
3498 gnus-tmp-lines (mail-header-lines gnus-tmp-header)
3499 gnus-tmp-score (or (cdr (assq number gnus-newsgroup-scored))
3500 gnus-summary-default-score 0)
3502 (if (or (null gnus-summary-default-score)
3503 (<= (abs (- gnus-tmp-score gnus-summary-default-score))
3504 gnus-summary-zcore-fuzz))
3506 (if (< gnus-tmp-score gnus-summary-default-score)
3507 gnus-score-below-mark gnus-score-over-mark))
3509 (cond ((memq number gnus-newsgroup-processable)
3511 ((memq number gnus-newsgroup-cached)
3513 ((memq number gnus-newsgroup-replied)
3515 ((memq number gnus-newsgroup-saved)
3517 (t gnus-unread-mark))
3518 gnus-tmp-from (mail-header-from gnus-tmp-header)
3521 ((string-match "<[^>]+> *$" gnus-tmp-from)
3522 (setq beg-match (match-beginning 0))
3523 (or (and (string-match "^\"[^\"]*\"" gnus-tmp-from)
3524 (substring gnus-tmp-from (1+ (match-beginning 0))
3525 (1- (match-end 0))))
3526 (substring gnus-tmp-from 0 beg-match)))
3527 ((string-match "(.+)" gnus-tmp-from)
3528 (substring gnus-tmp-from
3529 (1+ (match-beginning 0)) (1- (match-end 0))))
3531 (when (string= gnus-tmp-name "")
3532 (setq gnus-tmp-name gnus-tmp-from))
3533 (unless (numberp gnus-tmp-lines)
3534 (setq gnus-tmp-lines 0))
3535 (gnus-put-text-property
3537 (progn (eval gnus-summary-line-format-spec) (point))
3538 'gnus-number number)
3541 (run-hooks 'gnus-summary-update-hook)
3544 (setq gnus-tmp-prev-subject subject)))
3546 (when (nth 1 thread)
3547 (push (cons (max 0 gnus-tmp-level) (nthcdr 1 thread)) stack))
3548 (incf gnus-tmp-level)
3549 (setq threads (if thread-end nil (cdar thread)))
3551 (setq gnus-tmp-level 0)))))
3552 (gnus-message 7 "Generating summary...done"))
3554 (defun gnus-summary-prepare-unthreaded (headers)
3555 "Generate an unthreaded summary buffer based on HEADERS."
3556 (let (header number mark)
3561 ;; We may have to root out some bad articles...
3562 (when (memq (setq number (mail-header-number
3563 (setq header (pop headers))))
3564 gnus-newsgroup-limit)
3565 ;; Mark article as read when it has a low score.
3566 (when (and gnus-summary-mark-below
3567 (< (or (cdr (assq number gnus-newsgroup-scored))
3568 gnus-summary-default-score 0)
3569 gnus-summary-mark-below)
3570 (not (gnus-summary-article-ancient-p number)))
3571 (setq gnus-newsgroup-unreads
3572 (delq number gnus-newsgroup-unreads))
3573 (if gnus-newsgroup-auto-expire
3574 (push number gnus-newsgroup-expirable)
3575 (push (cons number gnus-low-score-mark)
3576 gnus-newsgroup-reads)))
3578 (setq mark (gnus-article-mark number))
3579 (push (gnus-data-make number mark (1+ (point)) header 0)
3580 gnus-newsgroup-data)
3581 (gnus-summary-insert-line
3583 mark (memq number gnus-newsgroup-replied)
3584 (memq number gnus-newsgroup-expirable)
3585 (mail-header-subject header) nil
3586 (cdr (assq number gnus-newsgroup-scored))
3587 (memq number gnus-newsgroup-processable))))))
3589 (defun gnus-select-newsgroup (group &optional read-all)
3590 "Select newsgroup GROUP.
3591 If READ-ALL is non-nil, all articles in the group are selected."
3592 (let* ((entry (gnus-gethash group gnus-newsrc-hashtb))
3593 ;;!!! Dirty hack; should be removed.
3594 (gnus-summary-ignore-duplicates
3595 (if (eq (car (gnus-find-method-for-group group)) 'nnvirtual)
3597 gnus-summary-ignore-duplicates))
3598 (info (nth 2 entry))
3599 articles fetched-articles cached)
3601 (unless (gnus-check-server
3602 (setq gnus-current-select-method
3603 (gnus-find-method-for-group group)))
3604 (error "Couldn't open server"))
3606 (or (and entry (not (eq (car entry) t))) ; Either it's active...
3607 (gnus-activate-group group) ; Or we can activate it...
3608 (progn ; Or we bug out.
3609 (when (equal major-mode 'gnus-summary-mode)
3610 (kill-buffer (current-buffer)))
3611 (error "Couldn't request group %s: %s"
3612 group (gnus-status-message group))))
3614 (unless (gnus-request-group group t)
3615 (when (equal major-mode 'gnus-summary-mode)
3616 (kill-buffer (current-buffer)))
3617 (error "Couldn't request group %s: %s"