f86cf22a87bfbd7bf896ac46259a3e4c7c12afd5
[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 \f
2966
2967 (defun gnus-summary-mode (&optional group)
2968   "Major mode for reading articles.
2969
2970 All normal editing commands are switched off.
2971 \\<gnus-summary-mode-map>
2972 Each line in this buffer represents one article.  To read an
2973 article, you can, for instance, type `\\[gnus-summary-next-page]'.  To move forwards
2974 and backwards while displaying articles, type `\\[gnus-summary-next-unread-article]' and `\\[gnus-summary-prev-unread-article]',
2975 respectively.
2976
2977 You can also post articles and send mail from this buffer.  To
2978 follow up an article, type `\\[gnus-summary-followup]'.  To mail a reply to the author
2979 of an article, type `\\[gnus-summary-reply]'.
2980
2981 There are approx. one gazillion commands you can execute in this
2982 buffer; read the info pages for more information (`\\[gnus-info-find-node]').
2983
2984 The following commands are available:
2985
2986 \\{gnus-summary-mode-map}"
2987   (interactive)
2988   (kill-all-local-variables)
2989   (let ((gnus-summary-local-variables gnus-newsgroup-variables))
2990     (gnus-summary-make-local-variables))
2991   (gnus-summary-make-local-variables)
2992   (setq gnus-newsgroup-name group)
2993   (when (gnus-visual-p 'summary-menu 'menu)
2994     (gnus-summary-make-menu-bar)
2995     (gnus-summary-make-tool-bar))
2996   (gnus-make-thread-indent-array)
2997   (gnus-simplify-mode-line)
2998   (setq major-mode 'gnus-summary-mode)
2999   (setq mode-name "Summary")
3000   (make-local-variable 'minor-mode-alist)
3001   (use-local-map gnus-summary-mode-map)
3002   (buffer-disable-undo)
3003   (setq buffer-read-only t              ;Disable modification
3004         show-trailing-whitespace nil)
3005   (setq truncate-lines t)
3006   (setq selective-display t)
3007   (setq selective-display-ellipses t)   ;Display `...'
3008   (gnus-summary-set-display-table)
3009   (gnus-set-default-directory)
3010   (make-local-variable 'gnus-summary-line-format)
3011   (make-local-variable 'gnus-summary-line-format-spec)
3012   (make-local-variable 'gnus-summary-dummy-line-format)
3013   (make-local-variable 'gnus-summary-dummy-line-format-spec)
3014   (make-local-variable 'gnus-summary-mark-positions)
3015   (gnus-make-local-hook 'pre-command-hook)
3016   (add-hook 'pre-command-hook 'gnus-set-global-variables nil t)
3017   (gnus-run-mode-hooks 'gnus-summary-mode-hook)
3018   (turn-on-gnus-mailing-list-mode)
3019   (mm-enable-multibyte)
3020   (gnus-update-format-specifications nil 'summary 'summary-mode 'summary-dummy)
3021   (gnus-update-summary-mark-positions))
3022
3023 (defun gnus-summary-make-local-variables ()
3024   "Make all the local summary buffer variables."
3025   (let (global)
3026     (dolist (local gnus-summary-local-variables)
3027       (if (consp local)
3028           (progn
3029             (if (eq (cdr local) 'global)
3030                 ;; Copy the global value of the variable.
3031                 (setq global (symbol-value (car local)))
3032               ;; Use the value from the list.
3033               (setq global (eval (cdr local))))
3034             (set (make-local-variable (car local)) global))
3035         ;; Simple nil-valued local variable.
3036         (set (make-local-variable local) nil)))))
3037
3038 (defun gnus-summary-clear-local-variables ()
3039   (let ((locals gnus-summary-local-variables))
3040     (while locals
3041       (if (consp (car locals))
3042           (and (symbolp (caar locals))
3043                (set (caar locals) nil))
3044         (and (symbolp (car locals))
3045              (set (car locals) nil)))
3046       (setq locals (cdr locals)))))
3047
3048 ;; Summary data functions.
3049
3050 (defmacro gnus-data-number (data)
3051   `(car ,data))
3052
3053 (defmacro gnus-data-set-number (data number)
3054   `(setcar ,data ,number))
3055
3056 (defmacro gnus-data-mark (data)
3057   `(nth 1 ,data))
3058
3059 (defmacro gnus-data-set-mark (data mark)
3060   `(setcar (nthcdr 1 ,data) ,mark))
3061
3062 (defmacro gnus-data-pos (data)
3063   `(nth 2 ,data))
3064
3065 (defmacro gnus-data-set-pos (data pos)
3066   `(setcar (nthcdr 2 ,data) ,pos))
3067
3068 (defmacro gnus-data-header (data)
3069   `(nth 3 ,data))
3070
3071 (defmacro gnus-data-set-header (data header)
3072   `(setf (nth 3 ,data) ,header))
3073
3074 (defmacro gnus-data-level (data)
3075   `(nth 4 ,data))
3076
3077 (defmacro gnus-data-unread-p (data)
3078   `(= (nth 1 ,data) gnus-unread-mark))
3079
3080 (defmacro gnus-data-read-p (data)
3081   `(/= (nth 1 ,data) gnus-unread-mark))
3082
3083 (defmacro gnus-data-pseudo-p (data)
3084   `(consp (nth 3 ,data)))
3085
3086 (defmacro gnus-data-find (number)
3087   `(assq ,number gnus-newsgroup-data))
3088
3089 (defmacro gnus-data-find-list (number &optional data)
3090   `(let ((bdata ,(or data 'gnus-newsgroup-data)))
3091      (memq (assq ,number bdata)
3092            bdata)))
3093
3094 (defmacro gnus-data-make (number mark pos header level)
3095   `(list ,number ,mark ,pos ,header ,level))
3096
3097 (defun gnus-data-enter (after-article number mark pos header level offset)
3098   (let ((data (gnus-data-find-list after-article)))
3099     (unless data
3100       (error "No such article: %d" after-article))
3101     (setcdr data (cons (gnus-data-make number mark pos header level)
3102                        (cdr data)))
3103     (setq gnus-newsgroup-data-reverse nil)
3104     (gnus-data-update-list (cddr data) offset)))
3105
3106 (defun gnus-data-enter-list (after-article list &optional offset)
3107   (when list
3108     (let ((data (and after-article (gnus-data-find-list after-article)))
3109           (ilist list))
3110       (if (not (or data
3111                    after-article))
3112           (let ((odata gnus-newsgroup-data))
3113             (setq gnus-newsgroup-data (nconc list gnus-newsgroup-data))
3114             (when offset
3115               (gnus-data-update-list odata offset)))
3116         ;; Find the last element in the list to be spliced into the main
3117         ;; list.
3118         (setq list (last list))
3119         (if (not data)
3120             (progn
3121               (setcdr list gnus-newsgroup-data)
3122               (setq gnus-newsgroup-data ilist)
3123               (when offset
3124                 (gnus-data-update-list (cdr list) offset)))
3125           (setcdr list (cdr data))
3126           (setcdr data ilist)
3127           (when offset
3128             (gnus-data-update-list (cdr list) offset))))
3129       (setq gnus-newsgroup-data-reverse nil))))
3130
3131 (defun gnus-data-remove (article &optional offset)
3132   (let ((data gnus-newsgroup-data))
3133     (if (= (gnus-data-number (car data)) article)
3134         (progn
3135           (setq gnus-newsgroup-data (cdr gnus-newsgroup-data)
3136                 gnus-newsgroup-data-reverse nil)
3137           (when offset
3138             (gnus-data-update-list gnus-newsgroup-data offset)))
3139       (while (cdr data)
3140         (when (= (gnus-data-number (cadr data)) article)
3141           (setcdr data (cddr data))
3142           (when offset
3143             (gnus-data-update-list (cdr data) offset))
3144           (setq data nil
3145                 gnus-newsgroup-data-reverse nil))
3146         (setq data (cdr data))))))
3147
3148 (defmacro gnus-data-list (backward)
3149   `(if ,backward
3150        (or gnus-newsgroup-data-reverse
3151            (setq gnus-newsgroup-data-reverse
3152                  (reverse gnus-newsgroup-data)))
3153      gnus-newsgroup-data))
3154
3155 (defun gnus-data-update-list (data offset)
3156   "Add OFFSET to the POS of all data entries in DATA."
3157   (setq gnus-newsgroup-data-reverse nil)
3158   (while data
3159     (setcar (nthcdr 2 (car data)) (+ offset (nth 2 (car data))))
3160     (setq data (cdr data))))
3161
3162 (defun gnus-summary-article-pseudo-p (article)
3163   "Say whether this article is a pseudo article or not."
3164   (not (vectorp (gnus-data-header (gnus-data-find article)))))
3165
3166 (defmacro gnus-summary-article-sparse-p (article)
3167   "Say whether this article is a sparse article or not."
3168   `(memq ,article gnus-newsgroup-sparse))
3169
3170 (defmacro gnus-summary-article-ancient-p (article)
3171   "Say whether this article is a sparse article or not."
3172   `(memq ,article gnus-newsgroup-ancient))
3173
3174 (defun gnus-article-parent-p (number)
3175   "Say whether this article is a parent or not."
3176   (let ((data (gnus-data-find-list number)))
3177     (and (cdr data)              ; There has to be an article after...
3178          (< (gnus-data-level (car data)) ; And it has to have a higher level.
3179             (gnus-data-level (nth 1 data))))))
3180
3181 (defun gnus-article-children (number)
3182   "Return a list of all children to NUMBER."
3183   (let* ((data (gnus-data-find-list number))
3184          (level (gnus-data-level (car data)))
3185          children)
3186     (setq data (cdr data))
3187     (while (and data
3188                 (= (gnus-data-level (car data)) (1+ level)))
3189       (push (gnus-data-number (car data)) children)
3190       (setq data (cdr data)))
3191     children))
3192
3193 (defmacro gnus-summary-skip-intangible ()
3194   "If the current article is intangible, then jump to a different article."
3195   '(let ((to (get-text-property (point) 'gnus-intangible)))
3196      (and to (gnus-summary-goto-subject to))))
3197
3198 (defmacro gnus-summary-article-intangible-p ()
3199   "Say whether this article is intangible or not."
3200   '(get-text-property (point) 'gnus-intangible))
3201
3202 (defun gnus-article-read-p (article)
3203   "Say whether ARTICLE is read or not."
3204   (not (or (memq article gnus-newsgroup-marked)
3205            (memq article gnus-newsgroup-spam-marked)
3206            (memq article gnus-newsgroup-unreads)
3207            (memq article gnus-newsgroup-unselected)
3208            (memq article gnus-newsgroup-dormant))))
3209
3210 ;; Some summary mode macros.
3211
3212 (defmacro gnus-summary-article-number ()
3213   "The article number of the article on the current line.
3214 If there isn't an article number here, then we return the current
3215 article number."
3216   '(progn
3217      (gnus-summary-skip-intangible)
3218      (or (get-text-property (point) 'gnus-number)
3219          (gnus-summary-last-subject))))
3220
3221 (defmacro gnus-summary-article-header (&optional number)
3222   "Return the header of article NUMBER."
3223   `(gnus-data-header (gnus-data-find
3224                       ,(or number '(gnus-summary-article-number)))))
3225
3226 (defmacro gnus-summary-thread-level (&optional number)
3227   "Return the level of thread that starts with article NUMBER."
3228   `(if (and (eq gnus-summary-make-false-root 'dummy)
3229             (get-text-property (point) 'gnus-intangible))
3230        0
3231      (gnus-data-level (gnus-data-find
3232                        ,(or number '(gnus-summary-article-number))))))
3233
3234 (defmacro gnus-summary-article-mark (&optional number)
3235   "Return the mark of article NUMBER."
3236   `(gnus-data-mark (gnus-data-find
3237                     ,(or number '(gnus-summary-article-number)))))
3238
3239 (defmacro gnus-summary-article-pos (&optional number)
3240   "Return the position of the line of article NUMBER."
3241   `(gnus-data-pos (gnus-data-find
3242                    ,(or number '(gnus-summary-article-number)))))
3243
3244 (defalias 'gnus-summary-subject-string 'gnus-summary-article-subject)
3245 (defmacro gnus-summary-article-subject (&optional number)
3246   "Return current subject string or nil if nothing."
3247   `(let ((headers
3248           ,(if number
3249                `(gnus-data-header (assq ,number gnus-newsgroup-data))
3250              '(gnus-data-header (assq (gnus-summary-article-number)
3251                                       gnus-newsgroup-data)))))
3252      (and headers
3253           (vectorp headers)
3254           (mail-header-subject headers))))
3255
3256 (defmacro gnus-summary-article-score (&optional number)
3257   "Return current article score."
3258   `(or (cdr (assq ,(or number '(gnus-summary-article-number))
3259                   gnus-newsgroup-scored))
3260        gnus-summary-default-score 0))
3261
3262 (defun gnus-summary-article-children (&optional number)
3263   "Return a list of article numbers that are children of article NUMBER."
3264   (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))))
3265          (level (gnus-data-level (car data)))
3266          l children)
3267     (while (and (setq data (cdr data))
3268                 (> (setq l (gnus-data-level (car data))) level))
3269       (and (= (1+ level) l)
3270            (push (gnus-data-number (car data))
3271                  children)))
3272     (nreverse children)))
3273
3274 (defun gnus-summary-article-parent (&optional number)
3275   "Return the article number of the parent of article NUMBER."
3276   (let* ((data (gnus-data-find-list (or number (gnus-summary-article-number))
3277                                     (gnus-data-list t)))
3278          (level (gnus-data-level (car data))))
3279     (if (zerop level)
3280         ()                              ; This is a root.
3281       ;; We search until we find an article with a level less than
3282       ;; this one.  That function has to be the parent.
3283       (while (and (setq data (cdr data))
3284                   (not (< (gnus-data-level (car data)) level))))
3285       (and data (gnus-data-number (car data))))))
3286
3287 (defun gnus-unread-mark-p (mark)
3288   "Say whether MARK is the unread mark."
3289   (= mark gnus-unread-mark))
3290
3291 (defun gnus-read-mark-p (mark)
3292   "Say whether MARK is one of the marks that mark as read.
3293 This is all marks except unread, ticked, dormant, and expirable."
3294   (not (or (= mark gnus-unread-mark)
3295            (= mark gnus-ticked-mark)
3296            (= mark gnus-spam-mark)
3297            (= mark gnus-dormant-mark)
3298            (= mark gnus-expirable-mark))))
3299
3300 (defmacro gnus-article-mark (number)
3301   "Return the MARK of article NUMBER.
3302 This macro should only be used when computing the mark the \"first\"
3303 time; i.e., when generating the summary lines.  After that,
3304 `gnus-summary-article-mark' should be used to examine the
3305 marks of articles."
3306   `(cond
3307     ((memq ,number gnus-newsgroup-unsendable) gnus-unsendable-mark)
3308     ((memq ,number gnus-newsgroup-downloadable) gnus-downloadable-mark)
3309     ((memq ,number gnus-newsgroup-unreads) gnus-unread-mark)
3310     ((memq ,number gnus-newsgroup-marked) gnus-ticked-mark)
3311     ((memq ,number gnus-newsgroup-spam-marked) gnus-spam-mark)
3312     ((memq ,number gnus-newsgroup-dormant) gnus-dormant-mark)
3313     ((memq ,number gnus-newsgroup-expirable) gnus-expirable-mark)
3314     (t (or (cdr (assq ,number gnus-newsgroup-reads))
3315            gnus-ancient-mark))))
3316
3317 ;; Saving hidden threads.
3318
3319 (defmacro gnus-save-hidden-threads (&rest forms)
3320   "Save hidden threads, eval FORMS, and restore the hidden threads."
3321   (let ((config (make-symbol "config")))
3322     `(let ((,config (gnus-hidden-threads-configuration)))
3323        (unwind-protect
3324            (save-excursion
3325              ,@forms)
3326          (gnus-restore-hidden-threads-configuration ,config)))))
3327 (put 'gnus-save-hidden-threads 'lisp-indent-function 0)
3328 (put 'gnus-save-hidden-threads 'edebug-form-spec '(body))
3329
3330 (defun gnus-data-compute-positions ()
3331   "Compute the positions of all articles."
3332   (setq gnus-newsgroup-data-reverse nil)
3333   (let ((data gnus-newsgroup-data))
3334     (save-excursion
3335       (gnus-save-hidden-threads
3336         (gnus-summary-show-all-threads)
3337         (goto-char (point-min))
3338         (while data
3339           (while (get-text-property (point) 'gnus-intangible)
3340             (forward-line 1))
3341           (gnus-data-set-pos (car data) (+ (point) 3))
3342           (setq data (cdr data))
3343           (forward-line 1))))))
3344
3345 (defun gnus-hidden-threads-configuration ()
3346   "Return the current hidden threads configuration."
3347   (save-excursion
3348     (let (config)
3349       (goto-char (point-min))
3350       (while (search-forward "\r" nil t)
3351         (push (1- (point)) config))
3352       config)))
3353
3354 (defun gnus-restore-hidden-threads-configuration (config)
3355   "Restore hidden threads configuration from CONFIG."
3356   (save-excursion
3357     (let (point buffer-read-only)
3358       (while (setq point (pop config))
3359         (when (and (< point (point-max))
3360                    (goto-char point)
3361                    (eq (char-after) ?\n))
3362           (subst-char-in-region point (1+ point) ?\n ?\r))))))
3363
3364 ;; Various summary mode internalish functions.
3365
3366 (defun gnus-mouse-pick-article (e)
3367   (interactive "e")
3368   (mouse-set-point e)
3369   (gnus-summary-next-page nil t))
3370
3371 (defun gnus-summary-set-display-table ()
3372   "Change the display table.
3373 Odd characters have a tendency to mess
3374 up nicely formatted displays - we make all possible glyphs
3375 display only a single character."
3376
3377   ;; We start from the standard display table, if any.
3378   (let ((table (or (copy-sequence standard-display-table)
3379                    (make-display-table)))
3380         (i 32))
3381     ;; Nix out all the control chars...
3382     (while (>= (setq i (1- i)) 0)
3383       (aset table i [??]))
3384    ;; ... but not newline and cr, of course.  (cr is necessary for the
3385     ;; selective display).
3386     (aset table ?\n nil)
3387     (aset table ?\r nil)
3388     ;; We keep TAB as well.
3389     (aset table ?\t nil)
3390     ;; We nix out any glyphs 127 through 255, or 127 through 159 in
3391     ;; Emacs 23 (unicode), that are not set already.
3392     (let ((i (if (ignore-errors (= (make-char 'latin-iso8859-1 160) 160))
3393                  160
3394                256)))
3395       (while (>= (setq i (1- i)) 127)
3396         ;; Only modify if the entry is nil.
3397         (unless (aref table i)
3398           (aset table i [??]))))
3399     (setq buffer-display-table table)))
3400
3401 (defun gnus-summary-set-article-display-arrow (pos)
3402   "Update the overlay arrow to point to line at position POS."
3403   (when (and gnus-summary-display-arrow
3404              (boundp 'overlay-arrow-position)
3405              (boundp 'overlay-arrow-string))
3406     (save-excursion
3407       (goto-char pos)
3408       (beginning-of-line)
3409       (unless overlay-arrow-position
3410         (setq overlay-arrow-position (make-marker)))
3411       (setq overlay-arrow-string "=>"
3412             overlay-arrow-position (set-marker overlay-arrow-position
3413                                                (point)
3414                                                (current-buffer))))))
3415
3416 (defun gnus-summary-setup-buffer (group)
3417   "Initialize summary buffer."
3418   (let ((buffer (gnus-summary-buffer-name group))
3419         (dead-name (concat "*Dead Summary "
3420                            (gnus-group-decoded-name group) "*")))
3421     ;; If a dead summary buffer exists, we kill it.
3422     (when (gnus-buffer-live-p dead-name)
3423       (gnus-kill-buffer dead-name))
3424     (if (get-buffer buffer)
3425         (progn
3426           (set-buffer buffer)
3427           (setq gnus-summary-buffer (current-buffer))
3428           (not gnus-newsgroup-prepared))
3429       ;; Fix by Sudish Joseph <joseph@cis.ohio-state.edu>
3430       (setq gnus-summary-buffer (set-buffer (gnus-get-buffer-create buffer)))
3431       (gnus-summary-mode group)
3432       (when gnus-carpal
3433         (gnus-carpal-setup-buffer 'summary))
3434       (when (gnus-group-quit-config group)
3435         (set (make-local-variable 'gnus-single-article-buffer) nil))
3436       (make-local-variable 'gnus-article-buffer)
3437       (make-local-variable 'gnus-article-current)
3438       (make-local-variable 'gnus-original-article-buffer)
3439       (setq gnus-newsgroup-name group)
3440       ;; Set any local variables in the group parameters.
3441       (gnus-summary-set-local-parameters gnus-newsgroup-name)
3442       t)))
3443
3444 (defun gnus-set-global-variables ()
3445   "Set the global equivalents of the buffer-local variables.
3446 They are set to the latest values they had.  These reflect the summary
3447 buffer that was in action when the last article was fetched."
3448   (when (eq major-mode 'gnus-summary-mode)
3449     (setq gnus-summary-buffer (current-buffer))
3450     (let ((name gnus-newsgroup-name)
3451           (marked gnus-newsgroup-marked)
3452           (spam gnus-newsgroup-spam-marked)
3453           (unread gnus-newsgroup-unreads)
3454           (headers gnus-current-headers)
3455           (data gnus-newsgroup-data)
3456           (summary gnus-summary-buffer)
3457           (article-buffer gnus-article-buffer)
3458           (original gnus-original-article-buffer)
3459           (gac gnus-article-current)
3460           (reffed gnus-reffed-article-number)
3461           (score-file gnus-current-score-file)
3462           (default-charset gnus-newsgroup-charset)
3463           vlist)
3464       (let ((locals gnus-newsgroup-variables))
3465         (while locals
3466           (if (consp (car locals))
3467               (push (eval (caar locals)) vlist)
3468             (push (eval (car locals)) vlist))
3469           (setq locals (cdr locals)))
3470         (setq vlist (nreverse vlist)))
3471       (with-current-buffer gnus-group-buffer
3472         (setq gnus-newsgroup-name name
3473               gnus-newsgroup-marked marked
3474               gnus-newsgroup-spam-marked spam
3475               gnus-newsgroup-unreads unread
3476               gnus-current-headers headers
3477               gnus-newsgroup-data data
3478               gnus-article-current gac
3479               gnus-summary-buffer summary
3480               gnus-article-buffer article-buffer
3481               gnus-original-article-buffer original
3482               gnus-reffed-article-number reffed
3483               gnus-current-score-file score-file
3484               gnus-newsgroup-charset default-charset)
3485         (let ((locals gnus-newsgroup-variables))
3486           (while locals
3487             (if (consp (car locals))
3488                 (set (caar locals) (pop vlist))
3489               (set (car locals) (pop vlist)))
3490             (setq locals (cdr locals))))
3491         ;; The article buffer also has local variables.
3492         (when (gnus-buffer-live-p gnus-article-buffer)
3493           (set-buffer gnus-article-buffer)
3494           (setq gnus-summary-buffer summary))))))
3495
3496 (defun gnus-summary-article-unread-p (article)
3497   "Say whether ARTICLE is unread or not."
3498   (memq article gnus-newsgroup-unreads))
3499
3500 (defun gnus-summary-first-article-p (&optional article)
3501   "Return whether ARTICLE is the first article in the buffer."
3502   (if (not (setq article (or article (gnus-summary-article-number))))
3503       nil
3504     (eq article (caar gnus-newsgroup-data))))
3505
3506 (defun gnus-summary-last-article-p (&optional article)
3507   "Return whether ARTICLE is the last article in the buffer."
3508   (if (not (setq article (or article (gnus-summary-article-number))))
3509       ;; All non-existent numbers are the last article.  :-)
3510       t
3511     (not (cdr (gnus-data-find-list article)))))
3512
3513 (defun gnus-make-thread-indent-array (&optional n)
3514   (when (or n
3515             (progn (setq n 200) nil)
3516             (null gnus-thread-indent-array)
3517             (/= gnus-thread-indent-level gnus-thread-indent-array-level))
3518     (setq gnus-thread-indent-array (make-vector (1+ n) "")
3519           gnus-thread-indent-array-level gnus-thread-indent-level)
3520     (while (>= n 0)
3521       (aset gnus-thread-indent-array n
3522             (make-string (* n gnus-thread-indent-level) ? ))
3523       (setq n (1- n)))))
3524
3525 (defun gnus-update-summary-mark-positions ()
3526   "Compute where the summary marks are to go."
3527   (save-excursion
3528     (when (gnus-buffer-exists-p gnus-summary-buffer)
3529       (set-buffer gnus-summary-buffer))
3530     (let ((spec gnus-summary-line-format-spec)
3531           pos)
3532       (save-excursion
3533         (gnus-set-work-buffer)
3534         (let ((gnus-tmp-unread ?Z)
3535               (gnus-replied-mark ?Z)
3536               (gnus-score-below-mark ?Z)
3537               (gnus-score-over-mark ?Z)
3538               (gnus-undownloaded-mark ?Z)
3539               (gnus-summary-line-format-spec spec)
3540               (gnus-newsgroup-downloadable '(0))
3541               (header [0 "" "" "05 Apr 2001 23:33:09 +0400" "" "" 0 0 "" nil])
3542               case-fold-search ignores)
3543           ;; Here, all marks are bound to Z.
3544           (gnus-summary-insert-line header
3545                                     0 nil t gnus-tmp-unread t nil "" nil 1)
3546           (goto-char (point-min))
3547           ;; Memorize the positions of the same characters as dummy marks.
3548           (while (re-search-forward "[A-D]" nil t)
3549             (push (point) ignores))
3550           (erase-buffer)
3551           ;; We use A-D as dummy marks in order to know column positions
3552           ;; where marks should be inserted.
3553           (setq gnus-tmp-unread ?A
3554                 gnus-replied-mark ?B
3555                 gnus-score-below-mark ?C
3556                 gnus-score-over-mark ?C
3557                 gnus-undownloaded-mark ?D)
3558           (gnus-summary-insert-line header
3559                                     0 nil t gnus-tmp-unread t nil "" nil 1)
3560           ;; Ignore characters which aren't dummy marks.
3561           (dolist (p ignores)
3562             (delete-region (goto-char (1- p)) p)
3563             (insert ?Z))
3564           (goto-char (point-min))
3565           (setq pos (list (cons 'unread
3566                                 (and (search-forward "A" nil t)
3567                                      (- (point) (point-min) 1)))))
3568           (goto-char (point-min))
3569           (push (cons 'replied (and (search-forward "B" nil t)
3570                                     (- (point) (point-min) 1)))
3571                 pos)
3572           (goto-char (point-min))
3573           (push (cons 'score (and (search-forward "C" nil t)
3574                                   (- (point) (point-min) 1)))
3575                 pos)
3576           (goto-char (point-min))
3577           (push (cons 'download (and (search-forward "D" nil t)
3578                                      (- (point) (point-min) 1)))
3579                 pos)))
3580       (setq gnus-summary-mark-positions pos))))
3581
3582 (defun gnus-summary-insert-dummy-line (gnus-tmp-subject gnus-tmp-number)
3583   "Insert a dummy root in the summary buffer."
3584   (beginning-of-line)
3585   (gnus-add-text-properties
3586    (point) (progn (eval gnus-summary-dummy-line-format-spec) (point))
3587    (list 'gnus-number gnus-tmp-number 'gnus-intangible gnus-tmp-number)))
3588
3589 (defun gnus-summary-extract-address-component (from)
3590   (or (car (funcall gnus-extract-address-components from))
3591       from))
3592
3593 (defun gnus-summary-from-or-to-or-newsgroups (header gnus-tmp-from)
3594   (let ((mail-parse-charset gnus-newsgroup-charset)
3595         (ignored-from-addresses (gnus-ignored-from-addresses))
3596         ; Is it really necessary to do this next part for each summary line?
3597         ; Luckily, doesn't seem to slow things down much.
3598         (mail-parse-ignored-charsets
3599          (with-current-buffer gnus-summary-buffer
3600            gnus-newsgroup-ignored-charsets)))
3601     (or
3602      (and ignored-from-addresses
3603           (string-match ignored-from-addresses gnus-tmp-from)
3604           (let ((extra-headers (mail-header-extra header))
3605                 to
3606                 newsgroups)
3607             (cond
3608              ((setq to (cdr (assq 'To extra-headers)))
3609               (concat gnus-summary-to-prefix
3610                       (inline
3611                         (gnus-summary-extract-address-component
3612                          (funcall gnus-decode-encoded-address-function to)))))
3613              ((setq newsgroups
3614                     (or
3615                      (cdr (assq 'Newsgroups extra-headers))
3616                      (and
3617                       (memq 'Newsgroups gnus-extra-headers)
3618                       (eq (car (gnus-find-method-for-group
3619                                 gnus-newsgroup-name)) 'nntp)
3620                       (gnus-group-real-name gnus-newsgroup-name))))
3621               (concat gnus-summary-newsgroup-prefix newsgroups)))))
3622      (inline (gnus-summary-extract-address-component gnus-tmp-from)))))
3623
3624 (defun gnus-summary-insert-line (gnus-tmp-header
3625                                  gnus-tmp-level gnus-tmp-current
3626                                  undownloaded gnus-tmp-unread gnus-tmp-replied
3627                                  gnus-tmp-expirable gnus-tmp-subject-or-nil
3628                                  &optional gnus-tmp-dummy gnus-tmp-score
3629                                  gnus-tmp-process)
3630   (if (>= gnus-tmp-level (length gnus-thread-indent-array))
3631       (gnus-make-thread-indent-array (max (* 2 (length gnus-thread-indent-array))
3632                                           gnus-tmp-level)))
3633   (let* ((gnus-tmp-indentation (aref gnus-thread-indent-array gnus-tmp-level))
3634          (gnus-tmp-lines (mail-header-lines gnus-tmp-header))
3635          (gnus-tmp-score (or gnus-tmp-score gnus-summary-default-score 0))
3636          (gnus-tmp-score-char
3637           (if (or (null gnus-summary-default-score)
3638                   (<= (abs (- gnus-tmp-score gnus-summary-default-score))
3639                       gnus-summary-zcore-fuzz))
3640               ?                         ;Whitespace
3641             (if (< gnus-tmp-score gnus-summary-default-score)
3642                 gnus-score-below-mark gnus-score-over-mark)))
3643          (gnus-tmp-number (mail-header-number gnus-tmp-header))
3644          (gnus-tmp-replied
3645           (cond (gnus-tmp-process gnus-process-mark)
3646                 ((memq gnus-tmp-current gnus-newsgroup-cached)
3647                  gnus-cached-mark)
3648                 (gnus-tmp-replied gnus-replied-mark)
3649                 ((memq gnus-tmp-current gnus-newsgroup-forwarded)
3650                  gnus-forwarded-mark)
3651                 ((memq gnus-tmp-current gnus-newsgroup-saved)
3652                  gnus-saved-mark)
3653                 ((memq gnus-tmp-number gnus-newsgroup-recent)
3654                  gnus-recent-mark)
3655                 ((memq gnus-tmp-number gnus-newsgroup-unseen)
3656                  gnus-unseen-mark)
3657                 (t gnus-no-mark)))
3658          (gnus-tmp-downloaded
3659           (cond (undownloaded
3660                  gnus-undownloaded-mark)
3661                 (gnus-newsgroup-agentized
3662                  gnus-downloaded-mark)
3663                 (t
3664                  gnus-no-mark)))
3665          (gnus-tmp-from (mail-header-from gnus-tmp-header))
3666          (gnus-tmp-name
3667           (cond
3668            ((string-match "<[^>]+> *$" gnus-tmp-from)
3669             (let ((beg (match-beginning 0)))
3670               (or (and (string-match "^\".+\"" gnus-tmp-from)
3671                        (substring gnus-tmp-from 1 (1- (match-end 0))))
3672                   (substring gnus-tmp-from 0 beg))))
3673            ((string-match "(.+)" gnus-tmp-from)
3674             (substring gnus-tmp-from
3675                        (1+ (match-beginning 0)) (1- (match-end 0))))
3676            (t gnus-tmp-from)))
3677          (gnus-tmp-subject (mail-header-subject gnus-tmp-header))
3678          (gnus-tmp-opening-bracket (if gnus-tmp-dummy ?\< ?\[))
3679          (gnus-tmp-closing-bracket (if gnus-tmp-dummy ?\> ?\]))
3680          (buffer-read-only nil))
3681     (when (string= gnus-tmp-name "")
3682       (setq gnus-tmp-name gnus-tmp-from))
3683     (unless (numberp gnus-tmp-lines)
3684       (setq gnus-tmp-lines -1))
3685     (if (= gnus-tmp-lines -1)
3686         (setq gnus-tmp-lines "?")
3687       (setq gnus-tmp-lines (number-to-string gnus-tmp-lines)))
3688       (gnus-put-text-property
3689      (point)
3690      (progn (eval gnus-summary-line-format-spec) (point))
3691        'gnus-number gnus-tmp-number)
3692     (when (gnus-visual-p 'summary-highlight 'highlight)
3693       (forward-line -1)
3694       (gnus-run-hooks 'gnus-summary-update-hook)
3695       (forward-line 1))))
3696
3697 (defun gnus-summary-update-line (&optional dont-update)
3698   "Update summary line after change."
3699   (when (and gnus-summary-default-score
3700              (not gnus-summary-inhibit-highlight))
3701     (let* ((gnus-summary-inhibit-highlight t) ; Prevent recursion.
3702            (article (gnus-summary-article-number))
3703            (score (gnus-summary-article-score article)))
3704       (unless dont-update
3705         (if (and gnus-summary-mark-below
3706                  (< (gnus-summary-article-score)
3707                     gnus-summary-mark-below))
3708             ;; This article has a low score, so we mark it as read.
3709             (when (memq article gnus-newsgroup-unreads)
3710               (gnus-summary-mark-article-as-read gnus-low-score-mark))
3711           (when (eq (gnus-summary-article-mark) gnus-low-score-mark)
3712             ;; This article was previously marked as read on account
3713             ;; of a low score, but now it has risen, so we mark it as
3714             ;; unread.
3715             (gnus-summary-mark-article-as-unread gnus-unread-mark)))
3716         (gnus-summary-update-mark
3717          (if (or (null gnus-summary-default-score)
3718                  (<= (abs (- score gnus-summary-default-score))
3719                      gnus-summary-zcore-fuzz))
3720              ?                          ;Whitespace
3721            (if (< score gnus-summary-default-score)
3722                gnus-score-below-mark gnus-score-over-mark))
3723          'score))
3724       ;; Do visual highlighting.
3725       (when (gnus-visual-p 'summary-highlight 'highlight)
3726         (gnus-run-hooks 'gnus-summary-update-hook)))))
3727
3728 (defvar gnus-tmp-new-adopts nil)
3729
3730 (defun gnus-summary-number-of-articles-in-thread (thread &optional level char)
3731   "Return the number of articles in THREAD.
3732 This may be 0 in some cases -- if none of the articles in
3733 the thread are to be displayed."
3734   (let* ((number
3735          ;; Fix by Luc Van Eycken <Luc.VanEycken@esat.kuleuven.ac.be>.
3736           (cond
3737            ((not (listp thread))
3738             1)
3739            ((and (consp thread) (cdr thread))
3740             (apply
3741              '+ 1 (mapcar
3742                    'gnus-summary-number-of-articles-in-thread (cdr thread))))
3743            ((null thread)
3744             1)
3745            ((memq (mail-header-number (car thread)) gnus-newsgroup-limit)
3746             1)
3747            (t 0))))
3748     (when (and level (zerop level) gnus-tmp-new-adopts)
3749       (incf number
3750             (apply '+ (mapcar
3751                        'gnus-summary-number-of-articles-in-thread
3752                        gnus-tmp-new-adopts))))
3753     (if char
3754         (if (> number 1) gnus-not-empty-thread-mark
3755           gnus-empty-thread-mark)
3756       number)))
3757
3758 (defsubst gnus-summary-line-message-size (head)
3759   "Return pretty-printed version of message size.
3760 This function is intended to be used in
3761 `gnus-summary-line-format-alist'."
3762   (let ((c (or (mail-header-chars head) -1)))
3763     (cond ((< c 0) "n/a")               ; chars not available
3764           ((< c (* 1000 10)) (format "%1.1fk" (/ c 1024.0)))
3765           ((< c (* 1000 100)) (format "%dk" (/ c 1024.0)))
3766           ((< c (* 1000 10000)) (format "%1.1fM" (/ c (* 1024.0 1024))))
3767           (t (format "%dM" (/ c (* 1024.0 1024)))))))
3768
3769
3770 (defun gnus-summary-set-local-parameters (group)
3771   "Go through the local params of GROUP and set all variable specs in that list."
3772   (let ((vars '(quit-config)))          ; Ignore quit-config.
3773     (dolist (elem (gnus-group-find-parameter group))
3774       (and (consp elem)                 ; Has to be a cons.
3775            (consp (cdr elem))           ; The cdr has to be a list.
3776            (symbolp (car elem))         ; Has to be a symbol in there.
3777            (not (memq (car elem) vars))
3778            (ignore-errors               ; So we set it.
3779              (push (car elem) vars)
3780              (make-local-variable (car elem))
3781              (set (car elem) (eval (nth 1 elem))))))))
3782
3783 (defun gnus-summary-read-group (group &optional show-all no-article
3784                                       kill-buffer no-display backward
3785                                       select-articles)
3786   "Start reading news in newsgroup GROUP.
3787 If SHOW-ALL is non-nil, already read articles are also listed.
3788 If NO-ARTICLE is non-nil, no article is selected initially.
3789 If NO-DISPLAY, don't generate a summary buffer."
3790   (let (result)
3791     (while (and group
3792                 (null (setq result
3793                             (let ((gnus-auto-select-next nil))
3794                               (or (gnus-summary-read-group-1
3795                                    group show-all no-article
3796                                    kill-buffer no-display
3797                                    select-articles)
3798                                   (setq show-all nil
3799                                         select-articles nil)))))
3800                 (eq gnus-auto-select-next 'quietly))
3801       (set-buffer gnus-group-buffer)
3802       ;; The entry function called above goes to the next
3803       ;; group automatically, so we go two groups back
3804       ;; if we are searching for the previous group.
3805       (when backward
3806         (gnus-group-prev-unread-group 2))
3807       (if (not (equal group (gnus-group-group-name)))
3808           (setq group (gnus-group-group-name))
3809         (setq group nil)))
3810     result))
3811
3812 (defun gnus-summary-read-group-1 (group show-all no-article
3813                                         kill-buffer no-display
3814                                         &optional select-articles)
3815   ;; Killed foreign groups can't be entered.
3816   ;;  (when (and (not (gnus-group-native-p group))
3817   ;;         (not (gnus-gethash group gnus-newsrc-hashtb)))
3818   ;;    (error "Dead non-native groups can't be entered"))
3819   (gnus-message 5 "Retrieving newsgroup: %s..."
3820                 (gnus-group-decoded-name group))
3821   (let* ((new-group (gnus-summary-setup-buffer group))
3822          (quit-config (gnus-group-quit-config group))
3823          (did-select (and new-group (gnus-select-newsgroup
3824                                      group show-all select-articles))))
3825     (cond
3826      ;; This summary buffer exists already, so we just select it.
3827      ((not new-group)
3828       (gnus-set-global-variables)
3829       (when kill-buffer
3830         (gnus-kill-or-deaden-summary kill-buffer))
3831       (gnus-configure-windows 'summary 'force)
3832       (gnus-set-mode-line 'summary)
3833       (gnus-summary-position-point)
3834       (message "")
3835       t)
3836      ;; We couldn't select this group.
3837      ((null did-select)
3838       (when (and (eq major-mode 'gnus-summary-mode)
3839                  (not (equal (current-buffer) kill-buffer)))
3840         (kill-buffer (current-buffer))
3841         (if (not quit-config)
3842             (progn
3843               ;; Update the info -- marks might need to be removed,
3844               ;; for instance.
3845               (gnus-summary-update-info)
3846               (set-buffer gnus-group-buffer)
3847               (gnus-group-jump-to-group group)
3848               (gnus-group-next-unread-group 1))
3849           (gnus-handle-ephemeral-exit quit-config)))
3850       (let ((grpinfo (gnus-get-info group)))
3851         (if (null (gnus-info-read grpinfo))
3852             (gnus-message 3 "Group %s contains no messages"
3853                           (gnus-group-decoded-name group))
3854           (gnus-message 3 "Can't select group")))
3855       nil)
3856      ;; The user did a `C-g' while prompting for number of articles,
3857      ;; so we exit this group.
3858      ((eq did-select 'quit)
3859       (and (eq major-mode 'gnus-summary-mode)
3860            (not (equal (current-buffer) kill-buffer))
3861            (kill-buffer (current-buffer)))
3862       (when kill-buffer
3863         (gnus-kill-or-deaden-summary kill-buffer))
3864       (if (not quit-config)
3865           (progn
3866             (set-buffer gnus-group-buffer)
3867             (gnus-group-jump-to-group group)
3868             (gnus-group-next-unread-group 1)
3869             (gnus-configure-windows 'group 'force))
3870         (gnus-handle-ephemeral-exit quit-config))
3871       ;; Finally signal the quit.
3872       (signal 'quit nil))
3873      ;; The group was successfully selected.
3874      (t
3875       (gnus-set-global-variables)
3876       ;; Save the active value in effect when the group was entered.
3877       (setq gnus-newsgroup-active
3878             (gnus-copy-sequence
3879              (gnus-active gnus-newsgroup-name)))
3880       ;; You can change the summary buffer in some way with this hook.
3881       (gnus-run-hooks 'gnus-select-group-hook)
3882       (when (memq 'summary (gnus-update-format-specifications
3883                             nil 'summary 'summary-mode 'summary-dummy))
3884         ;; The format specification for the summary line was updated,
3885         ;; so we need to update the mark positions as well.
3886         (gnus-update-summary-mark-positions))
3887       ;; Do score processing.
3888       (when gnus-use-scoring
3889         (gnus-possibly-score-headers))
3890       ;; Check whether to fill in the gaps in the threads.
3891       (when gnus-build-sparse-threads
3892         (gnus-build-sparse-threads))
3893       ;; Find the initial limit.
3894       (if show-all
3895           (let ((gnus-newsgroup-dormant nil))
3896             (gnus-summary-initial-limit show-all))
3897         (gnus-summary-initial-limit show-all))
3898       ;; Generate the summary buffer.
3899       (unless no-display
3900         (gnus-summary-prepare))
3901       (when gnus-use-trees
3902         (gnus-tree-open group)
3903         (setq gnus-summary-highlight-line-function
3904               'gnus-tree-highlight-article))
3905       ;; If the summary buffer is empty, but there are some low-scored
3906       ;; articles or some excluded dormants, we include these in the
3907       ;; buffer.
3908       (when (and (zerop (buffer-size))
3909                  (not no-display))
3910         (cond (gnus-newsgroup-dormant
3911                (gnus-summary-limit-include-dormant))
3912               ((and gnus-newsgroup-scored show-all)
3913                (gnus-summary-limit-include-expunged t))))
3914       ;; Function `gnus-apply-kill-file' must be called in this hook.
3915       (gnus-run-hooks 'gnus-apply-kill-hook)
3916       (if (and (zerop (buffer-size))
3917                (not no-display))
3918           (progn
3919             ;; This newsgroup is empty.
3920             (gnus-summary-catchup-and-exit nil t)
3921             (gnus-message 6 "No unread news")
3922             (when kill-buffer
3923               (gnus-kill-or-deaden-summary kill-buffer))
3924             ;; Return nil from this function.
3925             nil)
3926         ;; Hide conversation thread subtrees.  We cannot do this in
3927         ;; gnus-summary-prepare-hook since kill processing may not
3928         ;; work with hidden articles.
3929         (gnus-summary-maybe-hide-threads)
3930         (when kill-buffer
3931           (gnus-kill-or-deaden-summary kill-buffer))
3932         (gnus-summary-auto-select-subject)
3933         ;; Show first unread article if requested.
3934         (if (and (not no-article)
3935                  (not no-display)
3936                  gnus-newsgroup-unreads
3937                  gnus-auto-select-first)
3938             (progn
3939               (gnus-configure-windows 'summary)
3940               (let ((art (gnus-summary-article-number)))
3941                 (unless (and (not gnus-plugged)
3942                              (or (memq art gnus-newsgroup-undownloaded)
3943                                  (memq art gnus-newsgroup-downloadable)))
3944                   (gnus-summary-goto-article art))))
3945           ;; Don't select any articles.
3946           (gnus-summary-position-point)
3947           (gnus-configure-windows 'summary 'force)
3948           (gnus-set-mode-line 'summary))
3949         (when (and gnus-auto-center-group
3950                    (get-buffer-window gnus-group-buffer t))
3951           ;; Gotta use windows, because recenter does weird stuff if
3952           ;; the current buffer ain't the displayed window.
3953           (let ((owin (selected-window)))
3954             (select-window (get-buffer-window gnus-group-buffer t))
3955             (when (gnus-group-goto-group group)
3956               (recenter))
3957             (select-window owin)))
3958         ;; Mark this buffer as "prepared".
3959         (setq gnus-newsgroup-prepared t)
3960         (gnus-run-hooks 'gnus-summary-prepared-hook)
3961         (unless (gnus-ephemeral-group-p group)
3962           (gnus-group-update-group group))
3963         t)))))
3964
3965 (defun gnus-summary-auto-select-subject ()
3966   "Select the subject line on initial group entry."
3967   (goto-char (point-min))
3968   (cond
3969    ((eq gnus-auto-select-subject 'best)
3970     (gnus-summary-best-unread-subject))
3971    ((eq gnus-auto-select-subject 'unread)
3972     (gnus-summary-first-unread-subject))
3973    ((eq gnus-auto-select-subject 'unseen)
3974     (gnus-summary-first-unseen-subject))
3975    ((eq gnus-auto-select-subject 'unseen-or-unread)
3976     (gnus-summary-first-unseen-or-unread-subject))
3977    ((eq gnus-auto-select-subject 'first)
3978     ;; Do nothing.
3979     )
3980    ((functionp gnus-auto-select-subject)
3981     (funcall gnus-auto-select-subject))))
3982
3983 (defun gnus-summary-prepare ()
3984   "Generate the summary buffer."
3985   (interactive)
3986   (let ((buffer-read-only nil))
3987     (erase-buffer)
3988     (setq gnus-newsgroup-data nil
3989           gnus-newsgroup-data-reverse nil)
3990     (gnus-run-hooks 'gnus-summary-generate-hook)
3991     ;; Generate the buffer, either with threads or without.
3992     (when gnus-newsgroup-headers
3993       (gnus-summary-prepare-threads
3994        (if gnus-show-threads
3995            (gnus-sort-gathered-threads
3996             (funcall gnus-summary-thread-gathering-function
3997                      (gnus-sort-threads
3998                       (gnus-cut-threads (gnus-make-threads)))))
3999          ;; Unthreaded display.
4000          (gnus-sort-articles gnus-newsgroup-headers))))
4001     (setq gnus-newsgroup-data (nreverse gnus-newsgroup-data))
4002     ;; Call hooks for modifying summary buffer.
4003     (goto-char (point-min))
4004     (gnus-run-hooks 'gnus-summary-prepare-hook)))
4005
4006 (defsubst gnus-general-simplify-subject (subject)
4007   "Simplify subject by the same rules as `gnus-gather-threads-by-subject'."
4008   (setq subject
4009         (cond
4010          ;; Truncate the subject.
4011          (gnus-simplify-subject-functions
4012           (gnus-map-function gnus-simplify-subject-functions subject))
4013          ((numberp gnus-summary-gather-subject-limit)
4014           (setq subject (gnus-simplify-subject-re subject))
4015           (if (> (length subject) gnus-summary-gather-subject-limit)
4016               (substring subject 0 gnus-summary-gather-subject-limit)
4017             subject))
4018          ;; Fuzzily simplify it.
4019          ((eq 'fuzzy gnus-summary-gather-subject-limit)
4020           (gnus-simplify-subject-fuzzy subject))
4021          ;; Just remove the leading "Re:".
4022          (t
4023           (gnus-simplify-subject-re subject))))
4024
4025   (if (and gnus-summary-gather-exclude-subject
4026            (string-match gnus-summary-gather-exclude-subject subject))
4027       nil                         ; This article shouldn't be gathered
4028     subject))
4029
4030 (defun gnus-summary-simplify-subject-query ()
4031   "Query where the respool algorithm would put this article."
4032   (interactive)
4033   (gnus-summary-select-article)
4034   (message "%s" (gnus-general-simplify-subject (gnus-summary-article-subject))))
4035
4036 (defun gnus-gather-threads-by-subject (threads)
4037   "Gather threads by looking at Subject headers."
4038   (if (not gnus-summary-make-false-root)
4039       threads
4040     (let ((hashtb (gnus-make-hashtable 1024))
4041           (prev threads)
4042           (result threads)
4043           subject hthread whole-subject)
4044       (while threads
4045         (setq subject (gnus-general-simplify-subject
4046                        (setq whole-subject (mail-header-subject
4047                                             (caar threads)))))
4048         (when subject
4049           (if (setq hthread (gnus-gethash subject hashtb))
4050               (progn
4051                 ;; We enter a dummy root into the thread, if we
4052                 ;; haven't done that already.
4053                 (unless (stringp (caar hthread))
4054                   (setcar hthread (list whole-subject (car hthread))))
4055                 ;; We add this new gathered thread to this gathered
4056                 ;; thread.
4057                 (setcdr (car hthread)
4058                         (nconc (cdar hthread) (list (car threads))))
4059                 ;; Remove it from the list of threads.
4060                 (setcdr prev (cdr threads))
4061                 (setq threads prev))
4062             ;; Enter this thread into the hash table.
4063             (gnus-sethash subject
4064                           (if gnus-summary-make-false-root-always
4065                               (progn
4066                                 ;; If you want a dummy root above all
4067                                 ;; threads...
4068                                 (setcar threads (list whole-subject
4069                                                       (car threads)))
4070                                 threads)
4071                             threads)
4072                           hashtb)))
4073         (setq prev threads)
4074         (setq threads (cdr threads)))
4075       result)))
4076
4077 (defun gnus-gather-threads-by-references (threads)
4078   "Gather threads by looking at References headers."
4079   (let ((idhashtb (gnus-make-hashtable 1024))
4080         (thhashtb (gnus-make-hashtable 1024))
4081         (prev threads)
4082         (result threads)
4083         ids references id gthread gid entered ref)
4084     (while threads
4085       (when (setq references (mail-header-references (caar threads)))
4086         (setq id (mail-header-id (caar threads))
4087               ids (inline (gnus-split-references references))
4088               entered nil)
4089         (while (setq ref (pop ids))
4090           (setq ids (delete ref ids))
4091           (if (not (setq gid (gnus-gethash ref idhashtb)))
4092               (progn
4093                 (gnus-sethash ref id idhashtb)
4094                 (gnus-sethash id threads thhashtb))
4095             (setq gthread (gnus-gethash gid thhashtb))
4096             (unless entered
4097               ;; We enter a dummy root into the thread, if we
4098               ;; haven't done that already.
4099               (unless (stringp (caar gthread))
4100                 (setcar gthread (list (mail-header-subject (caar gthread))
4101                                       (car gthread))))
4102               ;; We add this new gathered thread to this gathered
4103               ;; thread.
4104               (setcdr (car gthread)
4105                       (nconc (cdar gthread) (list (car threads)))))
4106             ;; Add it into the thread hash table.
4107             (gnus-sethash id gthread thhashtb)
4108             (setq entered t)
4109             ;; Remove it from the list of threads.
4110             (setcdr prev (cdr threads))
4111             (setq threads prev))))
4112       (setq prev threads)
4113       (setq threads (cdr threads)))
4114     result))
4115
4116 (defun gnus-sort-gathered-threads (threads)
4117   "Sort subtreads inside each gathered thread by `gnus-sort-gathered-threads-function'."
4118   (let ((result threads))
4119     (while threads
4120       (when (stringp (caar threads))
4121         (setcdr (car threads)
4122                 (sort (cdar threads) gnus-sort-gathered-threads-function)))
4123       (setq threads (cdr threads)))
4124     result))
4125
4126 (defun gnus-thread-loop-p (root thread)
4127   "Say whether ROOT is in THREAD."
4128   (let ((stack (list thread))
4129         (infloop 0)
4130         th)
4131     (while (setq thread (pop stack))
4132       (setq th (cdr thread))
4133       (while (and th
4134                   (not (eq (caar th) root)))
4135         (pop th))
4136       (if th
4137           ;; We have found a loop.
4138           (let (ref-dep)
4139             (setcdr thread (delq (car th) (cdr thread)))
4140             (if (boundp (setq ref-dep (intern "none"
4141                                               gnus-newsgroup-dependencies)))
4142                 (setcdr (symbol-value ref-dep)
4143                         (nconc (cdr (symbol-value ref-dep))
4144                                (list (car th))))
4145               (set ref-dep (list nil (car th))))
4146             (setq infloop 1
4147                   stack nil))
4148         ;; Push all the subthreads onto the stack.
4149         (push (cdr thread) stack)))
4150     infloop))
4151
4152 (defun gnus-make-threads ()
4153   "Go through the dependency hashtb and find the roots.  Return all threads."
4154   (let (threads)
4155     (while (catch 'infloop
4156              (mapatoms
4157               (lambda (refs)
4158                 ;; Deal with self-referencing References loops.
4159                 (when (and (car (symbol-value refs))
4160                            (not (zerop
4161                                  (apply
4162                                   '+
4163                                   (mapcar
4164                                    (lambda (thread)
4165                                      (gnus-thread-loop-p
4166                                       (car (symbol-value refs)) thread))
4167                                    (cdr (symbol-value refs)))))))
4168                   (setq threads nil)
4169                   (throw 'infloop t))
4170                 (unless (car (symbol-value refs))
4171                   ;; These threads do not refer back to any other
4172                   ;; articles, so they're roots.
4173                   (setq threads (append (cdr (symbol-value refs)) threads))))
4174               gnus-newsgroup-dependencies)))
4175     threads))
4176
4177 ;; Build the thread tree.
4178 (defsubst gnus-dependencies-add-header (header dependencies force-new)
4179   "Enter HEADER into the DEPENDENCIES table if it is not already there.
4180
4181 If FORCE-NEW is not nil, enter HEADER into the DEPENDENCIES table even
4182 if it was already present.
4183
4184 If `gnus-summary-ignore-duplicates' is nil then duplicate Message-IDs
4185 will not be entered in the DEPENDENCIES table.  Otherwise duplicate
4186 Message-IDs will be renamed to a unique Message-ID before being
4187 entered.
4188
4189 Returns HEADER if it was entered in the DEPENDENCIES.  Returns nil otherwise."
4190   (let* ((id (mail-header-id header))
4191          (id-dep (and id (intern id dependencies)))
4192          parent-id ref ref-dep ref-header replaced)
4193     ;; Enter this `header' in the `dependencies' table.
4194     (cond
4195      ((not id-dep)
4196       (setq header nil))
4197      ;; The first two cases do the normal part: enter a new `header'
4198      ;; in the `dependencies' table.
4199      ((not (boundp id-dep))
4200       (set id-dep (list header)))
4201      ((null (car (symbol-value id-dep)))
4202       (setcar (symbol-value id-dep) header))
4203
4204      ;; From here the `header' was already present in the
4205      ;; `dependencies' table.
4206      (force-new
4207       ;; Overrides an existing entry;
4208       ;; just set the header part of the entry.
4209       (setcar (symbol-value id-dep) header)
4210       (setq replaced t))
4211
4212      ;; Renames the existing `header' to a unique Message-ID.
4213      ((not gnus-summary-ignore-duplicates)
4214       ;; An article with this Message-ID has already been seen.
4215       ;; We rename the Message-ID.
4216       (set (setq id-dep (intern (setq id (nnmail-message-id)) dependencies))
4217            (list header))
4218       (mail-header-set-id header id))
4219
4220      ;; The last case ignores an existing entry, except it adds any
4221      ;; additional Xrefs (in case the two articles came from different
4222      ;; servers.
4223      ;; Also sets `header' to `nil' meaning that the `dependencies'
4224      ;; table was *not* modified.
4225      (t
4226       (mail-header-set-xref
4227        (car (symbol-value id-dep))
4228        (concat (or (mail-header-xref (car (symbol-value id-dep)))
4229                    "")
4230                (or (mail-header-xref header) "")))
4231       (setq header nil)))
4232
4233     (when (and header (not replaced))
4234       ;; First check that we are not creating a References loop.
4235       (setq parent-id (gnus-parent-id (mail-header-references header)))
4236       (setq ref parent-id)
4237       (while (and ref
4238                   (setq ref-dep (intern-soft ref dependencies))
4239                   (boundp ref-dep)
4240                   (setq ref-header (car (symbol-value ref-dep))))
4241         (if (string= id ref)
4242             ;; Yuk!  This is a reference loop.  Make the article be a
4243             ;; root article.
4244             (progn
4245               (mail-header-set-references (car (symbol-value id-dep)) "none")
4246               (setq ref nil)
4247               (setq parent-id nil))
4248           (setq ref (gnus-parent-id (mail-header-references ref-header)))))
4249       (setq ref-dep (intern (or parent-id "none") dependencies))
4250       (if (boundp ref-dep)
4251           (setcdr (symbol-value ref-dep)
4252                   (nconc (cdr (symbol-value ref-dep))
4253                          (list (symbol-value id-dep))))
4254         (set ref-dep (list nil (symbol-value id-dep)))))
4255     header))
4256
4257 (defun gnus-extract-message-id-from-in-reply-to (string)
4258   (if (string-match "<[^>]+>" string)
4259       (substring string (match-beginning 0) (match-end 0))
4260     nil))
4261
4262 (defun gnus-build-sparse-threads ()
4263   (let ((headers gnus-newsgroup-headers)
4264         (mail-parse-charset gnus-newsgroup-charset)
4265         (gnus-summary-ignore-duplicates t)
4266         header references generation relations
4267         subject child end new-child date)
4268     ;; First we create an alist of generations/relations, where
4269     ;; generations is how much we trust the relation, and the relation
4270     ;; is parent/child.
4271     (gnus-message 7 "Making sparse threads...")
4272     (save-excursion
4273       (nnheader-set-temp-buffer " *gnus sparse threads*")
4274       (while (setq header (pop headers))
4275         (when (and (setq references (mail-header-references header))
4276                    (not (string= references "")))
4277           (insert references)
4278           (setq child (mail-header-id header)
4279                 subject (mail-header-subject header)
4280                 date (mail-header-date header)
4281                 generation 0)
4282           (while (search-backward ">" nil t)
4283             (setq end (1+ (point)))
4284             (when (search-backward "<" nil t)
4285               (setq new-child (buffer-substring (point) end))
4286               (push (list (incf generation)
4287                           child (setq child new-child)
4288                           subject date)
4289                     relations)))
4290           (when child
4291             (push (list (1+ generation) child nil subject) relations))
4292           (erase-buffer)))
4293       (kill-buffer (current-buffer)))
4294     ;; Sort over trustworthiness.
4295     (dolist (relation (sort relations 'car-less-than-car))
4296       (when (gnus-dependencies-add-header
4297              (make-full-mail-header
4298               gnus-reffed-article-number
4299               (nth 3 relation) "" (or (nth 4 relation) "")
4300               (nth 1 relation)
4301               (or (nth 2 relation) "") 0 0 "")
4302              gnus-newsgroup-dependencies nil)
4303         (push gnus-reffed-article-number gnus-newsgroup-limit)
4304         (push gnus-reffed-article-number gnus-newsgroup-sparse)
4305         (push (cons gnus-reffed-article-number gnus-sparse-mark)
4306               gnus-newsgroup-reads)
4307         (decf gnus-reffed-article-number)))
4308     (gnus-message 7 "Making sparse threads...done")))
4309
4310 (defun gnus-build-old-threads ()
4311   ;; Look at all the articles that refer back to old articles, and
4312   ;; fetch the headers for the articles that aren't there.  This will
4313   ;; build complete threads - if the roots haven't been expired by the
4314   ;; server, that is.
4315   (let ((mail-parse-charset gnus-newsgroup-charset)
4316         id heads)
4317     (mapatoms
4318      (lambda (refs)
4319        (when (not (car (symbol-value refs)))
4320          (setq heads (cdr (symbol-value refs)))
4321          (while heads
4322            (if (memq (mail-header-number (caar heads))
4323                      gnus-newsgroup-dormant)
4324                (setq heads (cdr heads))
4325              (setq id (symbol-name refs))
4326              (while (and (setq id (gnus-build-get-header id))
4327                          (not (car (gnus-id-to-thread id)))))
4328              (setq heads nil)))))
4329      gnus-newsgroup-dependencies)))
4330
4331 (defsubst gnus-remove-odd-characters (string)
4332   "Translate STRING into something that doesn't contain weird characters."
4333   (mm-subst-char-in-string
4334    ?\r ?\-
4335    (mm-subst-char-in-string ?\n ?\- string t) t))
4336
4337 ;; This function has to be called with point after the article number
4338 ;; on the beginning of the line.
4339 (defsubst gnus-nov-parse-line (number dependencies &optional force-new)
4340   (let ((eol (point-at-eol))
4341         (buffer (current-buffer))
4342         header references in-reply-to)
4343
4344     ;; overview: [num subject from date id refs chars lines misc]
4345     (unwind-protect
4346         (let (x)
4347           (narrow-to-region (point) eol)
4348           (unless (eobp)
4349             (forward-char))
4350
4351           (setq header
4352                 (make-full-mail-header
4353                  number                 ; number
4354                  (condition-case ()     ; subject
4355                      (gnus-remove-odd-characters
4356                       (funcall gnus-decode-encoded-word-function
4357                                (setq x (nnheader-nov-field))))
4358                    (error x))
4359                  (condition-case ()     ; from
4360                      (gnus-remove-odd-characters
4361                       (funcall gnus-decode-encoded-address-function
4362                                (setq x (nnheader-nov-field))))
4363                    (error x))
4364                  (nnheader-nov-field)   ; date
4365                  (nnheader-nov-read-message-id number)  ; id
4366                  (setq references (nnheader-nov-field)) ; refs
4367                  (nnheader-nov-read-integer) ; chars
4368                  (nnheader-nov-read-integer) ; lines
4369                  (unless (eobp)
4370                    (if (looking-at "Xref: ")
4371                        (goto-char (match-end 0)))
4372                    (nnheader-nov-field)) ; Xref
4373                  (nnheader-nov-parse-extra)))) ; extra
4374
4375       (widen))
4376
4377     (when (and (strin