Merge from emacs--devo--0
[gnus] / lisp / gnus-sum.el
1 ;;; gnus-sum.el --- summary mode commands for Gnus
2
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 ;;   2005, 2006, 2007 Free Software Foundation, Inc.
5
6 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
7 ;; Keywords: news
8
9 ;; This file is part of GNU Emacs.
10
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 3, or (at your option)
14 ;; any later version.
15
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19 ;; GNU General Public License for more details.
20
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24 ;; Boston, MA 02110-1301, USA.
25
26 ;;; Commentary:
27
28 ;;; Code:
29
30 ;; For Emacs < 22.2.
31 (eval-and-compile
32   (unless (fboundp 'declare-function) (defmacro declare-function (&rest r))))
33 (eval-when-compile
34   (require 'cl))
35
36 (defvar tool-bar-mode)
37 (defvar gnus-tmp-header)
38
39 (require 'gnus)
40 (require 'gnus-group)
41 (require 'gnus-spec)
42 (require 'gnus-range)
43 (require 'gnus-int)
44 (require 'gnus-undo)
45 (require 'gnus-util)
46 (require 'gmm-utils)
47 (require 'mm-decode)
48 (require 'nnoo)
49
50 (autoload 'gnus-summary-limit-include-cached "gnus-cache" nil t)
51 (autoload 'gnus-cache-write-active "gnus-cache")
52 (autoload 'gnus-mailing-list-insinuate "gnus-ml" nil t)
53 (autoload 'turn-on-gnus-mailing-list-mode "gnus-ml" nil t)
54 (autoload 'gnus-pick-line-number "gnus-salt" nil t)
55 (autoload 'mm-uu-dissect "mm-uu")
56 (autoload 'gnus-article-outlook-deuglify-article "deuglify"
57   "Deuglify broken Outlook (Express) articles and redisplay."
58   t)
59 (autoload 'gnus-article-outlook-unwrap-lines "deuglify" nil t)
60 (autoload 'gnus-article-outlook-repair-attribution "deuglify" nil t)
61 (autoload 'gnus-article-outlook-rearrange-citation "deuglify" nil t)
62
63 (defcustom gnus-kill-summary-on-exit t
64   "*If non-nil, kill the summary buffer when you exit from it.
65 If nil, the summary will become a \"*Dead Summary*\" buffer, and
66 it will be killed sometime later."
67   :group 'gnus-summary-exit
68   :type 'boolean)
69
70 (defcustom gnus-summary-next-group-on-exit t
71   "If non-nil, go to the next unread newsgroup on summary exit.
72 See `gnus-group-goto-unread'."
73   :link '(custom-manual "(gnus)Group Maneuvering")
74   :group 'gnus-summary-exit
75   :version "23.0" ;; No Gnus
76   :type 'boolean)
77
78 (defcustom gnus-fetch-old-headers nil
79   "*Non-nil means that Gnus will try to build threads by grabbing old headers.
80 If an unread article in the group refers to an older, already
81 read (or just marked as read) article, the old article will not
82 normally be displayed in the Summary buffer.  If this variable is
83 t, Gnus will attempt to grab the headers to the old articles, and
84 thereby build complete threads.  If it has the value `some', all
85 old headers will be fetched but only enough headers to connect
86 otherwise loose threads will be displayed.  This variable can
87 also be a number.  In that case, no more than that number of old
88 headers will be fetched.  If it has the value `invisible', all
89 old headers will be fetched, but none will be displayed.
90
91 The server has to support NOV for any of this to work.
92
93 This feature can seriously impact performance it ignores all
94 locally cached header entries."
95   :group 'gnus-thread
96   :type '(choice (const :tag "off" nil)
97                  (const :tag "on" t)
98                  (const some)
99                  (const invisible)
100                  number
101                  (sexp :menu-tag "other" t)))
102
103 (defcustom gnus-refer-thread-limit 500
104   "*The number of old headers to fetch when doing \\<gnus-summary-mode-map>\\[gnus-summary-refer-thread].
105 If t, fetch all the available old headers."
106   :group 'gnus-thread
107   :type '(choice number
108                  (sexp :menu-tag "other" t)))
109
110 (defcustom gnus-summary-make-false-root 'adopt
111   "*nil means that Gnus won't gather loose threads.
112 If the root of a thread has expired or been read in a previous
113 session, the information necessary to build a complete thread has been
114 lost.  Instead of having many small sub-threads from this original thread
115 scattered all over the summary buffer, Gnus can gather them.
116
117 If non-nil, Gnus will try to gather all loose sub-threads from an
118 original thread into one large thread.
119
120 If this variable is non-nil, it should be one of `none', `adopt',
121 `dummy' or `empty'.
122
123 If this variable is `none', Gnus will not make a false root, but just
124 present the sub-threads after another.
125 If this variable is `dummy', Gnus will create a dummy root that will
126 have all the sub-threads as children.
127 If this variable is `adopt', Gnus will make one of the \"children\"
128 the parent and mark all the step-children as such.
129 If this variable is `empty', the \"children\" are printed with empty
130 subject fields.  (Or rather, they will be printed with a string
131 given by the `gnus-summary-same-subject' variable.)"
132   :group 'gnus-thread
133   :type '(choice (const :tag "off" nil)
134                  (const none)
135                  (const dummy)
136                  (const adopt)
137                  (const empty)))
138
139 (defcustom gnus-summary-make-false-root-always nil
140   "Always make a false dummy root."
141   :version "22.1"
142   :group 'gnus-thread
143   :type 'boolean)
144
145 (defcustom gnus-summary-gather-exclude-subject "^ *$\\|^(none)$"
146   "*A regexp to match subjects to be excluded from loose thread gathering.
147 As loose thread gathering is done on subjects only, that means that
148 there can be many false gatherings performed.  By rooting out certain
149 common subjects, gathering might become saner."
150   :group 'gnus-thread
151   :type 'regexp)
152
153 (defcustom gnus-summary-gather-subject-limit nil
154   "*Maximum length of subject comparisons when gathering loose threads.
155 Use nil to compare full subjects.  Setting this variable to a low
156 number will help gather threads that have been corrupted by
157 newsreaders chopping off subject lines, but it might also mean that
158 unrelated articles that have subject that happen to begin with the
159 same few characters will be incorrectly gathered.
160
161 If this variable is `fuzzy', Gnus will use a fuzzy algorithm when
162 comparing subjects."
163   :group 'gnus-thread
164   :type '(choice (const :tag "off" nil)
165                  (const fuzzy)
166                  (sexp :menu-tag "on" t)))
167
168 (defcustom gnus-simplify-subject-functions nil
169   "List of functions taking a string argument that simplify subjects.
170 The functions are applied recursively.
171
172 Useful functions to put in this list include:
173 `gnus-simplify-subject-re', `gnus-simplify-subject-fuzzy',
174 `gnus-simplify-whitespace', and `gnus-simplify-all-whitespace'."
175   :group 'gnus-thread
176   :type '(repeat function))
177
178 (defcustom gnus-simplify-ignored-prefixes nil
179   "*Remove matches for this regexp from subject lines when simplifying fuzzily."
180   :group 'gnus-thread
181   :type '(choice (const :tag "off" nil)
182                  regexp))
183
184 (defcustom gnus-build-sparse-threads nil
185   "*If non-nil, fill in the gaps in threads.
186 If `some', only fill in the gaps that are needed to tie loose threads
187 together.  If `more', fill in all leaf nodes that Gnus can find.  If
188 non-nil and non-`some', fill in all gaps that Gnus manages to guess."
189   :group 'gnus-thread
190   :type '(choice (const :tag "off" nil)
191                  (const some)
192                  (const more)
193                  (sexp :menu-tag "all" t)))
194
195 (defcustom gnus-summary-thread-gathering-function
196   'gnus-gather-threads-by-subject
197   "*Function used for gathering loose threads.
198 There are two pre-defined functions: `gnus-gather-threads-by-subject',
199 which only takes Subjects into consideration; and
200 `gnus-gather-threads-by-references', which compared the References
201 headers of the articles to find matches."
202   :group 'gnus-thread
203   :type '(radio (function-item gnus-gather-threads-by-subject)
204                 (function-item gnus-gather-threads-by-references)
205                 (function :tag "other")))
206
207 (defcustom gnus-summary-same-subject ""
208   "*String indicating that the current article has the same subject as the previous.
209 This variable will only be used if the value of
210 `gnus-summary-make-false-root' is `empty'."
211   :group 'gnus-summary-format
212   :type 'string)
213
214 (defcustom gnus-summary-goto-unread t
215   "*If t, many commands will go to the next unread article.
216 This applies to marking commands as well as other commands that
217 \"naturally\" select the next article, like, for instance, `SPC' at
218 the end of an article.
219
220 If nil, the marking commands do NOT go to the next unread article
221 \(they go to the next article instead).  If `never', commands that
222 usually go to the next unread article, will go to the next article,
223 whether it is read or not."
224   :group 'gnus-summary-marks
225   :link '(custom-manual "(gnus)Setting Marks")
226   :type '(choice (const :tag "off" nil)
227                  (const never)
228                  (sexp :menu-tag "on" t)))
229
230 (defcustom gnus-summary-default-score 0
231   "*Default article score level.
232 All scores generated by the score files will be added to this score.
233 If this variable is nil, scoring will be disabled."
234   :group 'gnus-score-default
235   :type '(choice (const :tag "disable")
236                  integer))
237
238 (defcustom gnus-summary-default-high-score 0
239   "*Default threshold for a high scored article.
240 An article will be highlighted as high scored if its score is greater
241 than this score."
242   :version "22.1"
243   :group 'gnus-score-default
244   :type 'integer)
245
246 (defcustom gnus-summary-default-low-score 0
247   "*Default threshold for a low scored article.
248 An article will be highlighted as low scored if its score is smaller
249 than this score."
250   :version "22.1"
251   :group 'gnus-score-default
252   :type 'integer)
253
254 (defcustom gnus-summary-zcore-fuzz 0
255   "*Fuzziness factor for the zcore in the summary buffer.
256 Articles with scores closer than this to `gnus-summary-default-score'
257 will not be marked."
258   :group 'gnus-summary-format
259   :type 'integer)
260
261 (defcustom gnus-simplify-subject-fuzzy-regexp nil
262   "*Strings to be removed when doing fuzzy matches.
263 This can either be a regular expression or list of regular expressions
264 that will be removed from subject strings if fuzzy subject
265 simplification is selected."
266   :group 'gnus-thread
267   :type '(repeat regexp))
268
269 (defcustom gnus-show-threads t
270   "*If non-nil, display threads in summary mode."
271   :group 'gnus-thread
272   :type 'boolean)
273
274 (defcustom gnus-thread-hide-subtree nil
275   "*If non-nil, hide all threads initially.
276 This can be a predicate specifier which says which threads to hide.
277 If threads are hidden, you have to run the command
278 `gnus-summary-show-thread' by hand or select an article."
279   :group 'gnus-thread
280   :type '(radio (sexp :format "Non-nil\n"
281                       :match (lambda (widget value)
282                                (not (or (consp value) (functionp value))))
283                       :value t)
284                 (const nil)
285                 (sexp :tag "Predicate specifier")))
286
287 (defcustom gnus-thread-hide-killed t
288   "*If non-nil, hide killed threads automatically."
289   :group 'gnus-thread
290   :type 'boolean)
291
292 (defcustom gnus-thread-ignore-subject t
293   "*If non-nil, which is the default, ignore subjects and do all threading based on the Reference header.
294 If nil, articles that have different subjects from their parents will
295 start separate threads."
296   :group 'gnus-thread
297   :type 'boolean)
298
299 (defcustom gnus-thread-operation-ignore-subject t
300   "*If non-nil, subjects will be ignored when doing thread commands.
301 This affects commands like `gnus-summary-kill-thread' and
302 `gnus-summary-lower-thread'.
303
304 If this variable is nil, articles in the same thread with different
305 subjects will not be included in the operation in question.  If this
306 variable is `fuzzy', only articles that have subjects that are fuzzily
307 equal will be included."
308   :group 'gnus-thread
309   :type '(choice (const :tag "off" nil)
310                  (const fuzzy)
311                  (sexp :tag "on" t)))
312
313 (defcustom gnus-thread-indent-level 4
314   "*Number that says how much each sub-thread should be indented."
315   :group 'gnus-thread
316   :type 'integer)
317
318 (defcustom gnus-auto-extend-newsgroup t
319   "*If non-nil, extend newsgroup forward and backward when requested."
320   :group 'gnus-summary-choose
321   :type 'boolean)
322
323 (defcustom gnus-auto-select-first t
324   "If non-nil, select an article on group entry.
325 An article is selected automatically when entering a group
326 e.g. with \\<gnus-group-mode-map>\\[gnus-group-read-group], or via `gnus-summary-next-page' or
327 `gnus-summary-catchup-and-goto-next-group'.
328
329 Which article is selected is controlled by the variable
330 `gnus-auto-select-subject'.
331
332 If you want to prevent automatic selection of articles in some
333 newsgroups, set the variable to nil in `gnus-select-group-hook'."
334   ;; Commands include...
335   ;; \\<gnus-group-mode-map>\\[gnus-group-read-group]
336   ;; \\<gnus-summary-mode-map>\\[gnus-summary-next-page]
337   ;; \\<gnus-summary-mode-map>\\[gnus-summary-catchup-and-goto-next-group]
338   :group 'gnus-group-select
339   :type '(choice (const :tag "none" nil)
340                  (sexp :menu-tag "first" t)))
341
342 (defcustom gnus-auto-select-subject 'unread
343   "*Says what subject to place under point when entering a group.
344
345 This variable can either be the symbols `first' (place point on the
346 first subject), `unread' (place point on the subject line of the first
347 unread article), `best' (place point on the subject line of the
348 higest-scored article), `unseen' (place point on the subject line of
349 the first unseen article), `unseen-or-unread' (place point on the subject
350 line of the first unseen article or, if all article have been seen, on the
351 subject line of the first unread article), or a function to be called to
352 place point on some subject line."
353   :version "22.1"
354   :group 'gnus-group-select
355   :type '(choice (const best)
356                  (const unread)
357                  (const first)
358                  (const unseen)
359                  (const unseen-or-unread)))
360
361 (defcustom gnus-auto-select-next t
362   "*If non-nil, offer to go to the next group from the end of the previous.
363 If the value is t and the next newsgroup is empty, Gnus will exit
364 summary mode and go back to group mode.  If the value is neither nil
365 nor t, Gnus will select the following unread newsgroup.  In
366 particular, if the value is the symbol `quietly', the next unread
367 newsgroup will be selected without any confirmation, and if it is
368 `almost-quietly', the next group will be selected without any
369 confirmation if you are located on the last article in the group.
370 Finally, if this variable is `slightly-quietly', the `\\<gnus-summary-mode-map>\\[gnus-summary-catchup-and-goto-next-group]' command
371 will go to the next group without confirmation."
372   :group 'gnus-summary-maneuvering
373   :type '(choice (const :tag "off" nil)
374                  (const quietly)
375                  (const almost-quietly)
376                  (const slightly-quietly)
377                  (sexp :menu-tag "on" t)))
378
379 (defcustom gnus-auto-select-same nil
380   "*If non-nil, select the next article with the same subject.
381 If there are no more articles with the same subject, go to
382 the first unread article."
383   :group 'gnus-summary-maneuvering
384   :type 'boolean)
385
386 (defcustom gnus-auto-select-on-ephemeral-exit 'next-noselect
387   "What article should be selected after exiting an ephemeral group.
388 Valid values include:
389
390 `next'
391   Select the next article.
392 `next-unread'
393   Select the next unread article.
394 `next-noselect'
395   Move the cursor to the next article.  This is the default.
396 `next-unread-noselect'
397   Move the cursor to the next unread article.
398
399 If it has any other value or there is no next (unread) article, the
400 article selected before entering to the ephemeral group will appear."
401   :version "23.0" ;; No Gnus
402   :group 'gnus-summary-maneuvering
403   :type '(choice :format "%{%t%}:\n %[Value Menu%] %v"
404                  (const next) (const next-unread)
405                  (const next-noselect) (const next-unread-noselect)
406                  (sexp :tag "other" :value nil)))
407
408 (defcustom gnus-auto-goto-ignores 'unfetched
409   "*Says how to handle unfetched articles when maneuvering.
410
411 This variable can either be the symbols nil (maneuver to any
412 article), `undownloaded' (maneuvering while unplugged ignores articles
413 that have not been fetched), `always-undownloaded' (maneuvering always
414 ignores articles that have not been fetched), `unfetched' (maneuvering
415 ignores articles whose headers have not been fetched).
416
417 NOTE: The list of unfetched articles will always be nil when plugged
418 and, when unplugged, a subset of the undownloaded article list."
419   :version "22.1"
420   :group 'gnus-summary-maneuvering
421   :type '(choice (const :tag "None" nil)
422                  (const :tag "Undownloaded when unplugged" undownloaded)
423                  (const :tag "Undownloaded" always-undownloaded)
424                  (const :tag "Unfetched" unfetched)))
425
426 (defcustom gnus-summary-check-current nil
427   "*If non-nil, consider the current article when moving.
428 The \"unread\" movement commands will stay on the same line if the
429 current article is unread."
430   :group 'gnus-summary-maneuvering
431   :type 'boolean)
432
433 (defcustom gnus-auto-center-summary 2
434   "*If non-nil, always center the current summary buffer.
435 In particular, if `vertical' do only vertical recentering.  If non-nil
436 and non-`vertical', do both horizontal and vertical recentering."
437   :group 'gnus-summary-maneuvering
438   :type '(choice (const :tag "none" nil)
439                  (const vertical)
440                  (integer :tag "height")
441                  (sexp :menu-tag "both" t)))
442
443 (defvar gnus-auto-center-group t
444   "*If non-nil, always center the group buffer.")
445
446 (defcustom gnus-show-all-headers nil
447   "*If non-nil, don't hide any headers."
448   :group 'gnus-article-hiding
449   :group 'gnus-article-headers
450   :type 'boolean)
451
452 (defcustom gnus-summary-ignore-duplicates nil
453   "*If non-nil, ignore articles with identical Message-ID headers."
454   :group 'gnus-summary
455   :type 'boolean)
456
457 (defcustom gnus-single-article-buffer t
458   "*If non-nil, display all articles in the same buffer.
459 If nil, each group will get its own article buffer."
460   :group 'gnus-article-various
461   :type 'boolean)
462
463 (defcustom gnus-break-pages t
464   "*If non-nil, do page breaking on articles.
465 The page delimiter is specified by the `gnus-page-delimiter'
466 variable."
467   :group 'gnus-article-various
468   :type 'boolean)
469
470 (defcustom gnus-move-split-methods nil
471   "*Variable used to suggest where articles are to be moved to.
472 It uses the same syntax as the `gnus-split-methods' variable.
473 However, whereas `gnus-split-methods' specifies file names as targets,
474 this variable specifies group names."
475   :group 'gnus-summary-mail
476   :type '(repeat (choice (list :value (fun) function)
477                          (cons :value ("" "") regexp (repeat string))
478                          (sexp :value nil))))
479
480 (defcustom gnus-move-group-prefix-function 'gnus-group-real-prefix
481   "Function used to compute default prefix for article move/copy/etc prompts.
482 The function should take one argument, a group name, and return a
483 string with the suggested prefix."
484   :group 'gnus-summary-mail
485   :type 'function)
486
487 ;; FIXME: Although the custom type is `character' for the following variables,
488 ;; using multibyte characters (Latin-1, UTF-8) doesn't work.  -- rs
489
490 (defcustom gnus-unread-mark ?           ;Whitespace
491   "*Mark used for unread articles."
492   :group 'gnus-summary-marks
493   :type 'character)
494
495 (defcustom gnus-ticked-mark ?!
496   "*Mark used for ticked articles."
497   :group 'gnus-summary-marks
498   :type 'character)
499
500 (defcustom gnus-dormant-mark ??
501   "*Mark used for dormant articles."
502   :group 'gnus-summary-marks
503   :type 'character)
504
505 (defcustom gnus-del-mark ?r
506   "*Mark used for del'd articles."
507   :group 'gnus-summary-marks
508   :type 'character)
509
510 (defcustom gnus-read-mark ?R
511   "*Mark used for read articles."
512   :group 'gnus-summary-marks
513   :type 'character)
514
515 (defcustom gnus-expirable-mark ?E
516   "*Mark used for expirable articles."
517   :group 'gnus-summary-marks
518   :type 'character)
519
520 (defcustom gnus-killed-mark ?K
521   "*Mark used for killed articles."
522   :group 'gnus-summary-marks
523   :type 'character)
524
525 (defcustom gnus-spam-mark ?$
526   "*Mark used for spam articles."
527   :version "22.1"
528   :group 'gnus-summary-marks
529   :type 'character)
530
531 (defcustom gnus-souped-mark ?F
532   "*Mark used for souped articles."
533   :group 'gnus-summary-marks
534   :type 'character)
535
536 (defcustom gnus-kill-file-mark ?X
537   "*Mark used for articles killed by kill files."
538   :group 'gnus-summary-marks
539   :type 'character)
540
541 (defcustom gnus-low-score-mark ?Y
542   "*Mark used for articles with a low score."
543   :group 'gnus-summary-marks
544   :type 'character)
545
546 (defcustom gnus-catchup-mark ?C
547   "*Mark used for articles that are caught up."
548   :group 'gnus-summary-marks
549   :type 'character)
550
551 (defcustom gnus-replied-mark ?A
552   "*Mark used for articles that have been replied to."
553   :group 'gnus-summary-marks
554   :type 'character)
555
556 (defcustom gnus-forwarded-mark ?F
557   "*Mark used for articles that have been forwarded."
558   :version "22.1"
559   :group 'gnus-summary-marks
560   :type 'character)
561
562 (defcustom gnus-recent-mark ?N
563   "*Mark used for articles that are recent."
564   :version "22.1"
565   :group 'gnus-summary-marks
566   :type 'character)
567
568 (defcustom gnus-cached-mark ?*
569   "*Mark used for articles that are in the cache."
570   :group 'gnus-summary-marks
571   :type 'character)
572
573 (defcustom gnus-saved-mark ?S
574   "*Mark used for articles that have been saved."
575   :group 'gnus-summary-marks
576   :type 'character)
577
578 (defcustom gnus-unseen-mark ?.
579   "*Mark used for articles that haven't been seen."
580   :version "22.1"
581   :group 'gnus-summary-marks
582   :type 'character)
583
584 (defcustom gnus-no-mark ?               ;Whitespace
585   "*Mark used for articles that have no other secondary mark."
586   :version "22.1"
587   :group 'gnus-summary-marks
588   :type 'character)
589
590 (defcustom gnus-ancient-mark ?O
591   "*Mark used for ancient articles."
592   :group 'gnus-summary-marks
593   :type 'character)
594
595 (defcustom gnus-sparse-mark ?Q
596   "*Mark used for sparsely reffed articles."
597   :group 'gnus-summary-marks
598   :type 'character)
599
600 (defcustom gnus-canceled-mark ?G
601   "*Mark used for canceled articles."
602   :group 'gnus-summary-marks
603   :type 'character)
604
605 (defcustom gnus-duplicate-mark ?M
606   "*Mark used for duplicate articles."
607   :group 'gnus-summary-marks
608   :type 'character)
609
610 (defcustom gnus-undownloaded-mark ?-
611   "*Mark used for articles that weren't downloaded."
612   :version "22.1"
613   :group 'gnus-summary-marks
614   :type 'character)
615
616 (defcustom gnus-downloaded-mark ?+
617   "*Mark used for articles that were downloaded."
618   :group 'gnus-summary-marks
619   :type 'character)
620
621 (defcustom gnus-downloadable-mark ?%
622   "*Mark used for articles that are to be downloaded."
623   :group 'gnus-summary-marks
624   :type 'character)
625
626 (defcustom gnus-unsendable-mark ?=
627   "*Mark used for articles that won't be sent."
628   :group 'gnus-summary-marks
629   :type 'character)
630
631 (defcustom gnus-score-over-mark ?+
632   "*Score mark used for articles with high scores."
633   :group 'gnus-summary-marks
634   :type 'character)
635
636 (defcustom gnus-score-below-mark ?-
637   "*Score mark used for articles with low scores."
638   :group 'gnus-summary-marks
639   :type 'character)
640
641 (defcustom gnus-empty-thread-mark ?     ;Whitespace
642   "*There is no thread under the article."
643   :group 'gnus-summary-marks
644   :type 'character)
645
646 (defcustom gnus-not-empty-thread-mark ?=
647   "*There is a thread under the article."
648   :group 'gnus-summary-marks
649   :type 'character)
650
651 (defcustom gnus-view-pseudo-asynchronously nil
652   "*If non-nil, Gnus will view pseudo-articles asynchronously."
653   :group 'gnus-extract-view
654   :type 'boolean)
655
656 (defcustom gnus-auto-expirable-marks
657   (list gnus-killed-mark gnus-del-mark gnus-catchup-mark
658         gnus-low-score-mark gnus-ancient-mark gnus-read-mark
659         gnus-souped-mark gnus-duplicate-mark)
660   "*The list of marks converted into expiration if a group is auto-expirable."
661   :version "21.1"
662   :group 'gnus-summary
663   :type '(repeat character))
664
665 (defcustom gnus-inhibit-user-auto-expire t
666   "*If non-nil, user marking commands will not mark an article as expirable, even if the group has auto-expire turned on."
667   :version "21.1"
668   :group 'gnus-summary
669   :type 'boolean)
670
671 (defcustom gnus-view-pseudos nil
672   "*If `automatic', pseudo-articles will be viewed automatically.
673 If `not-confirm', pseudos will be viewed automatically, and the user
674 will not be asked to confirm the command."
675   :group 'gnus-extract-view
676   :type '(choice (const :tag "off" nil)
677                  (const automatic)
678                  (const not-confirm)))
679
680 (defcustom gnus-view-pseudos-separately t
681   "*If non-nil, one pseudo-article will be created for each file to be viewed.
682 If nil, all files that use the same viewing command will be given as a
683 list of parameters to that command."
684   :group 'gnus-extract-view
685   :type 'boolean)
686
687 (defcustom gnus-insert-pseudo-articles t
688   "*If non-nil, insert pseudo-articles when decoding articles."
689   :group 'gnus-extract-view
690   :type 'boolean)
691
692 (defcustom gnus-summary-dummy-line-format
693   "   %(:                             :%) %S\n"
694   "*The format specification for the dummy roots in the summary buffer.
695 It works along the same lines as a normal formatting string,
696 with some simple extensions.
697
698 %S  The subject
699
700 General format specifiers can also be used.
701 See `(gnus)Formatting Variables'."
702   :link '(custom-manual "(gnus)Formatting Variables")
703   :group 'gnus-threading
704   :type 'string)
705
706 (defcustom gnus-summary-mode-line-format "Gnus: %g [%A] %Z"
707   "*The format specification for the summary mode line.
708 It works along the same lines as a normal formatting string,
709 with some simple extensions:
710
711 %G  Group name
712 %p  Unprefixed group name
713 %A  Current article number
714 %z  Current article score
715 %V  Gnus version
716 %U  Number of unread articles in the group
717 %e  Number of unselected articles in the group
718 %Z  A string with unread/unselected article counts
719 %g  Shortish group name
720 %S  Subject of the current article
721 %u  User-defined spec
722 %s  Current score file name
723 %d  Number of dormant articles
724 %r  Number of articles that have been marked as read in this session
725 %E  Number of articles expunged by the score files"
726   :group 'gnus-summary-format
727   :type 'string)
728
729 (defcustom gnus-list-identifiers nil
730   "Regexp that matches list identifiers to be removed from subject.
731 This can also be a list of regexps."
732   :version "21.1"
733   :group 'gnus-summary-format
734   :group 'gnus-article-hiding
735   :type '(choice (const :tag "none" nil)
736                  (regexp :value ".*")
737                  (repeat :value (".*") regexp)))
738
739 (defcustom gnus-summary-mark-below 0
740   "*Mark all articles with a score below this variable as read.
741 This variable is local to each summary buffer and usually set by the
742 score file."
743   :group 'gnus-score-default
744   :type 'integer)
745
746 (defun gnus-widget-reversible-match (widget value)
747   "Ignoring WIDGET, convert VALUE to internal form.
748 VALUE should have the form `FOO' or `(not FOO)', where FOO is an symbol."
749   ;; (debug value)
750   (or (symbolp value)
751       (and (listp value)
752            (eq (length value) 2)
753            (eq (nth 0 value) 'not)
754            (symbolp (nth 1 value)))))
755
756 (defun gnus-widget-reversible-to-internal (widget value)
757   "Ignoring WIDGET, convert VALUE to internal form.
758 VALUE should have the form `FOO' or `(not FOO)', where FOO is an atom.
759 FOO is converted to (FOO nil) and (not FOO) is converted to (FOO t)."
760   ;; (debug value)
761   (if (atom value)
762       (list value nil)
763     (list (nth 1 value) t)))
764
765 (defun gnus-widget-reversible-to-external (widget value)
766   "Ignoring WIDGET, convert VALUE to external form.
767 VALUE should have the form `(FOO nil)' or `(FOO t)', where FOO is an atom.
768 \(FOO  nil) is converted to FOO and (FOO t) is converted to (not FOO)."
769   ;; (debug value)
770   (if (nth 1 value)
771       (list 'not (nth 0 value))
772     (nth 0 value)))
773
774 (define-widget 'gnus-widget-reversible 'group
775   "A `group' that convert values."
776   :match 'gnus-widget-reversible-match
777   :value-to-internal 'gnus-widget-reversible-to-internal
778   :value-to-external 'gnus-widget-reversible-to-external)
779
780 (defcustom gnus-article-sort-functions '(gnus-article-sort-by-number)
781   "*List of functions used for sorting articles in the summary buffer.
782
783 Each function takes two articles and returns non-nil if the first
784 article should be sorted before the other.  If you use more than one
785 function, the primary sort function should be the last.  You should
786 probably always include `gnus-article-sort-by-number' in the list of
787 sorting functions -- preferably first.  Also note that sorting by date
788 is often much slower than sorting by number, and the sorting order is
789 very similar.  (Sorting by date means sorting by the time the message
790 was sent, sorting by number means sorting by arrival time.)
791
792 Each item can also be a list `(not F)' where F is a function;
793 this reverses the sort order.
794
795 Ready-made functions include `gnus-article-sort-by-number',
796 `gnus-article-sort-by-author', `gnus-article-sort-by-subject',
797 `gnus-article-sort-by-date', `gnus-article-sort-by-random'
798 and `gnus-article-sort-by-score'.
799
800 When threading is turned on, the variable `gnus-thread-sort-functions'
801 controls how articles are sorted."
802   :group 'gnus-summary-sort
803   :type '(repeat (gnus-widget-reversible
804                   (choice (function-item gnus-article-sort-by-number)
805                           (function-item gnus-article-sort-by-author)
806                           (function-item gnus-article-sort-by-subject)
807                           (function-item gnus-article-sort-by-date)
808                           (function-item gnus-article-sort-by-score)
809                           (function-item gnus-article-sort-by-random)
810                           (function :tag "other"))
811                   (boolean :tag "Reverse order"))))
812
813
814 (defcustom gnus-thread-sort-functions '(gnus-thread-sort-by-number)
815   "*List of functions used for sorting threads in the summary buffer.
816 By default, threads are sorted by article number.
817
818 Each function takes two threads and returns non-nil if the first
819 thread should be sorted before the other.  If you use more than one
820 function, the primary sort function should be the last.  You should
821 probably always include `gnus-thread-sort-by-number' in the list of
822 sorting functions -- preferably first.  Also note that sorting by date
823 is often much slower than sorting by number, and the sorting order is
824 very similar.  (Sorting by date means sorting by the time the message
825 was sent, sorting by number means sorting by arrival time.)
826
827 Each list item can also be a list `(not F)' where F is a
828 function; this specifies reversed sort order.
829
830 Ready-made functions include `gnus-thread-sort-by-number',
831 `gnus-thread-sort-by-author', `gnus-thread-sort-by-recipient'
832 `gnus-thread-sort-by-subject', `gnus-thread-sort-by-date',
833 `gnus-thread-sort-by-score', `gnus-thread-sort-by-most-recent-number',
834 `gnus-thread-sort-by-most-recent-date', `gnus-thread-sort-by-random',
835 and `gnus-thread-sort-by-total-score' (see
836 `gnus-thread-score-function').
837
838 When threading is turned off, the variable
839 `gnus-article-sort-functions' controls how articles are sorted."
840   :group 'gnus-summary-sort
841   :type '(repeat
842           (gnus-widget-reversible
843            (choice (function-item gnus-thread-sort-by-number)
844                    (function-item gnus-thread-sort-by-author)
845                    (function-item gnus-thread-sort-by-recipient)
846                    (function-item gnus-thread-sort-by-subject)
847                    (function-item gnus-thread-sort-by-date)
848                    (function-item gnus-thread-sort-by-score)
849                    (function-item gnus-thread-sort-by-most-recent-number)
850                    (function-item gnus-thread-sort-by-most-recent-date)
851                    (function-item gnus-thread-sort-by-random)
852                    (function-item gnus-thread-sort-by-total-score)
853                    (function :tag "other"))
854            (boolean :tag "Reverse order"))))
855
856 (defcustom gnus-thread-score-function '+
857   "*Function used for calculating the total score of a thread.
858
859 The function is called with the scores of the article and each
860 subthread and should then return the score of the thread.
861
862 Some functions you can use are `+', `max', or `min'."
863   :group 'gnus-summary-sort
864   :type 'function)
865
866 (defcustom gnus-summary-expunge-below nil
867   "All articles that have a score less than this variable will be expunged.
868 This variable is local to the summary buffers."
869   :group 'gnus-score-default
870   :type '(choice (const :tag "off" nil)
871                  integer))
872
873 (defcustom gnus-thread-expunge-below nil
874   "All threads that have a total score less than this variable will be expunged.
875 See `gnus-thread-score-function' for en explanation of what a
876 \"thread score\" is.
877
878 This variable is local to the summary buffers."
879   :group 'gnus-threading
880   :group 'gnus-score-default
881   :type '(choice (const :tag "off" nil)
882                  integer))
883
884 (defcustom gnus-summary-mode-hook nil
885   "*A hook for Gnus summary mode.
886 This hook is run before any variables are set in the summary buffer."
887   :options '(turn-on-gnus-mailing-list-mode gnus-pick-mode)
888   :group 'gnus-summary-various
889   :type 'hook)
890
891 ;; Extracted from gnus-xmas-redefine in order to preserve user settings
892 (when (featurep 'xemacs)
893   (add-hook 'gnus-summary-mode-hook 'gnus-xmas-summary-menu-add)
894   (add-hook 'gnus-summary-mode-hook 'gnus-xmas-setup-summary-toolbar)
895   (add-hook 'gnus-summary-mode-hook
896             'gnus-xmas-switch-horizontal-scrollbar-off))
897
898 (defcustom gnus-summary-menu-hook nil
899   "*Hook run after the creation of the summary mode menu."
900   :group 'gnus-summary-visual
901   :type 'hook)
902
903 (defcustom gnus-summary-exit-hook nil
904   "*A hook called on exit from the summary buffer.
905 It will be called with point in the group buffer."
906   :group 'gnus-summary-exit
907   :type 'hook)
908
909 (defcustom gnus-summary-prepare-hook nil
910   "*A hook called after the summary buffer has been generated.
911 If you want to modify the summary buffer, you can use this hook."
912   :group 'gnus-summary-various
913   :type 'hook)
914
915 (defcustom gnus-summary-prepared-hook nil
916   "*A hook called as the last thing after the summary buffer has been generated."
917   :group 'gnus-summary-various
918   :type 'hook)
919
920 (defcustom gnus-summary-generate-hook nil
921   "*A hook run just before generating the summary buffer.
922 This hook is commonly used to customize threading variables and the
923 like."
924   :group 'gnus-summary-various
925   :type 'hook)
926
927 (defcustom gnus-select-group-hook nil
928   "*A hook called when a newsgroup is selected.
929
930 If you'd like to simplify subjects like the
931 `gnus-summary-next-same-subject' command does, you can use the
932 following hook:
933
934  (add-hook gnus-select-group-hook
935            (lambda ()
936              (mapcar (lambda (header)
937                        (mail-header-set-subject
938                         header
939                         (gnus-simplify-subject
940                          (mail-header-subject header) 're-only)))
941                      gnus-newsgroup-headers)))"
942   :group 'gnus-group-select
943   :type 'hook)
944
945 (defcustom gnus-select-article-hook nil
946   "*A hook called when an article is selected."
947   :group 'gnus-summary-choose
948   :options '(gnus-agent-fetch-selected-article)
949   :type 'hook)
950
951 (defcustom gnus-visual-mark-article-hook
952   (list 'gnus-highlight-selected-summary)
953   "*Hook run after selecting an article in the summary buffer.
954 It is meant to be used for highlighting the article in some way.  It
955 is not run if `gnus-visual' is nil."
956   :group 'gnus-summary-visual
957   :type 'hook)
958
959 (defcustom gnus-parse-headers-hook nil
960   "*A hook called before parsing the headers."
961   :group 'gnus-various
962   :type 'hook)
963
964 (defcustom gnus-exit-group-hook nil
965   "*A hook called when exiting summary mode.
966 This hook is not called from the non-updating exit commands like `Q'."
967   :group 'gnus-various
968   :type 'hook)
969
970 (defcustom gnus-summary-update-hook
971   (list 'gnus-summary-highlight-line)
972   "*A hook called when a summary line is changed.
973 The hook will not be called if `gnus-visual' is nil.
974
975 The default function `gnus-summary-highlight-line' will
976 highlight the line according to the `gnus-summary-highlight'
977 variable."
978   :group 'gnus-summary-visual
979   :type 'hook)
980
981 (defcustom gnus-mark-article-hook '(gnus-summary-mark-read-and-unread-as-read)
982   "*A hook called when an article is selected for the first time.
983 The hook is intended to mark an article as read (or unread)
984 automatically when it is selected."
985   :group 'gnus-summary-choose
986   :type 'hook)
987
988 (defcustom gnus-group-no-more-groups-hook nil
989   "*A hook run when returning to group mode having no more (unread) groups."
990   :group 'gnus-group-select
991   :type 'hook)
992
993 (defcustom gnus-ps-print-hook nil
994   "*A hook run before ps-printing something from Gnus."
995   :group 'gnus-summary
996   :type 'hook)
997
998 (defcustom gnus-summary-article-move-hook nil
999   "*A hook called after an article is moved, copied, respooled, or crossposted."
1000   :version "22.1"
1001   :group 'gnus-summary
1002   :type 'hook)
1003
1004 (defcustom gnus-summary-article-delete-hook nil
1005   "*A hook called after an article is deleted."
1006   :version "22.1"
1007   :group 'gnus-summary
1008   :type 'hook)
1009
1010 (defcustom gnus-summary-article-expire-hook nil
1011   "*A hook called after an article is expired."
1012   :version "22.1"
1013   :group 'gnus-summary
1014   :type 'hook)
1015
1016 (defcustom gnus-summary-display-arrow
1017   (and (fboundp 'display-graphic-p)
1018        (display-graphic-p))
1019   "*If non-nil, display an arrow highlighting the current article."
1020   :version "22.1"
1021   :group 'gnus-summary
1022   :type 'boolean)
1023
1024 (defcustom gnus-summary-selected-face 'gnus-summary-selected
1025   "Face used for highlighting the current article in the summary buffer."
1026   :group 'gnus-summary-visual
1027   :type 'face)
1028
1029 (defvar gnus-tmp-downloaded nil)
1030
1031 (defcustom gnus-summary-highlight
1032   '(((eq mark gnus-canceled-mark)
1033      . gnus-summary-cancelled)
1034     ((and uncached (> score default-high))
1035      . gnus-summary-high-undownloaded)
1036     ((and uncached (< score default-low))
1037      . gnus-summary-low-undownloaded)
1038     (uncached
1039      . gnus-summary-normal-undownloaded)
1040     ((and (> score default-high)
1041           (or (eq mark gnus-dormant-mark)
1042               (eq mark gnus-ticked-mark)))
1043      . gnus-summary-high-ticked)
1044     ((and (< score default-low)
1045           (or (eq mark gnus-dormant-mark)
1046               (eq mark gnus-ticked-mark)))
1047      . gnus-summary-low-ticked)
1048     ((or (eq mark gnus-dormant-mark)
1049          (eq mark gnus-ticked-mark))
1050      . gnus-summary-normal-ticked)
1051     ((and (> score default-high) (eq mark gnus-ancient-mark))
1052      . gnus-summary-high-ancient)
1053     ((and (< score default-low) (eq mark gnus-ancient-mark))
1054      . gnus-summary-low-ancient)
1055     ((eq mark gnus-ancient-mark)
1056      . gnus-summary-normal-ancient)
1057     ((and (> score default-high) (eq mark gnus-unread-mark))
1058      . gnus-summary-high-unread)
1059     ((and (< score default-low) (eq mark gnus-unread-mark))
1060      . gnus-summary-low-unread)
1061     ((eq mark gnus-unread-mark)
1062      . gnus-summary-normal-unread)
1063     ((> score default-high)
1064      . gnus-summary-high-read)
1065     ((< score default-low)
1066      . gnus-summary-low-read)
1067     (t
1068      . gnus-summary-normal-read))
1069   "*Controls the highlighting of summary buffer lines.
1070
1071 A list of (FORM . FACE) pairs.  When deciding how a particular
1072 summary line should be displayed, each form is evaluated.  The content
1073 of the face field after the first true form is used.  You can change
1074 how those summary lines are displayed, by editing the face field.
1075
1076 You can use the following variables in the FORM field.
1077
1078 score:        The article's score.
1079 default:      The default article score.
1080 default-high: The default score for high scored articles.
1081 default-low:  The default score for low scored articles.
1082 below:        The score below which articles are automatically marked as read.
1083 mark:         The article's mark.
1084 uncached:     Non-nil if the article is uncached."
1085   :group 'gnus-summary-visual
1086   :type '(repeat (cons (sexp :tag "Form" nil)
1087                        face)))
1088 (put 'gnus-summary-highlight 'risky-local-variable t)
1089
1090 (defcustom gnus-alter-header-function nil
1091   "Function called to allow alteration of article header structures.
1092 The function is called with one parameter, the article header vector,
1093 which it may alter in any way."
1094   :type '(choice (const :tag "None" nil)
1095                  function)
1096   :group 'gnus-summary)
1097
1098 (defvar gnus-decode-encoded-word-function 'mail-decode-encoded-word-string
1099   "Function used to decode a string with encoded words.")
1100
1101 (defvar gnus-decode-encoded-address-function
1102   'mail-decode-encoded-address-string
1103   "Function used to decode addresses with encoded words.")
1104
1105 (defcustom gnus-extra-headers '(To Newsgroups)
1106   "*Extra headers to parse."
1107   :version "21.1"
1108   :group 'gnus-summary
1109   :type '(repeat symbol))
1110
1111 (defcustom gnus-ignored-from-addresses
1112   (and user-mail-address
1113        (not (string= user-mail-address ""))
1114        (regexp-quote user-mail-address))
1115   "*From headers that may be suppressed in favor of To headers.
1116 This can be a regexp or a list of regexps."
1117   :version "21.1"
1118   :group 'gnus-summary
1119   :type '(choice regexp
1120                  (repeat :tag "Regexp List" regexp)))
1121
1122 (defsubst gnus-ignored-from-addresses ()
1123   (gmm-regexp-concat gnus-ignored-from-addresses))
1124
1125 (defcustom gnus-summary-to-prefix "-> "
1126   "*String prefixed to the To field in the summary line when
1127 using `gnus-ignored-from-addresses'."
1128   :version "22.1"
1129   :group 'gnus-summary
1130   :type 'string)
1131
1132 (defcustom gnus-summary-newsgroup-prefix "=> "
1133   "*String prefixed to the Newsgroup field in the summary
1134 line when using `gnus-ignored-from-addresses'."
1135   :version "22.1"
1136   :group 'gnus-summary
1137   :type 'string)
1138
1139 (defcustom gnus-newsgroup-ignored-charsets '(unknown-8bit x-unknown)
1140   "List of charsets that should be ignored.
1141 When these charsets are used in the \"charset\" parameter, the
1142 default charset will be used instead."
1143   :version "21.1"
1144   :type '(repeat symbol)
1145   :group 'gnus-charset)
1146
1147 (defcustom gnus-newsgroup-maximum-articles nil
1148   "The maximum number of articles a newsgroup.
1149 If this is a number, old articles in a newsgroup exceeding this number
1150 are silently ignored.  If it is nil, no article is ignored.  Note that
1151 setting this variable to a number might prevent you from reading very
1152 old articles."
1153   :group 'gnus-group-select
1154   :version "22.2"
1155   :type '(choice (const :tag "No limit" nil)
1156                  integer))
1157
1158 (gnus-define-group-parameter
1159  ignored-charsets
1160  :type list
1161  :function-document
1162  "Return the ignored charsets of GROUP."
1163  :variable gnus-group-ignored-charsets-alist
1164  :variable-default
1165  '(("alt\\.chinese\\.text" iso-8859-1))
1166  :variable-document
1167  "Alist of regexps (to match group names) and charsets that should be ignored.
1168 When these charsets are used in the \"charset\" parameter, the
1169 default charset will be used instead."
1170  :variable-group gnus-charset
1171  :variable-type '(repeat (cons (regexp :tag "Group")
1172                                (repeat symbol)))
1173  :parameter-type '(choice :tag "Ignored charsets"
1174                           :value nil
1175                           (repeat (symbol)))
1176  :parameter-document       "\
1177 List of charsets that should be ignored.
1178
1179 When these charsets are used in the \"charset\" parameter, the
1180 default charset will be used instead.")
1181
1182 (defcustom gnus-group-highlight-words-alist nil
1183   "Alist of group regexps and highlight regexps.
1184 This variable uses the same syntax as `gnus-emphasis-alist'."
1185   :version "21.1"
1186   :type '(repeat (cons (regexp :tag "Group")
1187                        (repeat (list (regexp :tag "Highlight regexp")
1188                                      (number :tag "Group for entire word" 0)
1189                                      (number :tag "Group for displayed part" 0)
1190                                      (symbol :tag "Face"
1191                                              gnus-emphasis-highlight-words)))))
1192   :group 'gnus-summary-visual)
1193
1194 (defcustom gnus-summary-show-article-charset-alist
1195   nil
1196   "Alist of number and charset.
1197 The article will be shown with the charset corresponding to the
1198 numbered argument.
1199 For example: ((1 . cn-gb-2312) (2 . big5))."
1200   :version "21.1"
1201   :type '(repeat (cons (number :tag "Argument" 1)
1202                        (symbol :tag "Charset")))
1203   :group 'gnus-charset)
1204
1205 (defcustom gnus-preserve-marks t
1206   "Whether marks are preserved when moving, copying and respooling messages."
1207   :version "21.1"
1208   :type 'boolean
1209   :group 'gnus-summary-marks)
1210
1211 (defcustom gnus-alter-articles-to-read-function nil
1212   "Function to be called to alter the list of articles to be selected."
1213   :type '(choice (const nil) function)
1214   :group 'gnus-summary)
1215
1216 (defcustom gnus-orphan-score nil
1217   "*All orphans get this score added.  Set in the score file."
1218   :group 'gnus-score-default
1219   :type '(choice (const nil)
1220                  integer))
1221
1222 (defcustom gnus-summary-save-parts-default-mime "image/.*"
1223   "*A regexp to match MIME parts when saving multiple parts of a
1224 message with `gnus-summary-save-parts' (\\<gnus-summary-mode-map>\\[gnus-summary-save-parts]).
1225 This regexp will be used by default when prompting the user for which
1226 type of files to save."
1227   :group 'gnus-summary
1228   :type 'regexp)
1229
1230 (defcustom gnus-read-all-available-headers nil
1231   "Whether Gnus should parse all headers made available to it.
1232 This is mostly relevant for slow back ends where the user may
1233 wish to widen the summary buffer to include all headers
1234 that were fetched.  Say, for nnultimate groups."
1235   :version "22.1"
1236   :group 'gnus-summary
1237   :type '(choice boolean regexp))
1238
1239 (defcustom gnus-summary-muttprint-program "muttprint"
1240   "Command (and optional arguments) used to run Muttprint."
1241   :version "22.1"
1242   :group 'gnus-summary
1243   :type 'string)
1244
1245 (defcustom gnus-article-loose-mime t
1246   "If non-nil, don't require MIME-Version header.
1247 Some brain-damaged MUA/MTA, e.g. Lotus Domino 5.0.6 clients, does not
1248 supply the MIME-Version header or deliberately strip it from the mail.
1249 If non-nil (the default), Gnus will treat some articles as MIME
1250 even if the MIME-Version header is missing."
1251   :version "22.1"
1252   :type 'boolean
1253   :group 'gnus-article-mime)
1254
1255 (defcustom gnus-article-emulate-mime t
1256   "If non-nil, use MIME emulation for uuencode and the like.
1257 This means that Gnus will search message bodies for text that look
1258 like uuencoded bits, yEncoded bits, and so on, and present that using
1259 the normal Gnus MIME machinery."
1260   :version "22.1"
1261   :type 'boolean
1262   :group 'gnus-article-mime)
1263
1264 ;;; Internal variables
1265
1266 (defvar gnus-summary-display-cache nil)
1267 (defvar gnus-article-mime-handles nil)
1268 (defvar gnus-article-decoded-p nil)
1269 (defvar gnus-article-charset nil)
1270 (defvar gnus-article-ignored-charsets nil)
1271 (defvar gnus-scores-exclude-files nil)
1272 (defvar gnus-page-broken nil)
1273
1274 (defvar gnus-original-article nil)
1275 (defvar gnus-article-internal-prepare-hook nil)
1276 (defvar gnus-newsgroup-process-stack nil)
1277
1278 (defvar gnus-thread-indent-array nil)
1279 (defvar gnus-thread-indent-array-level gnus-thread-indent-level)
1280 (defvar gnus-sort-gathered-threads-function 'gnus-thread-sort-by-number
1281   "Function called to sort the articles within a thread after it has been gathered together.")
1282
1283 (defvar gnus-summary-save-parts-type-history nil)
1284 (defvar gnus-summary-save-parts-last-directory mm-default-directory)
1285
1286 ;; Avoid highlighting in kill files.
1287 (defvar gnus-summary-inhibit-highlight nil)
1288 (defvar gnus-newsgroup-selected-overlay nil)
1289 (defvar gnus-inhibit-limiting nil)
1290 (defvar gnus-newsgroup-adaptive-score-file nil)
1291 (defvar gnus-current-score-file nil)
1292 (defvar gnus-current-move-group nil)
1293 (defvar gnus-current-copy-group nil)
1294 (defvar gnus-current-crosspost-group nil)
1295 (defvar gnus-newsgroup-display nil)
1296
1297 (defvar gnus-newsgroup-dependencies nil)
1298 (defvar gnus-newsgroup-adaptive nil)
1299 (defvar gnus-summary-display-article-function nil)
1300 (defvar gnus-summary-highlight-line-function nil
1301   "Function called after highlighting a summary line.")
1302
1303 (defvar gnus-summary-line-format-alist
1304   `((?N ,(macroexpand '(mail-header-number gnus-tmp-header)) ?d)
1305     (?S ,(macroexpand '(mail-header-subject gnus-tmp-header)) ?s)
1306     (?s gnus-tmp-subject-or-nil ?s)
1307     (?n gnus-tmp-name ?s)
1308     (?A (car (cdr (funcall gnus-extract-address-components gnus-tmp-from)))
1309         ?s)
1310     (?a (or (car (funcall gnus-extract-address-components gnus-tmp-from))
1311             gnus-tmp-from) ?s)
1312     (?F gnus-tmp-from ?s)
1313     (?x ,(macroexpand '(mail-header-xref gnus-tmp-header)) ?s)
1314     (?D ,(macroexpand '(mail-header-date gnus-tmp-header)) ?s)
1315     (?d (gnus-dd-mmm (mail-header-date gnus-tmp-header)) ?s)
1316     (?o (gnus-date-iso8601 (mail-header-date gnus-tmp-header)) ?s)
1317     (?M ,(macroexpand '(mail-header-id gnus-tmp-header)) ?s)
1318     (?r ,(macroexpand '(mail-header-references gnus-tmp-header)) ?s)
1319     (?c (or (mail-header-chars gnus-tmp-header) 0) ?d)
1320     (?k (gnus-summary-line-message-size gnus-tmp-header) ?s)
1321     (?L gnus-tmp-lines ?s)
1322     (?O gnus-tmp-downloaded ?c)
1323     (?I gnus-tmp-indentation ?s)
1324     (?T (if (= gnus-tmp-level 0) "" (make-string (frame-width) ? )) ?s)
1325     (?R gnus-tmp-replied ?c)
1326     (?\[ gnus-tmp-opening-bracket ?c)
1327     (?\] gnus-tmp-closing-bracket ?c)
1328     (?\> (make-string gnus-tmp-level ? ) ?s)
1329     (?\< (make-string (max 0 (- 20 gnus-tmp-level)) ? ) ?s)
1330     (?i gnus-tmp-score ?d)
1331     (?z gnus-tmp-score-char ?c)
1332     (?V (gnus-thread-total-score (and (boundp 'thread) (car thread))) ?d)
1333     (?U gnus-tmp-unread ?c)
1334     (?f (gnus-summary-from-or-to-or-newsgroups gnus-tmp-header gnus-tmp-from)
1335         ?s)
1336     (?t (gnus-summary-number-of-articles-in-thread
1337          (and (boundp 'thread) (car thread)) gnus-tmp-level)
1338         ?d)
1339     (?e (gnus-summary-number-of-articles-in-thread
1340          (and (boundp 'thread) (car thread)) gnus-tmp-level t)
1341         ?c)
1342     (?u gnus-tmp-user-defined ?s)
1343     (?P (gnus-pick-line-number) ?d)
1344     (?B gnus-tmp-thread-tree-header-string ?s)
1345     (user-date (gnus-user-date
1346                 ,(macroexpand '(mail-header-date gnus-tmp-header))) ?s))
1347   "An alist of format specifications that can appear in summary lines.
1348 These are paired with what variables they correspond with, along with
1349 the type of the variable (string, integer, character, etc).")
1350
1351 (defvar gnus-summary-dummy-line-format-alist
1352   `((?S gnus-tmp-subject ?s)
1353     (?N gnus-tmp-number ?d)
1354     (?u gnus-tmp-user-defined ?s)))
1355
1356 (defvar gnus-summary-mode-line-format-alist
1357   `((?G gnus-tmp-group-name ?s)
1358     (?g (gnus-short-group-name gnus-tmp-group-name) ?s)
1359     (?p (gnus-group-real-name gnus-tmp-group-name) ?s)
1360     (?A gnus-tmp-article-number ?d)
1361     (?Z gnus-tmp-unread-and-unselected ?s)
1362     (?V gnus-version ?s)
1363     (?U gnus-tmp-unread-and-unticked ?d)
1364     (?S gnus-tmp-subject ?s)
1365     (?e gnus-tmp-unselected ?d)
1366     (?u gnus-tmp-user-defined ?s)
1367     (?d (length gnus-newsgroup-dormant) ?d)
1368     (?t (length gnus-newsgroup-marked) ?d)
1369     (?h (length gnus-newsgroup-spam-marked) ?d)
1370     (?r (length gnus-newsgroup-reads) ?d)
1371     (?z (gnus-summary-article-score gnus-tmp-article-number) ?d)
1372     (?E gnus-newsgroup-expunged-tally ?d)
1373     (?s (gnus-current-score-file-nondirectory) ?s)))
1374
1375 (defvar gnus-last-search-regexp nil
1376   "Default regexp for article search command.")
1377
1378 (defvar gnus-last-shell-command nil
1379   "Default shell command on article.")
1380
1381 (defvar gnus-newsgroup-agentized nil
1382   "Locally bound in each summary buffer to indicate whether the server has been agentized.")
1383 (defvar gnus-newsgroup-begin nil)
1384 (defvar gnus-newsgroup-end nil)
1385 (defvar gnus-newsgroup-last-rmail nil)
1386 (defvar gnus-newsgroup-last-mail nil)
1387 (defvar gnus-newsgroup-last-folder nil)
1388 (defvar gnus-newsgroup-last-file nil)
1389 (defvar gnus-newsgroup-last-directory nil)
1390 (defvar gnus-newsgroup-auto-expire nil)
1391 (defvar gnus-newsgroup-active nil)
1392
1393 (defvar gnus-newsgroup-data nil)
1394 (defvar gnus-newsgroup-data-reverse nil)
1395 (defvar gnus-newsgroup-limit nil)
1396 (defvar gnus-newsgroup-limits nil)
1397 (defvar gnus-summary-use-undownloaded-faces nil)
1398
1399 (defvar gnus-newsgroup-unreads nil
1400   "Sorted list of unread articles in the current newsgroup.")
1401
1402 (defvar gnus-newsgroup-unselected nil
1403   "Sorted list of unselected unread articles in the current newsgroup.")
1404
1405 (defvar gnus-newsgroup-reads nil
1406   "Alist of read articles and article marks in the current newsgroup.")
1407
1408 (defvar gnus-newsgroup-expunged-tally nil)
1409
1410 (defvar gnus-newsgroup-marked nil
1411   "Sorted list of ticked articles in the current newsgroup (a subset of unread art).")
1412
1413 (defvar gnus-newsgroup-spam-marked nil
1414   "List of ranges of articles that have been marked as spam.")
1415
1416 (defvar gnus-newsgroup-killed nil
1417   "List of ranges of articles that have been through the scoring process.")
1418
1419 (defvar gnus-newsgroup-cached nil
1420   "Sorted list of articles that come from the article cache.")
1421
1422 (defvar gnus-newsgroup-saved nil
1423   "List of articles that have been saved.")
1424
1425 (defvar gnus-newsgroup-kill-headers nil)
1426
1427 (defvar gnus-newsgroup-replied nil
1428   "List of articles that have been replied to in the current newsgroup.")
1429
1430 (defvar gnus-newsgroup-forwarded nil
1431   "List of articles that have been forwarded in the current newsgroup.")
1432
1433 (defvar gnus-newsgroup-recent nil
1434   "List of articles that have are recent in the current newsgroup.")
1435
1436 (defvar gnus-newsgroup-expirable nil
1437   "Sorted list of articles in the current newsgroup that can be expired.")
1438
1439 (defvar gnus-newsgroup-processable nil
1440   "List of articles in the current newsgroup that can be processed.")
1441
1442 (defvar gnus-newsgroup-downloadable nil
1443   "Sorted list of articles in the current newsgroup that can be processed.")
1444
1445 (defvar gnus-newsgroup-unfetched nil
1446   "Sorted list of articles in the current newsgroup whose headers have
1447 not been fetched into the agent.
1448
1449 This list will always be a subset of gnus-newsgroup-undownloaded.")
1450
1451 (defvar gnus-newsgroup-undownloaded nil
1452   "List of articles in the current newsgroup that haven't been downloaded.")
1453
1454 (defvar gnus-newsgroup-unsendable nil
1455   "List of articles in the current newsgroup that won't be sent.")
1456
1457 (defvar gnus-newsgroup-bookmarks nil
1458   "List of articles in the current newsgroup that have bookmarks.")
1459
1460 (defvar gnus-newsgroup-dormant nil
1461   "Sorted list of dormant articles in the current newsgroup.")
1462
1463 (defvar gnus-newsgroup-unseen nil
1464   "List of unseen articles in the current newsgroup.")
1465
1466 (defvar gnus-newsgroup-seen nil
1467   "Range of seen articles in the current newsgroup.")
1468
1469 (defvar gnus-newsgroup-articles nil
1470   "List of articles in the current newsgroup.")
1471
1472 (defvar gnus-newsgroup-scored nil
1473   "List of scored articles in the current newsgroup.")
1474
1475 (defvar gnus-newsgroup-headers nil
1476   "List of article headers in the current newsgroup.")
1477
1478 (defvar gnus-newsgroup-threads nil)
1479
1480 (defvar gnus-newsgroup-prepared nil
1481   "Whether the current group has been prepared properly.")
1482
1483 (defvar gnus-newsgroup-ancient nil
1484   "List of `gnus-fetch-old-headers' articles in the current newsgroup.")
1485
1486 (defvar gnus-newsgroup-sparse nil)
1487
1488 (defvar gnus-current-article nil)
1489 (defvar gnus-article-current nil)
1490 (defvar gnus-current-headers nil)
1491 (defvar gnus-have-all-headers nil)
1492 (defvar gnus-last-article nil)
1493 (defvar gnus-newsgroup-history nil)
1494 (defvar gnus-newsgroup-charset nil)
1495 (defvar gnus-newsgroup-ephemeral-charset nil)
1496 (defvar gnus-newsgroup-ephemeral-ignored-charsets nil)
1497
1498 (defvar gnus-article-before-search nil)
1499
1500 (defvar gnus-summary-local-variables
1501   '(gnus-newsgroup-name
1502     gnus-newsgroup-begin gnus-newsgroup-end
1503     gnus-newsgroup-last-rmail gnus-newsgroup-last-mail
1504     gnus-newsgroup-last-folder gnus-newsgroup-last-file
1505     gnus-newsgroup-last-directory
1506     gnus-newsgroup-auto-expire gnus-newsgroup-unreads
1507     gnus-newsgroup-unselected gnus-newsgroup-marked
1508     gnus-newsgroup-spam-marked
1509     gnus-newsgroup-reads gnus-newsgroup-saved
1510     gnus-newsgroup-replied gnus-newsgroup-forwarded
1511     gnus-newsgroup-recent
1512     gnus-newsgroup-expirable
1513     gnus-newsgroup-processable gnus-newsgroup-killed
1514     gnus-newsgroup-downloadable gnus-newsgroup-undownloaded
1515     gnus-newsgroup-unfetched
1516     gnus-newsgroup-unsendable gnus-newsgroup-unseen
1517     gnus-newsgroup-seen gnus-newsgroup-articles
1518     gnus-newsgroup-bookmarks gnus-newsgroup-dormant
1519     gnus-newsgroup-headers gnus-newsgroup-threads
1520     gnus-newsgroup-prepared gnus-summary-highlight-line-function
1521     gnus-current-article gnus-current-headers gnus-have-all-headers
1522     gnus-last-article gnus-article-internal-prepare-hook
1523     gnus-newsgroup-dependencies gnus-newsgroup-selected-overlay
1524     gnus-newsgroup-scored gnus-newsgroup-kill-headers
1525     gnus-thread-expunge-below
1526     gnus-score-alist gnus-current-score-file
1527     (gnus-summary-expunge-below . global)
1528     (gnus-summary-mark-below . global)
1529     (gnus-orphan-score . global)
1530     gnus-newsgroup-active gnus-scores-exclude-files
1531     gnus-newsgroup-history gnus-newsgroup-ancient
1532     gnus-newsgroup-sparse gnus-newsgroup-process-stack
1533     (gnus-newsgroup-adaptive . gnus-use-adaptive-scoring)
1534     gnus-newsgroup-adaptive-score-file (gnus-reffed-article-number . -1)
1535     (gnus-newsgroup-expunged-tally . 0)
1536     gnus-cache-removable-articles gnus-newsgroup-cached
1537     gnus-newsgroup-data gnus-newsgroup-data-reverse
1538     gnus-newsgroup-limit gnus-newsgroup-limits
1539     gnus-newsgroup-charset gnus-newsgroup-display
1540     gnus-summary-use-undownloaded-faces)
1541   "Variables that are buffer-local to the summary buffers.")
1542
1543 (defvar gnus-newsgroup-variables nil
1544   "A list of variables that have separate values in different newsgroups.
1545 A list of newsgroup (summary buffer) local variables, or cons of
1546 variables and their default expressions to be evalled (when the default
1547 values are not nil), that should be made global while the summary buffer
1548 is active.
1549
1550 Note: The default expressions will be evaluated (using function `eval')
1551 before assignment to the local variable rather than just assigned to it.
1552 If the default expression is the symbol `global', that symbol will not
1553 be evaluated but the global value of the local variable will be used
1554 instead.
1555
1556 These variables can be used to set variables in the group parameters
1557 while still allowing them to affect operations done in other buffers.
1558 For example:
1559
1560 \(setq gnus-newsgroup-variables
1561      '(message-use-followup-to
1562        (gnus-visible-headers .
1563          \"^From:\\\\|^Newsgroups:\\\\|^Subject:\\\\|^Date:\\\\|^To:\")))
1564 ")
1565
1566 ;; Byte-compiler warning.
1567 (eval-when-compile
1568   ;; Bind features so that require will believe that gnus-sum has
1569   ;; already been loaded (avoids infinite recursion)
1570   (let ((features (cons 'gnus-sum features)))
1571     ;; Several of the declarations in gnus-sum are needed to load the
1572     ;; following files. Right now, these definitions have been
1573     ;; compiled but not defined (evaluated).  We could either do a
1574     ;; eval-and-compile about all of the declarations or evaluate the
1575     ;; source file.
1576     (if (boundp 'gnus-newsgroup-variables)
1577         nil
1578       (load "gnus-sum.el" t t t))
1579     (require 'gnus)
1580     (require 'gnus-art)))
1581
1582 ;; MIME stuff.
1583
1584 (defvar gnus-decode-encoded-word-methods
1585   '(mail-decode-encoded-word-string)
1586   "List of methods used to decode encoded words.
1587
1588 This variable is a list of FUNCTION or (REGEXP . FUNCTION).  If item
1589 is FUNCTION, FUNCTION will be apply to all newsgroups.  If item is a
1590 \(REGEXP . FUNCTION), FUNCTION will be only apply to thes newsgroups
1591 whose names match REGEXP.
1592
1593 For example:
1594 \((\"chinese\" . gnus-decode-encoded-word-string-by-guess)
1595  mail-decode-encoded-word-string
1596  (\"chinese\" . rfc1843-decode-string))")
1597
1598 (defvar gnus-decode-encoded-word-methods-cache nil)
1599
1600 (defun gnus-multi-decode-encoded-word-string (string)
1601   "Apply the functions from `gnus-encoded-word-methods' that match."
1602   (unless (and gnus-decode-encoded-word-methods-cache
1603                (eq gnus-newsgroup-name
1604                    (car gnus-decode-encoded-word-methods-cache)))
1605     (setq gnus-decode-encoded-word-methods-cache (list gnus-newsgroup-name))
1606     (dolist (method gnus-decode-encoded-word-methods)
1607       (if (symbolp method)
1608           (nconc gnus-decode-encoded-word-methods-cache (list method))
1609         (if (and gnus-newsgroup-name
1610                  (string-match (car method) gnus-newsgroup-name))
1611             (nconc gnus-decode-encoded-word-methods-cache
1612                    (list (cdr method)))))))
1613   (dolist (method (cdr gnus-decode-encoded-word-methods-cache) string)
1614     (setq string (funcall method string))))
1615
1616 ;; Subject simplification.
1617
1618 (defun gnus-simplify-whitespace (str)
1619   "Remove excessive whitespace from STR."
1620   ;; Multiple spaces.
1621   (while (string-match "[ \t][ \t]+" str)
1622     (setq str (concat (substring str 0 (match-beginning 0))
1623                         " "
1624                         (substring str (match-end 0)))))
1625   ;; Leading spaces.
1626   (when (string-match "^[ \t]+" str)
1627     (setq str (substring str (match-end 0))))
1628   ;; Trailing spaces.
1629   (when (string-match "[ \t]+$" str)
1630     (setq str (substring str 0 (match-beginning 0))))
1631   str)
1632
1633 (defun gnus-simplify-all-whitespace (str)
1634   "Remove all whitespace from STR."
1635   (while (string-match "[ \t\n]+" str)
1636     (setq str (replace-match "" nil nil str)))
1637   str)
1638
1639 (defsubst gnus-simplify-subject-re (subject)
1640   "Remove \"Re:\" from subject lines."
1641   (if (string-match message-subject-re-regexp subject)
1642       (substring subject (match-end 0))
1643     subject))
1644
1645 (defun gnus-simplify-subject (subject &optional re-only)
1646   "Remove `Re:' and words in parentheses.
1647 If RE-ONLY is non-nil, strip leading `Re:'s only."
1648   (let ((case-fold-search t))           ;Ignore case.
1649     ;; Remove `Re:', `Re^N:', `Re(n)', and `Re[n]:'.
1650     (when (string-match "\\`\\(re\\([[(^][0-9]+[])]?\\)?:[ \t]*\\)+" subject)
1651       (setq subject (substring subject (match-end 0))))
1652     ;; Remove uninteresting prefixes.
1653     (when (and (not re-only)
1654                gnus-simplify-ignored-prefixes
1655                (string-match gnus-simplify-ignored-prefixes subject))
1656       (setq subject (substring subject (match-end 0))))
1657     ;; Remove words in parentheses from end.
1658     (unless re-only
1659       (while (string-match "[ \t\n]*([^()]*)[ \t\n]*\\'" subject)
1660         (setq subject (substring subject 0 (match-beginning 0)))))
1661     ;; Return subject string.
1662     subject))
1663
1664 ;; Remove any leading "re:"s, any trailing paren phrases, and simplify
1665 ;; all whitespace.
1666 (defsubst gnus-simplify-buffer-fuzzy-step (regexp &optional newtext)
1667   (goto-char (point-min))
1668   (while (re-search-forward regexp nil t)
1669     (replace-match (or newtext ""))))
1670
1671 (defun gnus-simplify-buffer-fuzzy ()
1672   "Simplify string in the buffer fuzzily.
1673 The string in the accessible portion of the current buffer is simplified.
1674 It is assumed to be a single-line subject.
1675 Whitespace is generally cleaned up, and miscellaneous leading/trailing
1676 matter is removed.  Additional things can be deleted by setting
1677 `gnus-simplify-subject-fuzzy-regexp'."
1678   (let ((case-fold-search t)
1679         (modified-tick))
1680     (gnus-simplify-buffer-fuzzy-step "\t" " ")
1681
1682     (while (not (eq modified-tick (buffer-modified-tick)))
1683       (setq modified-tick (buffer-modified-tick))
1684       (cond
1685        ((listp gnus-simplify-subject-fuzzy-regexp)
1686         (mapc 'gnus-simplify-buffer-fuzzy-step
1687               gnus-simplify-subject-fuzzy-regexp))
1688        (gnus-simplify-subject-fuzzy-regexp
1689         (gnus-simplify-buffer-fuzzy-step gnus-simplify-subject-fuzzy-regexp)))
1690       (gnus-simplify-buffer-fuzzy-step "^ *\\[[-+?*!][-+?*!]\\] *")
1691       (gnus-simplify-buffer-fuzzy-step
1692        "^ *\\(re\\|fw\\|fwd\\)[[{(^0-9]*[])}]?[:;] *")
1693       (gnus-simplify-buffer-fuzzy-step "^[[].*:\\( .*\\)[]]$" "\\1"))
1694
1695     (gnus-simplify-buffer-fuzzy-step " *[[{(][^()\n]*[]})] *$")
1696     (gnus-simplify-buffer-fuzzy-step "  +" " ")
1697     (gnus-simplify-buffer-fuzzy-step " $")
1698     (gnus-simplify-buffer-fuzzy-step "^ +")))
1699
1700 (defun gnus-simplify-subject-fuzzy (subject)
1701   "Simplify a subject string fuzzily.
1702 See `gnus-simplify-buffer-fuzzy' for details."
1703   (save-excursion
1704     (gnus-set-work-buffer)
1705     (let ((case-fold-search t))
1706       ;; Remove uninteresting prefixes.
1707       (when (and gnus-simplify-ignored-prefixes
1708                  (string-match gnus-simplify-ignored-prefixes subject))
1709         (setq subject (substring subject (match-end 0))))
1710       (insert subject)
1711       (inline (gnus-simplify-buffer-fuzzy))
1712       (buffer-string))))
1713
1714 (defsubst gnus-simplify-subject-fully (subject)
1715   "Simplify a subject string according to `gnus-summary-gather-subject-limit'."
1716   (cond
1717    (gnus-simplify-subject-functions
1718     (gnus-map-function gnus-simplify-subject-functions subject))
1719    ((null gnus-summary-gather-subject-limit)
1720     (gnus-simplify-subject-re subject))
1721    ((eq gnus-summary-gather-subject-limit 'fuzzy)
1722     (gnus-simplify-subject-fuzzy subject))
1723    ((numberp gnus-summary-gather-subject-limit)
1724     (truncate-string-to-width (gnus-simplify-subject-re subject)
1725                               gnus-summary-gather-subject-limit))
1726    (t
1727     subject)))
1728
1729 (defsubst gnus-subject-equal (s1 s2 &optional simple-first)
1730   "Check whether two subjects are equal.
1731 If optional argument SIMPLE-FIRST is t, first argument is already
1732 simplified."
1733   (cond
1734    ((null simple-first)
1735     (equal (gnus-simplify-subject-fully s1)
1736            (gnus-simplify-subject-fully s2)))
1737    (t
1738     (equal s1
1739            (gnus-simplify-subject-fully s2)))))
1740
1741 (defun gnus-summary-bubble-group ()
1742   "Increase the score of the current group.
1743 This is a handy function to add to `gnus-summary-exit-hook' to
1744 increase the score of each group you read."
1745   (gnus-group-add-score gnus-newsgroup-name))
1746
1747 \f
1748 ;;;
1749 ;;; Gnus summary mode
1750 ;;;
1751
1752 (put 'gnus-summary-mode 'mode-class 'special)
1753
1754 (defvar gnus-article-commands-menu)
1755
1756 ;; Non-orthogonal keys
1757
1758 (gnus-define-keys gnus-summary-mode-map
1759   " " gnus-summary-next-page
1760   "\177" gnus-summary-prev-page
1761   [delete] gnus-summary-prev-page
1762   [backspace] gnus-summary-prev-page
1763   "\r" gnus-summary-scroll-up
1764   "\M-\r" gnus-summary-scroll-down
1765   "n" gnus-summary-next-unread-article
1766   "p" gnus-summary-prev-unread-article
1767   "N" gnus-summary-next-article
1768   "P" gnus-summary-prev-article
1769   "\M-\C-n" gnus-summary-next-same-subject
1770   "\M-\C-p" gnus-summary-prev-same-subject
1771   "\M-n" gnus-summary-next-unread-subject
1772   "\M-p" gnus-summary-prev-unread-subject
1773   "." gnus-summary-first-unread-article
1774   "," gnus-summary-best-unread-article
1775   "\M-s" gnus-summary-search-article-forward
1776   "\M-r" gnus-summary-search-article-backward
1777   "\M-S" gnus-summary-repeat-search-article-forward
1778   "\M-R" gnus-summary-repeat-search-article-backward
1779   "<" gnus-summary-beginning-of-article
1780   ">" gnus-summary-end-of-article
1781   "j" gnus-summary-goto-article
1782   "^" gnus-summary-refer-parent-article
1783   "\M-^" gnus-summary-refer-article
1784   "u" gnus-summary-tick-article-forward
1785   "!" gnus-summary-tick-article-forward
1786   "U" gnus-summary-tick-article-backward
1787   "d" gnus-summary-mark-as-read-forward
1788   "D" gnus-summary-mark-as-read-backward
1789   "E" gnus-summary-mark-as-expirable
1790   "\M-u" gnus-summary-clear-mark-forward
1791   "\M-U" gnus-summary-clear-mark-backward
1792   "k" gnus-summary-kill-same-subject-and-select
1793   "\C-k" gnus-summary-kill-same-subject
1794   "\M-\C-k" gnus-summary-kill-thread
1795   "\M-\C-l" gnus-summary-lower-thread
1796   "e" gnus-summary-edit-article
1797   "#" gnus-summary-mark-as-processable
1798   "\M-#" gnus-summary-unmark-as-processable
1799   "\M-\C-t" gnus-summary-toggle-threads
1800   "\M-\C-s" gnus-summary-show-thread
1801   "\M-\C-h" gnus-summary-hide-thread
1802   "\M-\C-f" gnus-summary-next-thread
1803   "\M-\C-b" gnus-summary-prev-thread
1804   [(meta down)] gnus-summary-next-thread
1805   [(meta up)] gnus-summary-prev-thread
1806   "\M-\C-u" gnus-summary-up-thread
1807   "\M-\C-d" gnus-summary-down-thread
1808   "&" gnus-summary-execute-command
1809   "c" gnus-summary-catchup-and-exit
1810   "\C-w" gnus-summary-mark-region-as-read
1811   "\C-t" gnus-summary-toggle-truncation
1812   "?" gnus-summary-mark-as-dormant
1813   "\C-c\M-\C-s" gnus-summary-limit-include-expunged
1814   "\C-c\C-s\C-n" gnus-summary-sort-by-number
1815   "\C-c\C-s\C-l" gnus-summary-sort-by-lines
1816   "\C-c\C-s\C-c" gnus-summary-sort-by-chars
1817   "\C-c\C-s\C-a" gnus-summary-sort-by-author
1818   "\C-c\C-s\C-t" gnus-summary-sort-by-recipient
1819   "\C-c\C-s\C-s" gnus-summary-sort-by-subject
1820   "\C-c\C-s\C-d" gnus-summary-sort-by-date
1821   "\C-c\C-s\C-i" gnus-summary-sort-by-score
1822   "\C-c\C-s\C-o" gnus-summary-sort-by-original
1823   "\C-c\C-s\C-r" gnus-summary-sort-by-random
1824   "=" gnus-summary-expand-window
1825   "\C-x\C-s" gnus-summary-reselect-current-group
1826   "\M-g" gnus-summary-rescan-group
1827   "w" gnus-summary-stop-page-breaking
1828   "\C-c\C-r" gnus-summary-caesar-message
1829   "f" gnus-summary-followup
1830   "F" gnus-summary-followup-with-original
1831   "C" gnus-summary-cancel-article
1832   "r" gnus-summary-reply
1833   "R" gnus-summary-reply-with-original
1834   "\C-c\C-f" gnus-summary-mail-forward
1835   "o" gnus-summary-save-article
1836   "\C-o" gnus-summary-save-article-mail
1837   "|" gnus-summary-pipe-output
1838   "\M-k" gnus-summary-edit-local-kill
1839   "\M-K" gnus-summary-edit-global-kill
1840   ;; "V" gnus-version
1841   "\C-c\C-d" gnus-summary-describe-group
1842   "q" gnus-summary-exit
1843   "Q" gnus-summary-exit-no-update
1844   "\C-c\C-i" gnus-info-find-node
1845   gnus-mouse-2 gnus-mouse-pick-article
1846   [follow-link] mouse-face
1847   "m" gnus-summary-mail-other-window
1848   "a" gnus-summary-post-news
1849   "i" gnus-summary-news-other-window
1850   "x" gnus-summary-limit-to-unread
1851   "s" gnus-summary-isearch-article
1852   "t" gnus-summary-toggle-header
1853   "g" gnus-summary-show-article
1854   "l" gnus-summary-goto-last-article
1855   "\C-c\C-v\C-v" gnus-uu-decode-uu-view
1856   "\C-d" gnus-summary-enter-digest-group
1857   "\M-\C-d" gnus-summary-read-document
1858   "\M-\C-e" gnus-summary-edit-parameters
1859   "\M-\C-a" gnus-summary-customize-parameters
1860   "\C-c\C-b" gnus-bug
1861   "*" gnus-cache-enter-article
1862   "\M-*" gnus-cache-remove-article
1863   "\M-&" gnus-summary-universal-argument
1864   "\C-l" gnus-recenter
1865   "I" gnus-summary-increase-score
1866   "L" gnus-summary-lower-score
1867   "\M-i" gnus-symbolic-argument
1868   "h" gnus-summary-select-article-buffer
1869
1870   "b" gnus-article-view-part
1871   "\M-t" gnus-summary-toggle-display-buttonized
1872
1873   "V" gnus-summary-score-map
1874   "X" gnus-uu-extract-map
1875   "S" gnus-summary-send-map)
1876
1877 ;; Sort of orthogonal keymap
1878 (gnus-define-keys (gnus-summary-mark-map "M" gnus-summary-mode-map)
1879   "t" gnus-summary-tick-article-forward
1880   "!" gnus-summary-tick-article-forward
1881   "d" gnus-summary-mark-as-read-forward
1882   "r" gnus-summary-mark-as-read-forward
1883   "c" gnus-summary-clear-mark-forward
1884   " " gnus-summary-clear-mark-forward
1885   "e" gnus-summary-mark-as-expirable
1886   "x" gnus-summary-mark-as-expirable
1887   "?" gnus-summary-mark-as-dormant
1888   "b" gnus-summary-set-bookmark
1889   "B" gnus-summary-remove-bookmark
1890   "#" gnus-summary-mark-as-processable
1891   "\M-#" gnus-summary-unmark-as-processable
1892   "S" gnus-summary-limit-include-expunged
1893   "C" gnus-summary-catchup
1894   "H" gnus-summary-catchup-to-here
1895   "h" gnus-summary-catchup-from-here
1896   "\C-c" gnus-summary-catchup-all
1897   "k" gnus-summary-kill-same-subject-and-select
1898   "K" gnus-summary-kill-same-subject
1899   "P" gnus-uu-mark-map)
1900
1901 (gnus-define-keys (gnus-summary-mscore-map "V" gnus-summary-mark-map)
1902   "c" gnus-summary-clear-above
1903   "u" gnus-summary-tick-above
1904   "m" gnus-summary-mark-above
1905   "k" gnus-summary-kill-below)
1906
1907 (gnus-define-keys (gnus-summary-limit-map "/" gnus-summary-mode-map)
1908   "/" gnus-summary-limit-to-subject
1909   "n" gnus-summary-limit-to-articles
1910   "b" gnus-summary-limit-to-bodies
1911   "h" gnus-summary-limit-to-headers
1912   "w" gnus-summary-pop-limit
1913   "s" gnus-summary-limit-to-subject
1914   "a" gnus-summary-limit-to-author
1915   "u" gnus-summary-limit-to-unread
1916   "m" gnus-summary-limit-to-marks
1917   "M" gnus-summary-limit-exclude-marks
1918   "v" gnus-summary-limit-to-score
1919   "*" gnus-summary-limit-include-cached
1920   "D" gnus-summary-limit-include-dormant
1921   "T" gnus-summary-limit-include-thread
1922   "d" gnus-summary-limit-exclude-dormant
1923   "t" gnus-summary-limit-to-age
1924   "." gnus-summary-limit-to-unseen
1925   "x" gnus-summary-limit-to-extra
1926   "p" gnus-summary-limit-to-display-predicate
1927   "E" gnus-summary-limit-include-expunged
1928   "c" gnus-summary-limit-exclude-childless-dormant
1929   "C" gnus-summary-limit-mark-excluded-as-read
1930   "o" gnus-summary-insert-old-articles
1931   "N" gnus-summary-insert-new-articles
1932   "S" gnus-summary-limit-to-singletons
1933   "r" gnus-summary-limit-to-replied
1934   "R" gnus-summary-limit-to-recipient
1935   "A" gnus-summary-limit-to-address)
1936
1937 (gnus-define-keys (gnus-summary-goto-map "G" gnus-summary-mode-map)
1938   "n" gnus-summary-next-unread-article
1939   "p" gnus-summary-prev-unread-article
1940   "N" gnus-summary-next-article
1941   "P" gnus-summary-prev-article
1942   "\C-n" gnus-summary-next-same-subject
1943   "\C-p" gnus-summary-prev-same-subject
1944   "\M-n" gnus-summary-next-unread-subject
1945   "\M-p" gnus-summary-prev-unread-subject
1946   "f" gnus-summary-first-unread-article
1947   "b" gnus-summary-best-unread-article
1948   "j" gnus-summary-goto-article
1949   "g" gnus-summary-goto-subject
1950   "l" gnus-summary-goto-last-article
1951   "o" gnus-summary-pop-article)
1952
1953 (gnus-define-keys (gnus-summary-thread-map "T" gnus-summary-mode-map)
1954   "k" gnus-summary-kill-thread
1955   "E" gnus-summary-expire-thread
1956   "l" gnus-summary-lower-thread
1957   "i" gnus-summary-raise-thread
1958   "T" gnus-summary-toggle-threads
1959   "t" gnus-summary-rethread-current
1960   "^" gnus-summary-reparent-thread
1961   "\M-^" gnus-summary-reparent-children
1962   "s" gnus-summary-show-thread
1963   "S" gnus-summary-show-all-threads
1964   "h" gnus-summary-hide-thread
1965   "H" gnus-summary-hide-all-threads
1966   "n" gnus-summary-next-thread
1967   "p" gnus-summary-prev-thread
1968   "u" gnus-summary-up-thread
1969   "o" gnus-summary-top-thread
1970   "d" gnus-summary-down-thread
1971   "#" gnus-uu-mark-thread
1972   "\M-#" gnus-uu-unmark-thread)
1973
1974 (gnus-define-keys (gnus-summary-buffer-map "Y" gnus-summary-mode-map)
1975   "g" gnus-summary-prepare
1976   "c" gnus-summary-insert-cached-articles
1977   "d" gnus-summary-insert-dormant-articles
1978   "t" gnus-summary-insert-ticked-articles)
1979
1980 (gnus-define-keys (gnus-summary-exit-map "Z" gnus-summary-mode-map)
1981   "c" gnus-summary-catchup-and-exit
1982   "C" gnus-summary-catchup-all-and-exit
1983   "E" gnus-summary-exit-no-update
1984   "Q" gnus-summary-exit
1985   "Z" gnus-summary-exit
1986   "n" gnus-summary-catchup-and-goto-next-group
1987   "p" gnus-summary-catchup-and-goto-prev-group
1988   "R" gnus-summary-reselect-current-group
1989   "G" gnus-summary-rescan-group
1990   "N" gnus-summary-next-group
1991   "s" gnus-summary-save-newsrc
1992   "P" gnus-summary-prev-group)
1993
1994 (gnus-define-keys (gnus-summary-article-map "A" gnus-summary-mode-map)
1995   " " gnus-summary-next-page
1996   "n" gnus-summary-next-page
1997   "\177" gnus-summary-prev-page
1998   [delete] gnus-summary-prev-page
1999   "p" gnus-summary-prev-page
2000   "\r" gnus-summary-scroll-up
2001   "\M-\r" gnus-summary-scroll-down
2002   "<" gnus-summary-beginning-of-article
2003   ">" gnus-summary-end-of-article
2004   "b" gnus-summary-beginning-of-article
2005   "e" gnus-summary-end-of-article
2006   "^" gnus-summary-refer-parent-article
2007   "r" gnus-summary-refer-parent-article
2008   "D" gnus-summary-enter-digest-group
2009   "R" gnus-summary-refer-references
2010   "T" gnus-summary-refer-thread
2011   "g" gnus-summary-show-article
2012   "s" gnus-summary-isearch-article
2013   "P" gnus-summary-print-article
2014   "S" gnus-sticky-article
2015   "M" gnus-mailing-list-insinuate
2016   "t" gnus-article-babel)
2017
2018 (gnus-define-keys (gnus-summary-wash-map "W" gnus-summary-mode-map)
2019   "b" gnus-article-add-buttons
2020   "B" gnus-article-add-buttons-to-head
2021   "o" gnus-article-treat-overstrike
2022   "e" gnus-article-emphasize
2023   "w" gnus-article-fill-cited-article
2024   "Q" gnus-article-fill-long-lines
2025   "L" gnus-article-toggle-truncate-lines
2026   "C" gnus-article-capitalize-sentences
2027   "c" gnus-article-remove-cr
2028   "q" gnus-article-de-quoted-unreadable
2029   "6" gnus-article-de-base64-unreadable
2030   "Z" gnus-article-decode-HZ
2031   "A" gnus-article-treat-ansi-sequences
2032   "h" gnus-article-wash-html
2033   "u" gnus-article-unsplit-urls
2034   "s" gnus-summary-force-verify-and-decrypt
2035   "f" gnus-article-display-x-face
2036   "l" gnus-summary-stop-page-breaking
2037   "r" gnus-summary-caesar-message
2038   "m" gnus-summary-morse-message
2039   "t" gnus-summary-toggle-header
2040   "g" gnus-treat-smiley
2041   "v" gnus-summary-verbose-headers
2042   "a" gnus-article-strip-headers-in-body ;; mnemonic: wash archive
2043   "p" gnus-article-verify-x-pgp-sig
2044   "d" gnus-article-treat-dumbquotes
2045   "i" gnus-summary-idna-message)
2046
2047 (gnus-define-keys (gnus-summary-wash-deuglify-map "Y" gnus-summary-wash-map)
2048   ;; mnemonic: deuglif*Y*
2049   "u" gnus-article-outlook-unwrap-lines
2050   "a" gnus-article-outlook-repair-attribution
2051   "c" gnus-article-outlook-rearrange-citation
2052   "f" gnus-article-outlook-deuglify-article) ;; mnemonic: full deuglify
2053
2054 (gnus-define-keys (gnus-summary-wash-hide-map "W" gnus-summary-wash-map)
2055   "a" gnus-article-hide
2056   "h" gnus-article-hide-headers
2057   "b" gnus-article-hide-boring-headers
2058   "s" gnus-article-hide-signature
2059   "c" gnus-article-hide-citation
2060   "C" gnus-article-hide-citation-in-followups
2061   "l" gnus-article-hide-list-identifiers
2062   "B" gnus-article-strip-banner
2063   "P" gnus-article-hide-pem
2064   "\C-c" gnus-article-hide-citation-maybe)
2065
2066 (gnus-define-keys (gnus-summary-wash-highlight-map "H" gnus-summary-wash-map)
2067   "a" gnus-article-highlight
2068   "h" gnus-article-highlight-headers
2069   "c" gnus-article-highlight-citation
2070   "s" gnus-article-highlight-signature)
2071
2072 (gnus-define-keys (gnus-summary-wash-header-map "G" gnus-summary-wash-map)
2073   "f" gnus-article-treat-fold-headers
2074   "u" gnus-article-treat-unfold-headers
2075   "n" gnus-article-treat-fold-newsgroups)
2076
2077 (gnus-define-keys (gnus-summary-wash-display-map "D" gnus-summary-wash-map)
2078   "x" gnus-article-display-x-face
2079   "d" gnus-article-display-face
2080   "s" gnus-treat-smiley
2081   "D" gnus-article-remove-images
2082   "f" gnus-treat-from-picon
2083   "m" gnus-treat-mail-picon
2084   "n" gnus-treat-newsgroups-picon)
2085
2086 (gnus-define-keys (gnus-summary-wash-mime-map "M" gnus-summary-wash-map)
2087   "w" gnus-article-decode-mime-words
2088   "c" gnus-article-decode-charset
2089   "v" gnus-mime-view-all-parts
2090   "b" gnus-article-view-part)
2091
2092 (gnus-define-keys (gnus-summary-wash-time-map "T" gnus-summary-wash-map)
2093   "z" gnus-article-date-ut
2094   "u" gnus-article-date-ut
2095   "l" gnus-article-date-local
2096   "p" gnus-article-date-english
2097   "e" gnus-article-date-lapsed
2098   "o" gnus-article-date-original
2099   "i" gnus-article-date-iso8601
2100   "s" gnus-article-date-user)
2101
2102 (gnus-define-keys (gnus-summary-wash-empty-map "E" gnus-summary-wash-map)
2103   "t" gnus-article-remove-trailing-blank-lines
2104   "l" gnus-article-strip-leading-blank-lines
2105   "m" gnus-article-strip-multiple-blank-lines
2106   "a" gnus-article-strip-blank-lines
2107   "A" gnus-article-strip-all-blank-lines
2108   "s" gnus-article-strip-leading-space
2109   "e" gnus-article-strip-trailing-space
2110   "w" gnus-article-remove-leading-whitespace)
2111
2112 (gnus-define-keys (gnus-summary-help-map "H" gnus-summary-mode-map)
2113   "v" gnus-version
2114   "f" gnus-summary-fetch-faq
2115   "d" gnus-summary-describe-group
2116   "h" gnus-summary-describe-briefly
2117   "i" gnus-info-find-node
2118   "c" gnus-group-fetch-charter
2119   "C" gnus-group-fetch-control)
2120
2121 (gnus-define-keys (gnus-summary-backend-map "B" gnus-summary-mode-map)
2122   "e" gnus-summary-expire-articles
2123   "\M-\C-e" gnus-summary-expire-articles-now
2124   "\177" gnus-summary-delete-article
2125   [delete] gnus-summary-delete-article
2126   [backspace] gnus-summary-delete-article
2127   "m" gnus-summary-move-article
2128   "r" gnus-summary-respool-article
2129   "w" gnus-summary-edit-article
2130   "c" gnus-summary-copy-article
2131   "B" gnus-summary-crosspost-article
2132   "q" gnus-summary-respool-query
2133   "t" gnus-summary-respool-trace
2134   "i" gnus-summary-import-article
2135   "I" gnus-summary-create-article
2136   "p" gnus-summary-article-posted-p)
2137
2138 (gnus-define-keys (gnus-summary-save-map "O" gnus-summary-mode-map)
2139   "o" gnus-summary-save-article
2140   "m" gnus-summary-save-article-mail
2141   "F" gnus-summary-write-article-file
2142   "r" gnus-summary-save-article-rmail
2143   "f" gnus-summary-save-article-file
2144   "b" gnus-summary-save-article-body-file
2145   "B" gnus-summary-write-article-body-file
2146   "h" gnus-summary-save-article-folder
2147   "v" gnus-summary-save-article-vm
2148   "p" gnus-summary-pipe-output
2149   "P" gnus-summary-muttprint
2150   "s" gnus-soup-add-article)
2151
2152 (gnus-define-keys (gnus-summary-mime-map "K" gnus-summary-mode-map)
2153   "b" gnus-summary-display-buttonized
2154   "m" gnus-summary-repair-multipart
2155   "v" gnus-article-view-part
2156   "o" gnus-article-save-part
2157   "O" gnus-article-save-part-and-strip
2158   "r" gnus-article-replace-part
2159   "d" gnus-article-delete-part
2160   "t" gnus-article-view-part-as-type
2161   "j" gnus-article-jump-to-part
2162   "c" gnus-article-copy-part
2163   "C" gnus-article-view-part-as-charset
2164   "e" gnus-article-view-part-externally
2165   "H" gnus-article-browse-html-article
2166   "E" gnus-article-encrypt-body
2167   "i" gnus-article-inline-part
2168   "|" gnus-article-pipe-part)
2169
2170 (gnus-define-keys (gnus-uu-mark-map "P" gnus-summary-mark-map)
2171   "p" gnus-summary-mark-as-processable
2172   "u" gnus-summary-unmark-as-processable
2173   "U" gnus-summary-unmark-all-processable
2174   "v" gnus-uu-mark-over
2175   "s" gnus-uu-mark-series
2176   "r" gnus-uu-mark-region
2177   "g" gnus-uu-unmark-region
2178   "R" gnus-uu-mark-by-regexp
2179   "G" gnus-uu-unmark-by-regexp
2180   "t" gnus-uu-mark-thread
2181   "T" gnus-uu-unmark-thread
2182   "a" gnus-uu-mark-all
2183   "b" gnus-uu-mark-buffer
2184   "S" gnus-uu-mark-sparse
2185   "k" gnus-summary-kill-process-mark
2186   "y" gnus-summary-yank-process-mark
2187   "w" gnus-summary-save-process-mark
2188   "i" gnus-uu-invert-processable)
2189
2190 (gnus-define-keys (gnus-uu-extract-map "X" gnus-summary-mode-map)
2191   ;;"x" gnus-uu-extract-any
2192   "m" gnus-summary-save-parts
2193   "u" gnus-uu-decode-uu
2194   "U" gnus-uu-decode-uu-and-save
2195   "s" gnus-uu-decode-unshar
2196   "S" gnus-uu-decode-unshar-and-save
2197   "o" gnus-uu-decode-save
2198   "O" gnus-uu-decode-save
2199   "b" gnus-uu-decode-binhex
2200   "B" gnus-uu-decode-binhex
2201   "Y" gnus-uu-decode-yenc
2202   "p" gnus-uu-decode-postscript
2203   "P" gnus-uu-decode-postscript-and-save)
2204
2205 (gnus-define-keys
2206     (gnus-uu-extract-view-map "v" gnus-uu-extract-map)
2207   "u" gnus-uu-decode-uu-view
2208   "U" gnus-uu-decode-uu-and-save-view
2209   "s" gnus-uu-decode-unshar-view
2210   "S" gnus-uu-decode-unshar-and-save-view
2211   "o" gnus-uu-decode-save-view
2212   "O" gnus-uu-decode-save-view
2213   "b" gnus-uu-decode-binhex-view
2214   "B" gnus-uu-decode-binhex-view
2215   "p" gnus-uu-decode-postscript-view
2216   "P" gnus-uu-decode-postscript-and-save-view)
2217
2218 (defvar gnus-article-post-menu nil)
2219
2220 (defconst gnus-summary-menu-maxlen 20)
2221
2222 (defun gnus-summary-menu-split (menu)
2223   ;; If we have lots of elements, divide them into groups of 20
2224   ;; and make a pane (or submenu) for each one.
2225   (if (> (length menu) (/ (* gnus-summary-menu-maxlen 3) 2))
2226       (let ((menu menu) sublists next
2227             (i 1))
2228         (while menu
2229           ;; Pull off the next gnus-summary-menu-maxlen elements
2230           ;; and make them the next element of sublist.
2231           (setq next (nthcdr gnus-summary-menu-maxlen menu))
2232           (if next
2233               (setcdr (nthcdr (1- gnus-summary-menu-maxlen) menu)
2234                       nil))
2235           (setq sublists (cons (cons (format "%s ... %s" (aref (car menu) 0)
2236                                              (aref (car (last menu)) 0)) menu)
2237                                sublists))
2238           (setq i (1+ i))
2239           (setq menu next))
2240         (nreverse sublists))
2241     ;; Few elements--put them all in one pane.
2242     menu))
2243
2244 (defun gnus-summary-make-menu-bar ()
2245   (gnus-turn-off-edit-menu 'summary)
2246
2247   (unless (boundp 'gnus-summary-misc-menu)
2248
2249     (easy-menu-define
2250       gnus-summary-kill-menu gnus-summary-mode-map ""
2251       (cons
2252        "Score"
2253        (nconc
2254         (list
2255          ["Customize" gnus-score-customize t])
2256         (gnus-make-score-map 'increase)
2257         (gnus-make-score-map 'lower)
2258         '(("Mark"
2259            ["Kill below" gnus-summary-kill-below t]
2260            ["Mark above" gnus-summary-mark-above t]
2261            ["Tick above" gnus-summary-tick-above t]
2262            ["Clear above" gnus-summary-clear-above t])
2263           ["Current score" gnus-summary-current-score t]
2264           ["Set score" gnus-summary-set-score t]
2265           ["Switch current score file..." gnus-score-change-score-file t]
2266           ["Set mark below..." gnus-score-set-mark-below t]
2267           ["Set expunge below..." gnus-score-set-expunge-below t]
2268           ["Edit current score file" gnus-score-edit-current-scores t]
2269           ["Edit score file" gnus-score-edit-file t]
2270           ["Trace score" gnus-score-find-trace t]
2271           ["Find words" gnus-score-find-favourite-words t]
2272           ["Rescore buffer" gnus-summary-rescore t]
2273           ["Increase score..." gnus-summary-increase-score t]
2274           ["Lower score..." gnus-summary-lower-score t]))))
2275
2276     ;; Define both the Article menu in the summary buffer and the
2277     ;; equivalent Commands menu in the article buffer here for
2278     ;; consistency.
2279     (let ((innards
2280            `(("Hide"
2281               ["All" gnus-article-hide t]
2282               ["Headers" gnus-article-hide-headers t]
2283               ["Signature" gnus-article-hide-signature t]
2284               ["Citation" gnus-article-hide-citation t]
2285               ["List identifiers" gnus-article-hide-list-identifiers t]
2286               ["Banner" gnus-article-strip-banner t]
2287               ["Boring headers" gnus-article-hide-boring-headers t])
2288              ("Highlight"
2289               ["All" gnus-article-highlight t]
2290               ["Headers" gnus-article-highlight-headers t]
2291               ["Signature" gnus-article-highlight-signature t]
2292               ["Citation" gnus-article-highlight-citation t])
2293              ("MIME"
2294               ["Words" gnus-article-decode-mime-words t]
2295               ["Charset" gnus-article-decode-charset t]
2296               ["QP" gnus-article-de-quoted-unreadable t]
2297               ["Base64" gnus-article-de-base64-unreadable t]
2298               ["View MIME buttons" gnus-summary-display-buttonized t]
2299               ["View all" gnus-mime-view-all-parts t]
2300               ["Verify and Decrypt" gnus-summary-force-verify-and-decrypt t]
2301               ["Encrypt body" gnus-article-encrypt-body
2302                :active (not (gnus-group-read-only-p))
2303                ,@(if (featurep 'xemacs) nil
2304                    '(:help "Encrypt the message body on disk"))]
2305               ["Extract all parts..." gnus-summary-save-parts t]
2306               ("Multipart"
2307                ["Repair multipart" gnus-summary-repair-multipart t]
2308                ["Pipe part..." gnus-article-pipe-part t]
2309                ["Inline part" gnus-article-inline-part t]
2310                ["View part as type..." gnus-article-view-part-as-type t]
2311                ["Encrypt body" gnus-article-encrypt-body
2312                 :active (not (gnus-group-read-only-p))
2313                ,@(if (featurep 'xemacs) nil
2314                    '(:help "Encrypt the message body on disk"))]
2315                ["View part externally" gnus-article-view-part-externally t]
2316                ["View HTML parts in browser" gnus-article-browse-html-article t]
2317                ["View part with charset..." gnus-article-view-part-as-charset t]
2318                ["Copy part" gnus-article-copy-part t]
2319                ["Save part..." gnus-article-save-part t]
2320                ["View part" gnus-article-view-part t]))
2321              ("Date"
2322               ["Local" gnus-article-date-local t]
2323               ["ISO8601" gnus-article-date-iso8601 t]
2324               ["UT" gnus-article-date-ut t]
2325               ["Original" gnus-article-date-original t]
2326               ["Lapsed" gnus-article-date-lapsed t]
2327               ["User-defined" gnus-article-date-user t])
2328              ("Display"
2329               ["Remove images" gnus-article-remove-images t]
2330               ["Toggle smiley" gnus-treat-smiley t]
2331               ["Show X-Face" gnus-article-display-x-face t]
2332               ["Show picons in From" gnus-treat-from-picon t]
2333               ["Show picons in mail headers" gnus-treat-mail-picon t]
2334               ["Show picons in news headers" gnus-treat-newsgroups-picon t]
2335               ("View as different encoding"
2336                ,@(gnus-summary-menu-split
2337                   (mapcar
2338                    (lambda (cs)
2339                      ;; Since easymenu under Emacs doesn't allow
2340                      ;; lambda forms for menu commands, we should
2341                      ;; provide intern'ed function symbols.
2342                      (let ((command (intern (format "\
2343 gnus-summary-show-article-from-menu-as-charset-%s" cs))))
2344                        (fset command
2345                              `(lambda ()
2346                                 (interactive)
2347                                 (let ((gnus-summary-show-article-charset-alist
2348                                        '((1 . ,cs))))
2349                                   (gnus-summary-show-article 1))))
2350                        `[,(symbol-name cs) ,command t]))
2351                    (sort (if (fboundp 'coding-system-list)
2352                              (coding-system-list)
2353                            (mapcar 'car mm-mime-mule-charset-alist))
2354                          'string<)))))
2355              ("Washing"
2356               ("Remove Blanks"
2357                ["Leading" gnus-article-strip-leading-blank-lines t]
2358                ["Multiple" gnus-article-strip-multiple-blank-lines t]
2359                ["Trailing" gnus-article-remove-trailing-blank-lines t]
2360                ["All of the above" gnus-article-strip-blank-lines t]
2361                ["All" gnus-article-strip-all-blank-lines t]
2362                ["Leading space" gnus-article-strip-leading-space t]
2363                ["Trailing space" gnus-article-strip-trailing-space t]
2364                ["Leading space in headers"
2365                 gnus-article-remove-leading-whitespace t])
2366               ["Overstrike" gnus-article-treat-overstrike t]
2367               ["Dumb quotes" gnus-article-treat-dumbquotes t]
2368               ["Emphasis" gnus-article-emphasize t]
2369               ["Word wrap" gnus-article-fill-cited-article t]
2370               ["Fill long lines" gnus-article-fill-long-lines t]
2371               ["Toggle truncate long lines" gnus-article-toggle-truncate-lines t]
2372               ["Capitalize sentences" gnus-article-capitalize-sentences t]
2373               ["Remove CR" gnus-article-remove-cr t]
2374               ["Quoted-Printable" gnus-article-de-quoted-unreadable t]
2375               ["Base64" gnus-article-de-base64-unreadable t]
2376               ["Rot 13" gnus-summary-caesar-message
2377                ,@(if (featurep 'xemacs) '(t)
2378                    '(:help "\"Caesar rotate\" article by 13"))]
2379               ["De-IDNA" gnus-summary-idna-message t]
2380               ["Morse decode" gnus-summary-morse-message t]
2381               ["Unix pipe..." gnus-summary-pipe-message t]
2382               ["Add buttons" gnus-article-add-buttons t]
2383               ["Add buttons to head" gnus-article-add-buttons-to-head t]
2384               ["Stop page breaking" gnus-summary-stop-page-breaking t]
2385               ["Verbose header" gnus-summary-verbose-headers t]
2386               ["Toggle header" gnus-summary-toggle-header t]
2387               ["Unfold headers" gnus-article-treat-unfold-headers t]
2388               ["Fold newsgroups" gnus-article-treat-fold-newsgroups t]
2389               ["Html" gnus-article-wash-html t]
2390               ["Unsplit URLs" gnus-article-unsplit-urls t]
2391               ["Verify X-PGP-Sig" gnus-article-verify-x-pgp-sig t]
2392               ["Decode HZ" gnus-article-decode-HZ t]
2393               ["ANSI sequences" gnus-article-treat-ansi-sequences t]
2394               ("(Outlook) Deuglify"
2395                ["Unwrap lines" gnus-article-outlook-unwrap-lines t]
2396                ["Repair attribution" gnus-article-outlook-repair-attribution t]
2397                ["Rearrange citation" gnus-article-outlook-rearrange-citation t]
2398                ["Full (Outlook) deuglify"
2399                 gnus-article-outlook-deuglify-article t])
2400               )
2401              ("Output"
2402               ["Save in default format..." gnus-summary-save-article
2403                ,@(if (featurep 'xemacs) '(t)
2404                    '(:help "Save article using default method"))]
2405               ["Save in file..." gnus-summary-save-article-file
2406                ,@(if (featurep 'xemacs) '(t)
2407                    '(:help "Save article in file"))]
2408               ["Save in Unix mail format..." gnus-summary-save-article-mail t]
2409               ["Save in MH folder..." gnus-summary-save-article-folder t]
2410               ["Save in VM folder..." gnus-summary-save-article-vm t]
2411               ["Save in RMAIL mbox..." gnus-summary-save-article-rmail t]
2412               ["Save body in file..." gnus-summary-save-article-body-file t]
2413               ["Pipe through a filter..." gnus-summary-pipe-output t]
2414               ["Add to SOUP packet" gnus-soup-add-article t]
2415               ["Print with Muttprint..." gnus-summary-muttprint t]
2416               ["Print" gnus-summary-print-article
2417                ,@(if (featurep 'xemacs) '(t)
2418                    '(:help "Generate and print a PostScript image"))])
2419              ("Copy, move,... (Backend)"
2420               ,@(if (featurep 'xemacs) nil
2421                   '(:help "Copying, moving, expiring articles..."))
2422               ["Respool article..." gnus-summary-respool-article t]
2423               ["Move article..." gnus-summary-move-article
2424                (gnus-check-backend-function
2425                 'request-move-article gnus-newsgroup-name)]
2426               ["Copy article..." gnus-summary-copy-article t]
2427               ["Crosspost article..." gnus-summary-crosspost-article
2428                (gnus-check-backend-function
2429                 'request-replace-article gnus-newsgroup-name)]
2430               ["Import file..." gnus-summary-import-article
2431                (gnus-check-backend-function
2432                 'request-accept-article gnus-newsgroup-name)]
2433               ["Create article..." gnus-summary-create-article
2434                (gnus-check-backend-function
2435                 'request-accept-article gnus-newsgroup-name)]
2436               ["Check if posted" gnus-summary-article-posted-p t]
2437               ["Edit article" gnus-summary-edit-article
2438                (not (gnus-group-read-only-p))]
2439               ["Delete article" gnus-summary-delete-article
2440                (gnus-check-backend-function
2441                 'request-expire-articles gnus-newsgroup-name)]
2442               ["Query respool" gnus-summary-respool-query t]
2443               ["Trace respool" gnus-summary-respool-trace t]
2444               ["Delete expirable articles" gnus-summary-expire-articles-now
2445                (gnus-check-backend-function
2446                 'request-expire-articles gnus-newsgroup-name)])
2447              ("Extract"
2448               ["Uudecode" gnus-uu-decode-uu
2449                ,@(if (featurep 'xemacs) '(t)
2450                    '(:help "Decode uuencoded article(s)"))]
2451               ["Uudecode and save" gnus-uu-decode-uu-and-save t]
2452               ["Unshar" gnus-uu-decode-unshar t]
2453               ["Unshar and save" gnus-uu-decode-unshar-and-save t]
2454               ["Save" gnus-uu-decode-save t]
2455               ["Binhex" gnus-uu-decode-binhex t]
2456               ["Postscript" gnus-uu-decode-postscript t]
2457               ["All MIME parts" gnus-summary-save-parts t])
2458              ("Cache"
2459               ["Enter article" gnus-cache-enter-article t]
2460               ["Remove article" gnus-cache-remove-article t])
2461              ["Translate" gnus-article-babel t]
2462              ["Select article buffer" gnus-summary-select-article-buffer t]
2463              ["Make article buffer sticky" gnus-sticky-article t]
2464              ["Enter digest buffer" gnus-summary-enter-digest-group t]
2465              ["Isearch article..." gnus-summary-isearch-article t]
2466              ["Beginning of the article" gnus-summary-beginning-of-article t]
2467              ["End of the article" gnus-summary-end-of-article t]
2468              ["Fetch parent of article" gnus-summary-refer-parent-article t]
2469              ["Fetch referenced articles" gnus-summary-refer-references t]
2470              ["Fetch current thread" gnus-summary-refer-thread t]
2471              ["Fetch article with id..." gnus-summary-refer-article t]
2472              ["Setup Mailing List Params" gnus-mailing-list-insinuate t]
2473              ["Redisplay" gnus-summary-show-article t]
2474              ["Raw article" gnus-summary-show-raw-article :keys "C-u g"])))
2475       (easy-menu-define
2476         gnus-summary-article-menu gnus-summary-mode-map ""
2477         (cons "Article" innards))
2478
2479       (if (not (keymapp gnus-summary-article-menu))
2480           (easy-menu-define
2481             gnus-article-commands-menu gnus-article-mode-map ""
2482             (cons "Commands" innards))
2483         ;; in Emacs, don't share menu.
2484         (setq gnus-article-commands-menu
2485               (copy-keymap gnus-summary-article-menu))
2486         (define-key gnus-article-mode-map [menu-bar commands]
2487           (cons "Commands" gnus-article-commands-menu))))
2488
2489     (easy-menu-define
2490       gnus-summary-thread-menu gnus-summary-mode-map ""
2491       '("Threads"
2492         ["Find all messages in thread" gnus-summary-refer-thread t]
2493         ["Toggle threading" gnus-summary-toggle-threads t]
2494         ["Hide threads" gnus-summary-hide-all-threads t]
2495         ["Show threads" gnus-summary-show-all-threads t]
2496         ["Hide thread" gnus-summary-hide-thread t]
2497         ["Show thread" gnus-summary-show-thread t]
2498         ["Go to next thread" gnus-summary-next-thread t]
2499         ["Go to previous thread" gnus-summary-prev-thread t]
2500         ["Go down thread" gnus-summary-down-thread t]
2501         ["Go up thread" gnus-summary-up-thread t]
2502         ["Top of thread" gnus-summary-top-thread t]
2503         ["Mark thread as read" gnus-summary-kill-thread t]
2504         ["Mark thread as expired" gnus-summary-expire-thread t]
2505         ["Lower thread score" gnus-summary-lower-thread t]
2506         ["Raise thread score" gnus-summary-raise-thread t]
2507         ["Rethread current" gnus-summary-rethread-current t]))
2508
2509     (easy-menu-define
2510       gnus-summary-post-menu gnus-summary-mode-map ""
2511       `("Post"
2512         ["Send a message (mail or news)" gnus-summary-post-news
2513          ,@(if (featurep 'xemacs) '(t)
2514              '(:help "Compose a new message (mail or news)"))]
2515         ["Followup" gnus-summary-followup
2516          ,@(if (featurep 'xemacs) '(t)
2517              '(:help "Post followup to this article"))]
2518         ["Followup and yank" gnus-summary-followup-with-original
2519          ,@(if (featurep 'xemacs) '(t)
2520              '(:help "Post followup to this article, quoting its contents"))]
2521         ["Supersede article" gnus-summary-supersede-article t]
2522         ["Cancel article" gnus-summary-cancel-article
2523          ,@(if (featurep 'xemacs) '(t)
2524              '(:help "Cancel an article you posted"))]
2525         ["Reply" gnus-summary-reply t]
2526         ["Reply and yank" gnus-summary-reply-with-original t]
2527         ["Wide reply" gnus-summary-wide-reply t]
2528         ["Wide reply and yank" gnus-summary-wide-reply-with-original
2529          ,@(if (featurep 'xemacs) '(t)
2530              '(:help "Mail a reply, quoting this article"))]
2531         ["Very wide reply" gnus-summary-very-wide-reply t]
2532         ["Very wide reply and yank" gnus-summary-very-wide-reply-with-original
2533          ,@(if (featurep 'xemacs) '(t)
2534              '(:help "Mail a very wide reply, quoting this article"))]
2535         ["Mail forward" gnus-summary-mail-forward t]
2536         ["Post forward" gnus-summary-post-forward t]
2537         ["Digest and mail" gnus-uu-digest-mail-forward t]
2538         ["Digest and post" gnus-uu-digest-post-forward t]
2539         ["Resend message" gnus-summary-resend-message t]
2540         ["Resend message edit" gnus-summary-resend-message-edit t]
2541         ["Send bounced mail" gnus-summary-resend-bounced-mail t]
2542         ["Send a mail" gnus-summary-mail-other-window t]
2543         ["Create a local message" gnus-summary-news-other-window t]
2544         ["Uuencode and post" gnus-uu-post-news
2545          ,@(if (featurep 'xemacs) '(t)
2546              '(:help "Post a uuencoded article"))]
2547         ["Followup via news" gnus-summary-followup-to-mail t]
2548         ["Followup via news and yank"
2549          gnus-summary-followup-to-mail-with-original t]
2550         ;;("Draft"
2551         ;;["Send" gnus-summary-send-draft t]
2552         ;;["Send bounced" gnus-resend-bounced-mail t])
2553         ))
2554
2555     (cond
2556      ((not (keymapp gnus-summary-post-menu))
2557       (setq gnus-article-post-menu gnus-summary-post-menu))
2558      ((not gnus-article-post-menu)
2559       ;; Don't share post menu.
2560       (setq gnus-article-post-menu
2561             (copy-keymap gnus-summary-post-menu))))
2562     (define-key gnus-article-mode-map [menu-bar post]
2563       (cons "Post" gnus-article-post-menu))
2564
2565     (easy-menu-define
2566       gnus-summary-misc-menu gnus-summary-mode-map ""
2567       `("Gnus"
2568         ("Mark Read"
2569          ["Mark as read" gnus-summary-mark-as-read-forward t]
2570          ["Mark same subject and select"
2571           gnus-summary-kill-same-subject-and-select t]
2572          ["Mark same subject" gnus-summary-kill-same-subject t]
2573          ["Catchup" gnus-summary-catchup
2574           ,@(if (featurep 'xemacs) '(t)
2575               '(:help "Mark unread articles in this group as read"))]
2576          ["Catchup all" gnus-summary-catchup-all t]
2577          ["Catchup to here" gnus-summary-catchup-to-here t]
2578          ["Catchup from here" gnus-summary-catchup-from-here t]
2579          ["Catchup region" gnus-summary-mark-region-as-read
2580           (gnus-mark-active-p)]
2581          ["Mark excluded" gnus-summary-limit-mark-excluded-as-read t])
2582         ("Mark Various"
2583          ["Tick" gnus-summary-tick-article-forward t]
2584          ["Mark as dormant" gnus-summary-mark-as-dormant t]
2585          ["Remove marks" gnus-summary-clear-mark-forward t]
2586          ["Set expirable mark" gnus-summary-mark-as-expirable t]
2587          ["Set bookmark" gnus-summary-set-bookmark t]
2588          ["Remove bookmark" gnus-summary-remove-bookmark t])
2589         ("Limit to"
2590          ["Marks..." gnus-summary-limit-to-marks t]
2591          ["Subject..." gnus-summary-limit-to-subject t]
2592          ["Author..." gnus-summary-limit-to-author t]
2593          ["Recipient..." gnus-summary-limit-to-recipient t]
2594          ["Address..." gnus-summary-limit-to-address t]
2595          ["Age..." gnus-summary-limit-to-age t]
2596          ["Extra..." gnus-summary-limit-to-extra t]
2597          ["Score..." gnus-summary-limit-to-score t]
2598          ["Display Predicate" gnus-summary-limit-to-display-predicate t]
2599          ["Unread" gnus-summary-limit-to-unread t]
2600          ["Unseen" gnus-summary-limit-to-unseen t]
2601          ["Singletons" gnus-summary-limit-to-singletons t]
2602          ["Replied" gnus-summary-limit-to-replied t]
2603          ["Non-dormant" gnus-summary-limit-exclude-dormant t]
2604          ["Next or process marked articles" gnus-summary-limit-to-articles t]
2605          ["Pop limit" gnus-summary-pop-limit t]
2606          ["Show dormant" gnus-summary-limit-include-dormant t]
2607          ["Hide childless dormant"
2608           gnus-summary-limit-exclude-childless-dormant t]
2609          ;;["Hide thread" gnus-summary-limit-exclude-thread t]
2610          ["Hide marked" gnus-summary-limit-exclude-marks t]
2611          ["Show expunged" gnus-summary-limit-include-expunged t])
2612         ("Process Mark"
2613          ["Set mark" gnus-summary-mark-as-processable t]
2614          ["Remove mark" gnus-summary-unmark-as-processable t]
2615          ["Remove all marks" gnus-summary-unmark-all-processable t]
2616          ["Invert marks" gnus-uu-invert-processable t]
2617          ["Mark above" gnus-uu-mark-over t]
2618          ["Mark series" gnus-uu-mark-series t]
2619          ["Mark region" gnus-uu-mark-region (gnus-mark-active-p)]
2620          ["Unmark region" gnus-uu-unmark-region (gnus-mark-active-p)]
2621          ["Mark by regexp..." gnus-uu-mark-by-regexp t]
2622          ["Unmark by regexp..." gnus-uu-unmark-by-regexp t]
2623          ["Mark all" gnus-uu-mark-all t]
2624          ["Mark buffer" gnus-uu-mark-buffer t]
2625          ["Mark sparse" gnus-uu-mark-sparse t]
2626          ["Mark thread" gnus-uu-mark-thread t]
2627          ["Unmark thread" gnus-uu-unmark-thread t]
2628          ("Process Mark Sets"
2629           ["Kill" gnus-summary-kill-process-mark t]
2630           ["Yank" gnus-summary-yank-process-mark
2631            gnus-newsgroup-process-stack]
2632           ["Save" gnus-summary-save-process-mark t]
2633           ["Run command on marked..." gnus-summary-universal-argument t]))
2634         ("Scroll article"
2635          ["Page forward" gnus-summary-next-page
2636           ,@(if (featurep 'xemacs) '(t)
2637               '(:help "Show next page of article"))]
2638          ["Page backward" gnus-summary-prev-page
2639           ,@(if (featurep 'xemacs) '(t)
2640               '(:help "Show previous page of article"))]
2641          ["Line forward" gnus-summary-scroll-up t])
2642         ("Move"
2643          ["Next unread article" gnus-summary-next-unread-article t]
2644          ["Previous unread article" gnus-summary-prev-unread-article t]
2645          ["Next article" gnus-summary-next-article t]
2646          ["Previous article" gnus-summary-prev-article t]
2647          ["Next unread subject" gnus-summary-next-unread-subject t]
2648          ["Previous unread subject" gnus-summary-prev-unread-subject t]
2649          ["Next article same subject" gnus-summary-next-same-subject t]
2650          ["Previous article same subject" gnus-summary-prev-same-subject t]
2651          ["First unread article" gnus-summary-first-unread-article t]
2652          ["Best unread article" gnus-summary-best-unread-article t]
2653          ["Go to subject number..." gnus-summary-goto-subject t]
2654          ["Go to article number..." gnus-summary-goto-article t]
2655          ["Go to the last article" gnus-summary-goto-last-article t]
2656          ["Pop article off history" gnus-summary-pop-article t])
2657         ("Sort"
2658          ["Sort by number" gnus-summary-sort-by-number t]
2659          ["Sort by author" gnus-summary-sort-by-author t]
2660          ["Sort by recipient" gnus-summary-sort-by-recipient t]
2661          ["Sort by subject" gnus-summary-sort-by-subject t]
2662          ["Sort by date" gnus-summary-sort-by-date t]
2663          ["Sort by score" gnus-summary-sort-by-score t]
2664          ["Sort by lines" gnus-summary-sort-by-lines t]
2665          ["Sort by characters" gnus-summary-sort-by-chars t]
2666          ["Randomize" gnus-summary-sort-by-random t]
2667          ["Original sort" gnus-summary-sort-by-original t])
2668         ("Help"
2669          ["Fetch group FAQ" gnus-summary-fetch-faq t]
2670          ["Describe group" gnus-summary-describe-group t]
2671          ["Fetch charter" gnus-group-fetch-charter
2672           ,@(if (featurep 'xemacs) nil
2673               '(:help "Display the charter of the current group"))]
2674          ["Fetch control message" gnus-group-fetch-control
2675           ,@(if (featurep 'xemacs) nil
2676               '(:help "Display the archived control message for the current group"))]
2677          ["Read manual" gnus-info-find-node t])
2678         ("Modes"
2679          ["Pick and read" gnus-pick-mode t]
2680          ["Binary" gnus-binary-mode t])
2681         ("Regeneration"
2682          ["Regenerate" gnus-summary-prepare t]
2683          ["Insert cached articles" gnus-summary-insert-cached-articles t]
2684          ["Insert dormant articles" gnus-summary-insert-dormant-articles t]
2685          ["Insert ticked articles" gnus-summary-insert-ticked-articles t]
2686          ["Toggle threading" gnus-summary-toggle-threads t])
2687         ["See old articles" gnus-summary-insert-old-articles t]
2688         ["See new articles" gnus-summary-insert-new-articles t]
2689         ["Filter articles..." gnus-summary-execute-command t]
2690         ["Run command on articles..." gnus-summary-universal-argument t]
2691         ["Search articles forward..." gnus-summary-search-article-forward t]
2692         ["Search articles backward..." gnus-summary-search-article-backward t]
2693         ["Toggle line truncation" gnus-summary-toggle-truncation t]
2694         ["Expand window" gnus-summary-expand-window t]
2695         ["Expire expirable articles" gnus-summary-expire-articles
2696          (gnus-check-backend-function
2697           'request-expire-articles gnus-newsgroup-name)]
2698         ["Edit local kill file" gnus-summary-edit-local-kill t]
2699         ["Edit main kill file" gnus-summary-edit-global-kill t]
2700         ["Edit group parameters" gnus-summary-edit-parameters t]
2701         ["Customize group parameters" gnus-summary-customize-parameters t]
2702         ["Send a bug report" gnus-bug t]
2703         ("Exit"
2704          ["Catchup and exit" gnus-summary-catchup-and-exit
2705           ,@(if (featurep 'xemacs) '(t)
2706               '(:help "Mark unread articles in this group as read, then exit"))]
2707          ["Catchup all and exit" gnus-summary-catchup-all-and-exit t]
2708          ["Catchup and goto next" gnus-summary-catchup-and-goto-next-group t]
2709          ["Catchup and goto prev" gnus-summary-catchup-and-goto-prev-group t]
2710          ["Exit group" gnus-summary-exit
2711           ,@(if (featurep 'xemacs) '(t)
2712               '(:help "Exit current group, return to group selection mode"))]
2713          ["Exit group without updating" gnus-summary-exit-no-update t]
2714          ["Exit and goto next group" gnus-summary-next-group t]
2715          ["Exit and goto prev group" gnus-summary-prev-group t]
2716          ["Reselect group" gnus-summary-reselect-current-group t]
2717          ["Rescan group" gnus-summary-rescan-group t]
2718          ["Update dribble" gnus-summary-save-newsrc t])))
2719
2720     (gnus-run-hooks 'gnus-summary-menu-hook)))
2721
2722 (defvar gnus-summary-tool-bar-map nil)
2723
2724 ;; Note: The :set function in the `gnus-summary-tool-bar*' variables will only
2725 ;; affect _new_ message buffers.  We might add a function that walks thru all
2726 ;; summary-mode buffers and force the update.
2727 (defun gnus-summary-tool-bar-update (&optional symbol value)
2728   "Update summary mode toolbar.
2729 Setter function for custom variables."
2730   (setq-default gnus-summary-tool-bar-map nil)
2731   (when symbol
2732     ;; When used as ":set" function:
2733     (set-default symbol value))
2734   (when (gnus-buffer-live-p gnus-summary-buffer)
2735     (with-current-buffer gnus-summary-buffer
2736       (gnus-summary-make-tool-bar))))
2737
2738 (defcustom gnus-summary-tool-bar (if (eq gmm-tool-bar-style 'gnome)
2739                                      'gnus-summary-tool-bar-gnome
2740                                    'gnus-summary-tool-bar-retro)
2741   "Specifies the Gnus summary tool bar.
2742
2743 It can be either a list or a symbol refering to a list.  See
2744 `gmm-tool-bar-from-list' for the format of the list.  The
2745 default key map is `gnus-summary-mode-map'.
2746
2747 Pre-defined symbols include `gnus-summary-tool-bar-gnome' and
2748 `gnus-summary-tool-bar-retro'."
2749   :type '(choice (const :tag "GNOME style" gnus-summary-tool-bar-gnome)
2750                  (const :tag "Retro look"  gnus-summary-tool-bar-retro)
2751                  (repeat :tag "User defined list" gmm-tool-bar-item)
2752                  (symbol))
2753   :version "23.0" ;; No Gnus
2754   :initialize 'custom-initialize-default
2755   :set 'gnus-summary-tool-bar-update
2756   :group 'gnus-summary)
2757
2758 (defcustom gnus-summary-tool-bar-gnome
2759   '((gnus-summary-post-news "mail/compose" nil)
2760     (gnus-summary-insert-new-articles "mail/inbox" nil
2761                                       :visible (or (not gnus-agent)
2762                                                    gnus-plugged))
2763     (gnus-summary-reply-with-original "mail/reply")
2764     (gnus-summary-reply "mail/reply" nil :visible nil)
2765     (gnus-summary-followup-with-original "mail/reply-all")
2766     (gnus-summary-followup "mail/reply-all" nil :visible nil)
2767     (gnus-summary-mail-forward "mail/forward")
2768     (gnus-summary-save-article "mail/save")
2769     (gnus-summary-search-article-forward "search" nil :visible nil)
2770     (gnus-summary-print-article "print")
2771     (gnus-summary-tick-article-forward "flag-followup" nil :visible nil)
2772     ;; Some new commands that may need more suitable icons:
2773     (gnus-summary-save-newsrc "save" nil :visible nil)
2774     ;; (gnus-summary-show-article "stock_message-display" nil :visible nil)
2775     (gnus-summary-prev-article "left-arrow")
2776     (gnus-summary-next-article "right-arrow")
2777     (gnus-summary-next-page "next-page")
2778     ;; (gnus-summary-enter-digest-group "right_arrow" nil :visible nil)
2779     ;;
2780     ;; Maybe some sort-by-... could be added:
2781     ;; (gnus-summary-sort-by-author "sort-a-z" nil :visible nil)
2782     ;; (gnus-summary-sort-by-date "sort-1-9" nil :visible nil)
2783     (gnus-summary-mark-as-expirable
2784      "delete" nil
2785      :visible (gnus-check-backend-function 'request-expire-articles
2786                                            gnus-newsgroup-name))
2787     (gnus-summary-mark-as-spam
2788      "mail/spam" t
2789      :visible (and (fboundp 'spam-group-ham-contents-p)
2790                    (spam-group-ham-contents-p gnus-newsgroup-name))
2791      :help "Mark as spam")
2792     (gnus-summary-mark-as-read-forward
2793      "mail/not-spam" nil
2794      :visible (and (fboundp 'spam-group-spam-contents-p)
2795                    (spam-group-spam-contents-p gnus-newsgroup-name)))
2796     ;;
2797     (gnus-summary-exit "exit")
2798     (gmm-customize-mode "preferences" t :help "Edit mode preferences")
2799     (gnus-info-find-node "help"))
2800   "List of functions for the summary tool bar (GNOME style).
2801
2802 See `gmm-tool-bar-from-list' for the format of the list."
2803   :type '(repeat gmm-tool-bar-item)
2804   :version "23.0" ;; No Gnus
2805   :initialize 'custom-initialize-default
2806   :set 'gnus-summary-tool-bar-update
2807   :group 'gnus-summary)
2808
2809 (defcustom gnus-summary-tool-bar-retro
2810   '((gnus-summary-prev-unread-article "gnus/prev-ur")
2811     (gnus-summary-next-unread-article "gnus/next-ur")
2812     (gnus-summary-post-news "gnus/post")
2813     (gnus-summary-followup-with-original "gnus/fuwo")
2814     (gnus-summary-followup "gnus/followup")
2815     (gnus-summary-reply-with-original "gnus/reply-wo")
2816     (gnus-summary-reply "gnus/reply")
2817     (gnus-summary-caesar-message "gnus/rot13")
2818     (gnus-uu-decode-uu "gnus/uu-decode")
2819     (gnus-summary-save-article-file "gnus/save-aif")
2820     (gnus-summary-save-article "gnus/save-art")
2821     (gnus-uu-post-news "gnus/uu-post")
2822     (gnus-summary-catchup "gnus/catchup")
2823     (gnus-summary-catchup-and-exit "gnus/cu-exit")
2824     (gnus-summary-exit "gnus/exit-summ")
2825     ;; Some new command that may need more suitable icons:
2826     (gnus-summary-print-article "gnus/print" nil :visible nil)
2827     (gnus-summary-mark-as-expirable "gnus/close" nil :visible nil)
2828     (gnus-summary-save-newsrc "gnus/save" nil :visible nil)
2829     ;; (gnus-summary-enter-digest-group "gnus/right_arrow" nil :visible nil)
2830     (gnus-summary-search-article-forward "gnus/search" nil :visible nil)
2831     ;; (gnus-summary-insert-new-articles "gnus/paste" nil :visible nil)
2832     ;; (gnus-summary-toggle-threads "gnus/open" nil :visible nil)
2833     ;;
2834     (gnus-info-find-node "gnus/help" nil :visible nil))
2835   "List of functions for the summary tool bar (retro look).
2836
2837 See `gmm-tool-bar-from-list' for the format of the list."
2838   :type '(repeat gmm-tool-bar-item)
2839   :version "23.0" ;; No Gnus
2840   :initialize 'custom-initialize-default
2841   :set 'gnus-summary-tool-bar-update
2842   :group 'gnus-summary)
2843
2844 (defcustom gnus-summary-tool-bar-zap-list t
2845   "List of icon items from the global tool bar.
2846 These items are not displayed in the Gnus summary mode tool bar.
2847
2848 See `gmm-tool-bar-from-list' for the format of the list."
2849   :type 'gmm-tool-bar-zap-list
2850   :version "23.0" ;; No Gnus
2851   :initialize 'custom-initialize-default
2852   :set 'gnus-summary-tool-bar-update
2853   :group 'gnus-summary)
2854
2855 (defvar image-load-path)
2856
2857 (defun gnus-summary-make-tool-bar (&optional force)
2858   "Make a summary mode tool bar from `gnus-summary-tool-bar'.
2859 When FORCE, rebuild the tool bar."
2860   (when (and (not (featurep 'xemacs))
2861              (boundp 'tool-bar-mode)
2862              tool-bar-mode
2863              (or (not gnus-summary-tool-bar-map) force))
2864     (let* ((load-path
2865             (gmm-image-load-path-for-library "gnus"
2866                                              "mail/save.xpm"
2867                                              nil t))
2868            (image-load-path (cons (car load-path)
2869                                   (when (boundp 'image-load-path)
2870                                     image-load-path)))
2871            (map (gmm-tool-bar-from-list gnus-summary-tool-bar
2872                                         gnus-summary-tool-bar-zap-list
2873                                         'gnus-summary-mode-map)))
2874       (when map
2875         ;; Need to set `gnus-summary-tool-bar-map' because `gnus-article-mode'
2876         ;; uses it's value.
2877         (setq gnus-summary-tool-bar-map map))))
2878   (set (make-local-variable 'tool-bar-map) gnus-summary-tool-bar-map))
2879
2880 (defun gnus-score-set-default (var value)
2881   "A version of set that updates the GNU Emacs menu-bar."
2882   (set var value)
2883   ;; It is the message that forces the active status to be updated.
2884   (message ""))
2885
2886 (defun gnus-make-score-map (type)
2887   "Make a summary score map of type TYPE."
2888   (if t
2889       nil
2890     (let ((headers '(("author" "from" string)
2891                      ("subject" "subject" string)
2892                      ("article body" "body" string)
2893                      ("article head" "head" string)
2894                      ("xref" "xref" string)
2895                      ("extra header" "extra" string)
2896                      ("lines" "lines" number)
2897                      ("followups to author" "followup" string)))
2898           (types '((number ("less than" <)
2899                            ("greater than" >)
2900                            ("equal" =))
2901                    (string ("substring" s)
2902                            ("exact string" e)
2903                            ("fuzzy string" f)
2904                            ("regexp" r))))
2905           (perms '(("temporary" (current-time-string))
2906                    ("permanent" nil)
2907                    ("immediate" now)))
2908           header)
2909       (list
2910        (apply
2911         'nconc
2912         (list
2913          (if (eq type 'lower)
2914              "Lower score"
2915            "Increase score"))
2916         (let (outh)
2917           (while headers
2918             (setq header (car headers))
2919             (setq outh
2920                   (cons
2921                    (apply
2922                     'nconc
2923                     (list (car header))
2924                     (let ((ts (cdr (assoc (nth 2 header) types)))
2925                           outt)
2926                       (while ts
2927                         (setq outt
2928                               (cons
2929                                (apply
2930                                 'nconc
2931                                 (list (caar ts))
2932                                 (let ((ps perms)
2933                                       outp)
2934                                   (while ps
2935                                     (setq outp
2936                                           (cons
2937                                            (vector
2938                                             (caar ps)
2939                                             (list
2940                                              'gnus-summary-score-entry
2941                                              (nth 1 header)
2942                                              (if (or (string= (nth 1 header)
2943                                                               "head")
2944                                                      (string= (nth 1 header)
2945                                                               "body"))
2946                                                  ""
2947                                                (list 'gnus-summary-header
2948                                                      (nth 1 header)))
2949                                              (list 'quote (nth 1 (car ts)))
2950                                              (list 'gnus-score-delta-default
2951                                                    nil)
2952                                              (nth 1 (car ps))
2953                                              t)
2954                                             t)
2955                                            outp))
2956                                     (setq ps (cdr ps)))
2957                                   (list (nreverse outp))))
2958                                outt))
2959                         (setq ts (cdr ts)))
2960                       (list (nreverse outt))))
2961                    outh))
2962             (setq headers (cdr headers)))
2963           (list (nreverse outh))))))))
2964
2965
2966 (declare-function turn-on-gnus-mailing-list-mode "gnus-ml" ())
2967
2968 \f
2969
2970 (defun gnus-summary-mode (&optional group)
2971   "Major mode for reading articles.
2972
2973 All normal editing commands are switched off.
2974 \\<gnus-summary-mode-map>
2975 Each line in this buffer represents one article.  To read an
2976 article, you can, for instance, type `\\[gnus-summary-next-page]'.  To move forwards
2977 and backwards while displaying articles, type `\\[gnus-summary-next-unread-article]' and `\\[gnus-summary-prev-unread-article]',
2978 respectively.
2979
2980 You can also post articles and send mail from this buffer.  To
2981 follow up an article, type `\\[gnus-summary-followup]'.  To mail a reply to the author
2982 of an article, type `\\[gnus-summary-reply]'.
2983
2984 There are approx. one gazillion commands you can execute in this
2985 buffer; read the info pages for more information (`\\[gnus-info-find-node]').
2986
2987 The following commands are available:
2988
2989 \\{gnus-summary-mode-map}"
2990   (interactive)
2991   (kill-all-local-variables)
2992   (let ((gnus-summary-local-variables gnus-newsgroup-variables))
2993     (gnus-summary-make-local-variables))
2994   (gnus-summary-make-local-variables)
2995   (setq gnus-newsgroup-name group)
2996   (when (gnus-visual-p 'summary-menu 'menu)
2997     (gnus-summary-make-menu-bar)
2998     (gnus-summary-make-tool-bar))
2999   (gnus-make-thread-indent-array)
3000   (gnus-simplify-mode-line)
3001   (setq major-mode 'gnus-summary-mode)
3002   (setq mode-name "Summary")
3003   (make-local-variable 'minor-mode-alist)
3004   (use-local-map gnus-summary-mode-map)
3005   (buffer-disable-undo)
3006   (setq buffer-read-only t              ;Disable modification
3007         show-trailing-whitespace nil)
3008   (setq truncate-lines t)
3009   (setq selective-display t)
3010   (setq selective-display-ellipses t)   ;Display `...'
3011   (gnus-summary-set-display-table)
3012   (gnus-set-default-directory)
3013   (make-local-variable 'gnus-summary-line-format)
3014   (make-local-variable 'gnus-summary-line-format-spec)
3015   (make-local-variable 'gnus-summary-dummy-line-format)
3016   (make-local-variable 'gnus-summary-dummy-line-format-spec)
3017   (make-local-variable 'gnus-summary-mark-positions)
3018   (gnus-make-local-hook 'pre-command-hook)
3019   (add-hook 'pre-command-hook 'gnus-set-global-variables nil t)
3020   (gnus-run-mode-hooks 'gnus-summary-mode-hook)
3021   (turn-on-gnus-mailing-list-mode)
3022   (mm-enable-multibyte)
3023   (gnus-update-format-specifications nil 'summary 'summary-mode 'summary-dummy)
3024   (gnus-update-summary-mark-positions))
3025
3026 (defun gnus-summary-make-local-variables ()
3027   "Make all the local summary buffer variables."
3028   (let (global)
3029     (dolist (local gnus-summary-local-variables)
3030       (if (consp local)
3031           (progn
3032             (if (eq (cdr local) 'global)
3033                 ;; Copy the global value of the variable.
3034                 (setq global (symbol-value (car local)))
3035               ;; Use the value from the list.
3036               (setq global (eval (cdr local))))
3037             (set (make-local-variable (car local)) global))
3038         ;; Simple nil-valued local variable.
3039         (set (make-local-variable local) nil)))))
3040
3041 (defun gnus-summary-clear-local-variables ()
3042   (let ((locals gnus-summary-local-variables))
3043     (while locals
3044       (if (consp (car locals))
3045           (and (symbolp (caar locals))
3046                (set (caar locals) nil))
3047         (and (symbolp (car locals))
3048              (set (car locals) nil)))
3049       (setq locals (cdr locals)))))
3050
3051 ;; Summary data functions.
3052
3053 (defmacro gnus-data-number (data)
3054   `(car ,data))
3055
3056 (defmacro gnus-data-set-number (data number)
3057   `(setcar ,data ,number))
3058
3059 (defmacro gnus-data-mark (data)
3060   `(nth 1 ,data))
3061
3062 (defmacro gnus-data-set-mark (data mark)
3063   `(setcar (nthcdr 1 ,data) ,mark))
3064
3065 (defmacro gnus-data-pos (data)
3066   `(nth 2 ,data))
3067
3068 (defmacro gnus-data-set-pos (data pos)
3069   `(setcar (nthcdr 2 ,data) ,pos))
3070
3071 (defmacro gnus-data-header (data)
3072   `(nth 3 ,data))
3073
3074 (defmacro gnus-data-set-header (data header)
3075   `(setf (nth 3 ,data) ,header))
3076
3077 (defmacro gnus-data-level (data)
3078   `(nth 4 ,data))
3079
3080 (defmacro gnus-data-unread-p (data)
3081   `(= (nth 1 ,data) gnus-unread-mark))
3082
3083 (defmacro gnus-data-read-p (data)
3084   `(/= (nth 1 ,data) gnus-unread-mark))
3085
3086 (defmacro gnus-data-pseudo-p (data)
3087   `(consp (nth 3 ,data)))
3088
3089 (defmacro gnus-data-find (number)
3090   `(assq ,number gnus-newsgroup-data))
3091
3092 (defmacro gnus-data-find-list (number &optional data)
3093   `(let ((bdata ,(or data 'gnus-newsgroup-data)))
3094      (memq (assq ,number bdata)
3095            bdata)))
3096
3097 (defmacro gnus-data-make (number mark pos header level)
3098   `(list ,number ,mark ,pos ,header ,level))
3099
3100 (defun gnus-data-enter (after-article number mark pos header level offset)
3101   (let ((data (gnus-data-find-list after-article)))
3102     (unless data
3103       (error "No such article: %d" after-article))
3104     (setcdr data (cons (gnus-data-make number mark pos header level)
3105                        (cdr data)))
3106     (setq gnus-newsgroup-data-reverse nil)
3107     (gnus-data-update-list (cddr data) offset)))
3108
3109 (defun gnus-data-enter-list (after-article list &optional offset)
3110   (when list
3111     (let ((data (and after-article (gnus-data-find-list after-article)))
3112           (ilist list))
3113       (if (not (or data
3114                    after-article))
3115           (let ((odata gnus-newsgroup-data))
3116             (setq gnus-newsgroup-data (nconc list gnus-newsgroup-data))
3117             (when offset
3118               (gnus-data-update-list odata offset)))
3119         ;; Find the last element in the list to be spliced into the main
3120         ;; list.
3121         (setq list (last list))
3122         (if (not data)
3123             (progn
3124               (setcdr list gnus-newsgroup-data)
3125               (setq gnus-newsgroup-data ilist)
3126               (when offset
3127                 (gnus-data-update-list (cdr list) offset)))
3128           (setcdr list (cdr data))
3129           (setcdr data ilist)
3130           (when offset
3131             (gnus-data-update-list (cdr list) offset))))
3132       (setq gnus-newsgroup-data-reverse nil))))
3133
3134 (defun gnus-data-remove (article &optional offset)
3135   (let ((data gnus-newsgroup-data))
3136     (if (= (gnus-data-number (car data)) article)
3137         (progn
3138           (setq gnus-newsgroup-data (cdr gnus-newsgroup-data)
3139                 gnus-newsgroup-data-reverse nil)
3140           (when offset
3141             (gnus-data-update-list gnus-newsgroup-data offset)))
3142       (while (cdr data)
3143         (when (= (gnus-data-number (cadr data)) article)
3144           (setcdr data (cddr data))
3145           (when offset
3146             (gnus-data-update-list (cdr data) offset))
3147           (setq data nil
3148                 gnus-newsgroup-data-reverse nil))
3149         (setq data (cdr data))))))
3150
3151 (defmacro gnus-data-list (backward)
3152   `(if ,backward
3153        (or gnus-newsgroup-data-reverse
3154            (setq gnus-newsgroup-data-reverse
3155                  (reverse gnus-newsgroup-data)))
3156      gnus-newsgroup-data))
3157
3158 (defun gnus-data-update-list (data offset)
3159   "Add OFFSET to the POS of all data entries in DATA."
3160   (setq gnus-newsgroup-data-reverse nil)
3161   (while data
3162     (setcar (nthcdr 2 (car data)) (+ offset (nth 2 (car data))))
3163     (setq data (cdr data))))
3164
3165 (defun gnus-summary-article-pseudo-p (article)
3166   "Say whether this article is a pseudo article or not."
3167   (not (vectorp (gnus-data-header (gnus-data-find article)))))
3168
3169 (defmacro gnus-summary-article-sparse-p (article)
3170   "Say whether this article is a sparse article or not."
3171   `(memq ,article gnus-newsgroup-sparse))
3172
3173 (defmacro gnus-summary-article-ancient-p (article)
3174   "Say whether this article is a sparse article or not."
3175   `(memq ,article gnus-newsgroup-ancient))
3176
3177 (defun gnus-article-parent-p (number)
3178   "Say whether this article is a parent or not."
3179   (let ((data (gnus-data-find-list number)))
3180     (and (cdr data)              ; There has to be an article after...
3181          (< (gnus-data-level (car data)) ; And it has to have a higher level.
3182             (gnus-data-level (nth 1 data))))))
3183
3184 (defun gnus-article-children (number)
3185   "Return a list of all children to NUMBER."
3186   (let* ((data (gnus-data-find-list number))
3187          (level (gnus-data-level (car data)))
3188          children)
3189     (setq data (cdr data))
3190     (while (and data
3191                 (= (gnus-data-level (car data)) (1+ level)))
3192       (push (gnus-data-number (car data)) children)
3193       (setq data (cdr data)))
3194     children))
3195
3196 (defmacro gnus-summary-skip-intangible ()
3197   "If the current article is intangible, then jump to a different article."
3198   '(let ((to (get-text-property (point) 'gnus-intangible)))
3199      (and to (gnus-summary-goto-subject to))))
3200
3201 (defmacro gnus-summary-article-intangible-p ()
3202   "Say whether this article is intangible or not."
3203   '(get-text-property (point) 'gnus-intangible))
3204
3205 (defun gnus-article-read-p (article)
3206   "Say whether ARTICLE is read or not."
3207   (not (or (memq article gnus-newsgroup-marked)
3208            (memq article gnus-newsgroup-spam-marked)
3209            (memq article gnus-newsgroup-unreads)
3210            (memq article gnus-newsgroup-unselected)
3211            (memq article gnus-newsgroup-dormant))))
3212
3213 ;; Some summary mode macros.
3214
3215 (defmacro gnus-summary-article-number ()
3216   "The article number of the article on the current line.
3217 If there isn't an article number here, then we return the current
3218 article number."
3219   '(progn
3220      (gnus-summary-skip-intangible)
3221      (or (get-text-property (point) 'gnus-number)
3222          (gnus-summary-last-subject))))
3223
3224 (defmacro gnus-summary-article-header (&optional number)
3225   "Return the header of article NUMBER."
3226   `(gnus-data-header (gnus-data-find
3227                       ,(or number '(gnus-summary-article-number)))))
3228
3229 (defmacro gnus-summary-thread-level (&optional number)
3230   "Return the level of thread that starts with article NUMBER."
3231   `(if (and (eq gnus-summary-make-false-root 'dummy)
3232             (get-text-property (point) 'gnus-intangible))
3233        0
3234      (gnus-data-level (gnus-data-find
3235                        ,(or number '(gnus-summary-article-number))))))
3236
3237 (defmacro gnus-summary-article-mark (&optional number)
3238   "Return the mark of article NUMBER."
3239   `(gnus-data-mark (gnus-data-find
3240                     ,(or number '(gnus-summary-article-number)))))
3241
3242 (defmacro gnus-summary-article-pos (&optional number)
3243   "Return the position of the line of article NUMBER."
3244   `(gnus-data-pos (gnus-data-find
3245                    ,(or number '(gnus-summary-article-number)))))
3246
3247 (defalias 'gnus-summary-subject-string 'gnus-summary-article-subject)
3248 (defmacro gnus-summary-article-subject (&optional number)
3249   "Return current subject string or nil if nothing."
3250   `(let ((headers
3251           ,(if number
3252                `(gnus-data-header (assq ,number gnus-newsgroup-data))
3253              '(gnus-data-header (assq (gnus-summary-article-number)
3254                                       gnus-newsgroup-data)))))
3255      (and headers
3256           (vectorp headers)
3257           (mail-header-subject headers))))
3258
3259 (defmacro gnus-summary-article-score (&optional number)
3260   "Return current article score."
3261   `(or (cdr (assq ,(or number '(gnus-summary-article-number))
3262                   gnus-newsgroup-scored))
3263        gnus-summary-default-score 0))
3264
3265 (defun gnus-summary-article-children (&optional number)
3266   "Return a list of article numbers that are children of article NUMBER."
3267   (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))))
3268          (level (gnus-data-level (car data)))
3269          l children)
3270     (while (and (setq data (cdr data))
3271                 (> (setq l (gnus-data-level (car data))) level))
3272       (and (= (1+ level) l)
3273            (push (gnus-data-number (car data))
3274                  children)))
3275     (nreverse children)))
3276
3277 (defun gnus-summary-article-parent (&optional number)
3278   "Return the article number of the parent of article NUMBER."
3279   (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))
3280                                     (gnus-data-list t)))
3281          (level (gnus-data-level (car data))))
3282     (if (zerop level)
3283         ()                              ; This is a root.
3284       ;; We search until we find an article with a level less than
3285       ;; this one.  That function has to be the parent.
3286       (while (and (setq data (cdr data))
3287                   (not (< (gnus-data-level (car data)) level))))
3288       (and data (gnus-data-number (car data))))))
3289
3290 (defun gnus-unread-mark-p (mark)
3291   "Say whether MARK is the unread mark."
3292   (= mark gnus-unread-mark))
3293
3294 (defun gnus-read-mark-p (mark)
3295   "Say whether MARK is one of the marks that mark as read.
3296 This is all marks except unread, ticked, dormant, and expirable."
3297   (not (or (= mark gnus-unread-mark)
3298            (= mark gnus-ticked-mark)
3299            (= mark gnus-spam-mark)
3300            (= mark gnus-dormant-mark)
3301            (= mark gnus-expirable-mark))))
3302
3303 (defmacro gnus-article-mark (number)
3304   "Return the MARK of article NUMBER.
3305 This macro should only be used when computing the mark the \"first\"
3306 time; i.e., when generating the summary lines.  After that,
3307 `gnus-summary-article-mark' should be used to examine the
3308 marks of articles."
3309   `(cond
3310     ((memq ,number gnus-newsgroup-unsendable) gnus-unsendable-mark)
3311     ((memq ,number gnus-newsgroup-downloadable) gnus-downloadable-mark)
3312     ((memq ,number gnus-newsgroup-unreads) gnus-unread-mark)
3313     ((memq ,number gnus-newsgroup-marked) gnus-ticked-mark)
3314     ((memq ,number gnus-newsgroup-spam-marked) gnus-spam-mark)
3315     ((memq ,number gnus-newsgroup-dormant) gnus-dormant-mark)
3316     ((memq ,number gnus-newsgroup-expirable) gnus-expirable-mark)
3317     (t (or (cdr (assq ,number gnus-newsgroup-reads))
3318            gnus-ancient-mark))))
3319
3320 ;; Saving hidden threads.
3321
3322 (defmacro gnus-save-hidden-threads (&rest forms)
3323   "Save hidden threads, eval FORMS, and restore the hidden threads."
3324   (let ((config (make-symbol "config")))
3325     `(let ((,config (gnus-hidden-threads-configuration)))
3326        (unwind-protect
3327            (save-excursion
3328              ,@forms)
3329          (gnus-restore-hidden-threads-configuration ,config)))))
3330 (put 'gnus-save-hidden-threads 'lisp-indent-function 0)
3331 (put 'gnus-save-hidden-threads 'edebug-form-spec '(body))
3332
3333 (defun gnus-data-compute-positions ()
3334   "Compute the positions of all articles."
3335   (setq gnus-newsgroup-data-reverse nil)
3336   (let ((data gnus-newsgroup-data))
3337     (save-excursion
3338       (gnus-save-hidden-threads
3339         (gnus-summary-show-all-threads)
3340         (goto-char (point-min))
3341         (while data
3342           (while (get-text-property (point) 'gnus-intangible)
3343             (forward-line 1))
3344           (gnus-data-set-pos (car data) (+ (point) 3))
3345           (setq data (cdr data))
3346           (forward-line 1))))))
3347
3348 (defun gnus-hidden-threads-configuration ()
3349   "Return the current hidden threads configuration."
3350   (save-excursion
3351     (let (config)
3352       (goto-char (point-min))
3353       (while (search-forward "\r" nil t)
3354         (push (1- (point)) config))
3355       config)))
3356
3357 (defun gnus-restore-hidden-threads-configuration (config)
3358   "Restore hidden threads configuration from CONFIG."
3359   (save-excursion
3360     (let (point buffer-read-only)
3361       (while (setq point (pop config))
3362         (when (and (< point (point-max))
3363                    (goto-char point)
3364                    (eq (char-after) ?\n))
3365           (subst-char-in-region point (1+ point) ?\n ?\r))))))
3366
3367 ;; Various summary mode internalish functions.
3368
3369 (defun gnus-mouse-pick-article (e)
3370   (interactive "e")
3371   (mouse-set-point e)
3372   (gnus-summary-next-page nil t))
3373
3374 (defun gnus-summary-set-display-table ()
3375   "Change the display table.
3376 Odd characters have a tendency to mess
3377 up nicely formatted displays - we make all possible glyphs
3378 display only a single character."
3379
3380   ;; We start from the standard display table, if any.
3381   (let ((table (or (copy-sequence standard-display-table)
3382                    (make-display-table)))
3383         (i 32))
3384     ;; Nix out all the control chars...
3385     (while (>= (setq i (1- i)) 0)
3386       (aset table i [??]))
3387    ;; ... but not newline and cr, of course.  (cr is necessary for the
3388     ;; selective display).
3389     (aset table ?\n nil)
3390     (aset table ?\r nil)
3391     ;; We keep TAB as well.
3392     (aset table ?\t nil)
3393     ;; We nix out any glyphs 127 through 255, or 127 through 159 in
3394     ;; Emacs 23 (unicode), that are not set already.
3395     (let ((i (if (ignore-errors (= (make-char 'latin-iso8859-1 160) 160))
3396                  160
3397                256)))
3398       (while (>= (setq i (1- i)) 127)
3399         ;; Only modify if the entry is nil.
3400         (unless (aref table i)
3401           (aset table i [??]))))
3402     (setq buffer-display-table table)))
3403
3404 (defun gnus-summary-set-article-display-arrow (pos)
3405   "Update the overlay arrow to point to line at position POS."
3406   (when (and gnus-summary-display-arrow
3407              (boundp 'overlay-arrow-position)
3408              (boundp 'overlay-arrow-string))
3409     (save-excursion
3410       (goto-char pos)
3411       (beginning-of-line)
3412       (unless overlay-arrow-position
3413         (setq overlay-arrow-position (make-marker)))
3414       (setq overlay-arrow-string "=>"
3415             overlay-arrow-position (set-marker overlay-arrow-position
3416                                                (point)
3417                                                (current-buffer))))))
3418
3419 (defun gnus-summary-setup-buffer (group)
3420   "Initialize summary buffer."
3421   (let ((buffer (gnus-summary-buffer-name group))
3422         (dead-name (concat "*Dead Summary "
3423                            (gnus-group-decoded-name group) "*")))
3424     ;; If a dead summary buffer exists, we kill it.
3425     (when (gnus-buffer-live-p dead-name)
3426       (gnus-kill-buffer dead-name))
3427     (if (get-buffer buffer)
3428         (progn
3429           (set-buffer buffer)
3430           (setq gnus-summary-buffer (current-buffer))
3431           (not gnus-newsgroup-prepared))
3432       ;; Fix by Sudish Joseph <joseph@cis.ohio-state.edu>
3433       (setq gnus-summary-buffer (set-buffer (gnus-get-buffer-create buffer)))
3434       (gnus-summary-mode group)
3435       (when gnus-carpal
3436         (gnus-carpal-setup-buffer 'summary))
3437       (when (gnus-group-quit-config group)
3438         (set (make-local-variable 'gnus-single-article-buffer) nil))
3439       (make-local-variable 'gnus-article-buffer)
3440       (make-local-variable 'gnus-article-current)
3441       (make-local-variable 'gnus-original-article-buffer)
3442       (setq gnus-newsgroup-name group)
3443       ;; Set any local variables in the group parameters.
3444       (gnus-summary-set-local-parameters gnus-newsgroup-name)
3445       t)))
3446
3447 (defun gnus-set-global-variables ()
3448   "Set the global equivalents of the buffer-local variables.
3449 They are set to the latest values they had.  These reflect the summary
3450 buffer that was in action when the last article was fetched."
3451   (when (eq major-mode 'gnus-summary-mode)
3452     (setq gnus-summary-buffer (current-buffer))
3453     (let ((name gnus-newsgroup-name)
3454           (marked gnus-newsgroup-marked)
3455           (spam gnus-newsgroup-spam-marked)
3456           (unread gnus-newsgroup-unreads)
3457           (headers gnus-current-headers)
3458           (data gnus-newsgroup-data)
3459           (summary gnus-summary-buffer)
3460           (article-buffer gnus-article-buffer)
3461           (original gnus-original-article-buffer)
3462           (gac gnus-article-current)
3463           (reffed gnus-reffed-article-number)
3464           (score-file gnus-current-score-file)
3465           (default-charset gnus-newsgroup-charset)
3466           vlist)
3467       (let ((locals gnus-newsgroup-variables))
3468         (while locals
3469           (if (consp (car locals))
3470               (push (eval (caar locals)) vlist)
3471             (push (eval (car locals)) vlist))
3472           (setq locals (cdr locals)))
3473         (setq vlist (nreverse vlist)))
3474       (with-current-buffer gnus-group-buffer
3475         (setq gnus-newsgroup-name name
3476               gnus-newsgroup-marked marked
3477               gnus-newsgroup-spam-marked spam
3478               gnus-newsgroup-unreads unread
3479               gnus-current-headers headers
3480               gnus-newsgroup-data data
3481               gnus-article-current gac
3482               gnus-summary-buffer summary
3483               gnus-article-buffer article-buffer
3484               gnus-original-article-buffer original
3485               gnus-reffed-article-number reffed
3486               gnus-current-score-file score-file
3487               gnus-newsgroup-charset default-charset)
3488         (let ((locals gnus-newsgroup-variables))
3489           (while locals
3490             (if (consp (car locals))
3491                 (set (caar locals) (pop vlist))
3492               (set (car locals) (pop vlist)))
3493             (setq locals (cdr locals))))
3494         ;; The article buffer also has local variables.
3495         (when (gnus-buffer-live-p gnus-article-buffer)
3496           (set-buffer gnus-article-buffer)
3497           (setq gnus-summary-buffer summary))))))
3498
3499 (defun gnus-summary-article-unread-p (article)
3500   "Say whether ARTICLE is unread or not."
3501   (memq article gnus-newsgroup-unreads))
3502
3503 (defun gnus-summary-first-article-p (&optional article)
3504   "Return whether ARTICLE is the first article in the buffer."
3505   (if (not (setq article (or article (gnus-summary-article-number))))
3506       nil
3507     (eq article (caar gnus-newsgroup-data))))
3508
3509 (defun gnus-summary-last-article-p (&optional article)
3510   "Return whether ARTICLE is the last article in the buffer."
3511   (if (not (setq article (or article (gnus-summary-article-number))))
3512       ;; All non-existent numbers are the last article.  :-)
3513       t
3514     (not (cdr (gnus-data-find-list article)))))
3515
3516 (defun gnus-make-thread-indent-array (&optional n)
3517   (when (or n
3518             (progn (setq n 200) nil)
3519             (null gnus-thread-indent-array)
3520             (/= gnus-thread-indent-level gnus-thread-indent-array-level))
3521     (setq gnus-thread-indent-array (make-vector (1+ n) "")
3522           gnus-thread-indent-array-level gnus-thread-indent-level)
3523     (while (>= n 0)
3524       (aset gnus-thread-indent-array n
3525             (make-string (* n gnus-thread-indent-level) ? ))
3526       (setq n (1- n)))))
3527
3528 (defun gnus-update-summary-mark-positions ()
3529   "Compute where the summary marks are to go."
3530   (save-excursion
3531     (when (gnus-buffer-exists-p gnus-summary-buffer)
3532       (set-buffer gnus-summary-buffer))
3533     (let ((spec gnus-summary-line-format-spec)
3534           pos)
3535       (save-excursion
3536         (gnus-set-work-buffer)
3537         (let ((gnus-tmp-unread ?Z)
3538               (gnus-replied-mark ?Z)
3539               (gnus-score-below-mark ?Z)
3540               (gnus-score-over-mark ?Z)
3541               (gnus-undownloaded-mark ?Z)
3542               (gnus-summary-line-format-spec spec)
3543               (gnus-newsgroup-downloadable '(0))
3544               (header [0 "" "" "05 Apr 2001 23:33:09 +0400" "" "" 0 0 "" nil])
3545               case-fold-search ignores)
3546           ;; Here, all marks are bound to Z.
3547           (gnus-summary-insert-line header
3548                                     0 nil t gnus-tmp-unread t nil "" nil 1)
3549           (goto-char (point-min))
3550           ;; Memorize the positions of the same characters as dummy marks.
3551           (while (re-search-forward "[A-D]" nil t)
3552             (push (point) ignores))
3553           (erase-buffer)
3554           ;; We use A-D as dummy marks in order to know column positions
3555           ;; where marks should be inserted.
3556           (setq gnus-tmp-unread ?A
3557                 gnus-replied-mark ?B
3558                 gnus-score-below-mark ?C
3559                 gnus-score-over-mark ?C
3560                 gnus-undownloaded-mark ?D)
3561           (gnus-summary-insert-line header
3562                                     0 nil t gnus-tmp-unread t nil "" nil 1)
3563           ;; Ignore characters which aren't dummy marks.
3564           (dolist (p ignores)
3565             (delete-region (goto-char (1- p)) p)
3566             (insert ?Z))
3567           (goto-char (point-min))
3568           (setq pos (list (cons 'unread
3569                                 (and (search-forward "A" nil t)
3570                                      (- (point) (point-min) 1)))))
3571           (goto-char (point-min))
3572           (push (cons 'replied (and (search-forward "B" nil t)
3573                                     (- (point) (point-min) 1)))
3574                 pos)
3575           (goto-char (point-min))
3576           (push (cons 'score (and (search-forward "C" nil t)
3577                                   (- (point) (point-min) 1)))
3578                 pos)
3579           (goto-char (point-min))
3580           (push (cons 'download (and (search-forward "D" nil t)
3581                                      (- (point) (point-min) 1)))
3582                 pos)))
3583       (setq gnus-summary-mark-positions pos))))
3584
3585 (defun gnus-summary-insert-dummy-line (gnus-tmp-subject gnus-tmp-number)
3586   "Insert a dummy root in the summary buffer."
3587   (beginning-of-line)
3588   (gnus-add-text-properties
3589    (point) (progn (eval gnus-summary-dummy-line-format-spec) (point))
3590    (list 'gnus-number gnus-tmp-number 'gnus-intangible gnus-tmp-number)))
3591
3592 (defun gnus-summary-extract-address-component (from)
3593   (or (car (funcall gnus-extract-address-components from))
3594       from))
3595
3596 (defun gnus-summary-from-or-to-or-newsgroups (header gnus-tmp-from)
3597   (let ((mail-parse-charset gnus-newsgroup-charset)
3598         (ignored-from-addresses (gnus-ignored-from-addresses))
3599         ; Is it really necessary to do this next part for each summary line?
3600         ; Luckily, doesn't seem to slow things down much.
3601         (mail-parse-ignored-charsets
3602          (with-current-buffer gnus-summary-buffer
3603            gnus-newsgroup-ignored-charsets)))
3604     (or
3605      (and ignored-from-addresses
3606           (string-match ignored-from-addresses gnus-tmp-from)
3607           (let ((extra-headers (mail-header-extra header))
3608                 to
3609                 newsgroups)
3610             (cond
3611              ((setq to (cdr (assq 'To extra-headers)))
3612               (concat gnus-summary-to-prefix
3613                       (inline
3614                         (gnus-summary-extract-address-component
3615                          (funcall gnus-decode-encoded-address-function to)))))
3616              ((setq newsgroups
3617                     (or
3618                      (cdr (assq 'Newsgroups extra-headers))
3619                      (and
3620                       (memq 'Newsgroups gnus-extra-headers)
3621                       (eq (car (gnus-find-method-for-group
3622                                 gnus-newsgroup-name)) 'nntp)
3623                       (gnus-group-real-name gnus-newsgroup-name))))
3624               (concat gnus-summary-newsgroup-prefix newsgroups)))))
3625      (inline (gnus-summary-extract-address-component gnus-tmp-from)))))
3626
3627 (defun gnus-summary-insert-line (gnus-tmp-header
3628                                  gnus-tmp-level gnus-tmp-current
3629                                  undownloaded gnus-tmp-unread gnus-tmp-replied
3630                                  gnus-tmp-expirable gnus-tmp-subject-or-nil
3631                                  &optional gnus-tmp-dummy gnus-tmp-score
3632                                  gnus-tmp-process)
3633   (if (>= gnus-tmp-level (length gnus-thread-indent-array))
3634       (gnus-make-thread-indent-array (max (* 2 (length gnus-thread-indent-array))
3635                                           gnus-tmp-level)))
3636   (let* ((gnus-tmp-indentation (aref gnus-thread-indent-array gnus-tmp-level))
3637          (gnus-tmp-lines (mail-header-lines gnus-tmp-header))
3638          (gnus-tmp-score (or gnus-tmp-score gnus-summary-default-score 0))
3639          (gnus-tmp-score-char
3640           (if (or (null gnus-summary-default-score)
3641                   (<= (abs (- gnus-tmp-score gnus-summary-default-score))
3642                       gnus-summary-zcore-fuzz))
3643               ?                         ;Whitespace
3644             (if (< gnus-tmp-score gnus-summary-default-score)
3645                 gnus-score-below-mark gnus-score-over-mark)))
3646          (gnus-tmp-number (mail-header-number gnus-tmp-header))
3647          (gnus-tmp-replied
3648           (cond (gnus-tmp-process gnus-process-mark)
3649                 ((memq gnus-tmp-current gnus-newsgroup-cached)
3650                  gnus-cached-mark)
3651                 (gnus-tmp-replied gnus-replied-mark)
3652                 ((memq gnus-tmp-current gnus-newsgroup-forwarded)
3653                  gnus-forwarded-mark)
3654                 ((memq gnus-tmp-current gnus-newsgroup-saved)
3655                  gnus-saved-mark)
3656                 ((memq gnus-tmp-number gnus-newsgroup-recent)
3657                  gnus-recent-mark)
3658                 ((memq gnus-tmp-number gnus-newsgroup-unseen)
3659                  gnus-unseen-mark)
3660                 (t gnus-no-mark)))
3661          (gnus-tmp-downloaded
3662           (cond (undownloaded
3663                  gnus-undownloaded-mark)
3664                 (gnus-newsgroup-agentized
3665                  gnus-downloaded-mark)
3666                 (t
3667                  gnus-no-mark)))
3668          (gnus-tmp-from (mail-header-from gnus-tmp-header))
3669          (gnus-tmp-name
3670           (cond
3671            ((string-match "<[^>]+> *$" gnus-tmp-from)
3672             (let ((beg (match-beginning 0)))
3673               (or (and (string-match "^\".+\"" gnus-tmp-from)
3674                        (substring gnus-tmp-from 1 (1- (match-end 0))))
3675                   (substring gnus-tmp-from 0 beg))))
3676            ((string-match "(.+)" gnus-tmp-from)
3677             (substring gnus-tmp-from
3678                        (1+ (match-beginning 0)) (1- (match-end 0))))
3679            (t gnus-tmp-from)))
3680          (gnus-tmp-subject (mail-header-subject gnus-tmp-header))
3681          (gnus-tmp-opening-bracket (if gnus-tmp-dummy ?\< ?\[))
3682          (gnus-tmp-closing-bracket (if gnus-tmp-dummy ?\> ?\]))
3683          (buffer-read-only nil))
3684     (when (string= gnus-tmp-name "")
3685       (setq gnus-tmp-name gnus-tmp-from))
3686     (unless (numberp gnus-tmp-lines)
3687       (setq gnus-tmp-lines -1))
3688     (if (= gnus-tmp-lines -1)
3689         (setq gnus-tmp-lines "?")
3690       (setq gnus-tmp-lines (number-to-string gnus-tmp-lines)))
3691       (gnus-put-text-property
3692      (point)
3693      (progn (eval gnus-summary-line-format-spec) (point))
3694        'gnus-number gnus-tmp-number)
3695     (when (gnus-visual-p 'summary-highlight 'highlight)
3696       (forward-line -1)
3697       (gnus-run-hooks 'gnus-summary-update-hook)
3698       (forward-line 1))))
3699
3700 (defun gnus-summary-update-line (&optional dont-update)
3701   "Update summary line after change."
3702   (when (and gnus-summary-default-score
3703              (not gnus-summary-inhibit-highlight))
3704     (let* ((gnus-summary-inhibit-highlight t) ; Prevent recursion.
3705            (article (gnus-summary-article-number))
3706            (score (gnus-summary-article-score article)))
3707       (unless dont-update
3708         (if (and gnus-summary-mark-below
3709                  (< (gnus-summary-article-score)
3710                     gnus-summary-mark-below))
3711             ;; This article has a low score, so we mark it as read.
3712             (when (memq article gnus-newsgroup-unreads)
3713               (gnus-summary-mark-article-as-read gnus-low-score-mark))
3714           (when (eq (gnus-summary-article-mark) gnus-low-score-mark)
3715             ;; This article was previously marked as read on account
3716             ;; of a low score, but now it has risen, so we mark it as
3717             ;; unread.
3718             (gnus-summary-mark-article-as-unread gnus-unread-mark)))
3719         (gnus-summary-update-mark
3720          (if (or (null gnus-summary-default-score)
3721                  (<= (abs (- score gnus-summary-default-score))
3722                      gnus-summary-zcore-fuzz))
3723              ?                          ;Whitespace
3724            (if (< score gnus-summary-default-score)
3725                gnus-score-below-mark gnus-score-over-mark))
3726          'score))
3727       ;; Do visual highlighting.
3728       (when (gnus-visual-p 'summary-highlight 'highlight)
3729         (gnus-run-hooks 'gnus-summary-update-hook)))))
3730
3731 (defvar gnus-tmp-new-adopts nil)
3732
3733 (defun gnus-summary-number-of-articles-in-thread (thread &optional level char)
3734   "Return the number of articles in THREAD.
3735 This may be 0 in some cases -- if none of the articles in
3736 the thread are to be displayed."
3737   (let* ((number
3738          ;; Fix by Luc Van Eycken <Luc.VanEycken@esat.kuleuven.ac.be>.
3739           (cond