(subscribed): New group parameter.
[gnus] / lisp / gnus.el
1 ;;; gnus.el --- a newsreader for GNU Emacs
2
3 ;; Copyright (C) 1987, 1988, 1989, 1990, 1993, 1994, 1995, 1996, 1997,
4 ;; 1998, 2000, 2001, 2002 Free Software Foundation, Inc.
5
6 ;; Author: Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>
7 ;;      Lars Magne Ingebrigtsen <larsi@gnus.org>
8 ;; Keywords: news, mail
9
10 ;; This file is part of GNU Emacs.
11
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; any later version.
16
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20 ;; GNU General Public License for more details.
21
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
25 ;; Boston, MA 02111-1307, USA.
26
27 ;;; Commentary:
28
29 ;;; Code:
30
31 (eval '(run-hooks 'gnus-load-hook))
32
33 (eval-when-compile (require 'cl))
34 (require 'wid-edit)
35 (require 'mm-util)
36
37 (defgroup gnus nil
38   "The coffee-brewing, all singing, all dancing, kitchen sink newsreader."
39   :group 'news
40   :group 'mail)
41
42 (defgroup gnus-format nil
43   "Dealing with formatting issues."
44   :group 'news
45   :group 'mail)
46
47 (defgroup gnus-charset nil
48   "Group character set issues."
49   :link '(custom-manual "(gnus)Charsets")
50   :version "21.1"
51   :group 'gnus)
52
53 (defgroup gnus-cache nil
54   "Cache interface."
55   :group 'gnus)
56
57 (defgroup gnus-start nil
58   "Starting your favorite newsreader."
59   :group 'gnus)
60
61 (defgroup gnus-start-server nil
62   "Server options at startup."
63   :group 'gnus-start)
64
65 ;; These belong to gnus-group.el.
66 (defgroup gnus-group nil
67   "Group buffers."
68   :link '(custom-manual "(gnus)The Group Buffer")
69   :group 'gnus)
70
71 (defgroup gnus-group-foreign nil
72   "Foreign groups."
73   :link '(custom-manual "(gnus)Foreign Groups")
74   :group 'gnus-group)
75
76 (defgroup gnus-group-new nil
77   "Automatic subscription of new groups."
78   :group 'gnus-group)
79
80 (defgroup gnus-group-levels nil
81   "Group levels."
82   :link '(custom-manual "(gnus)Group Levels")
83   :group 'gnus-group)
84
85 (defgroup gnus-group-select nil
86   "Selecting a Group."
87   :link '(custom-manual "(gnus)Selecting a Group")
88   :group 'gnus-group)
89
90 (defgroup gnus-group-listing nil
91   "Showing slices of the group list."
92   :link '(custom-manual "(gnus)Listing Groups")
93   :group 'gnus-group)
94
95 (defgroup gnus-group-visual nil
96   "Sorting the group buffer."
97   :link '(custom-manual "(gnus)Group Buffer Format")
98   :group 'gnus-group
99   :group 'gnus-visual)
100
101 (defgroup gnus-group-various nil
102   "Various group options."
103   :link '(custom-manual "(gnus)Scanning New Messages")
104   :group 'gnus-group)
105
106 ;; These belong to gnus-sum.el.
107 (defgroup gnus-summary nil
108   "Summary buffers."
109   :link '(custom-manual "(gnus)The Summary Buffer")
110   :group 'gnus)
111
112 (defgroup gnus-summary-exit nil
113   "Leaving summary buffers."
114   :link '(custom-manual "(gnus)Exiting the Summary Buffer")
115   :group 'gnus-summary)
116
117 (defgroup gnus-summary-marks nil
118   "Marks used in summary buffers."
119   :link '(custom-manual "(gnus)Marking Articles")
120   :group 'gnus-summary)
121
122 (defgroup gnus-thread nil
123   "Ordering articles according to replies."
124   :link '(custom-manual "(gnus)Threading")
125   :group 'gnus-summary)
126
127 (defgroup gnus-summary-format nil
128   "Formatting of the summary buffer."
129   :link '(custom-manual "(gnus)Summary Buffer Format")
130   :group 'gnus-summary)
131
132 (defgroup gnus-summary-choose nil
133   "Choosing Articles."
134   :link '(custom-manual "(gnus)Choosing Articles")
135   :group 'gnus-summary)
136
137 (defgroup gnus-summary-maneuvering nil
138   "Summary movement commands."
139   :link '(custom-manual "(gnus)Summary Maneuvering")
140   :group 'gnus-summary)
141
142 (defgroup gnus-picon nil
143   "Show pictures of people, domains, and newsgroups."
144   :group 'gnus-visual)
145
146 (defgroup gnus-summary-mail nil
147   "Mail group commands."
148   :link '(custom-manual "(gnus)Mail Group Commands")
149   :group 'gnus-summary)
150
151 (defgroup gnus-summary-sort nil
152   "Sorting the summary buffer."
153   :link '(custom-manual "(gnus)Sorting")
154   :group 'gnus-summary)
155
156 (defgroup gnus-summary-visual nil
157   "Highlighting and menus in the summary buffer."
158   :link '(custom-manual "(gnus)Summary Highlighting")
159   :group 'gnus-visual
160   :group 'gnus-summary)
161
162 (defgroup gnus-summary-various nil
163   "Various summary buffer options."
164   :link '(custom-manual "(gnus)Various Summary Stuff")
165   :group 'gnus-summary)
166
167 (defgroup gnus-summary-pick nil
168   "Pick mode in the summary buffer."
169   :link '(custom-manual "(gnus)Pick and Read")
170   :prefix "gnus-pick-"
171   :group 'gnus-summary)
172
173 (defgroup gnus-summary-tree nil
174   "Tree display of threads in the summary buffer."
175   :link '(custom-manual "(gnus)Tree Display")
176   :prefix "gnus-tree-"
177   :group 'gnus-summary)
178
179 ;; Belongs to gnus-uu.el
180 (defgroup gnus-extract-view nil
181   "Viewing extracted files."
182   :link '(custom-manual "(gnus)Viewing Files")
183   :group 'gnus-extract)
184
185 ;; Belongs to gnus-score.el
186 (defgroup gnus-score nil
187   "Score and kill file handling."
188   :group 'gnus)
189
190 (defgroup gnus-score-kill nil
191   "Kill files."
192   :group 'gnus-score)
193
194 (defgroup gnus-score-adapt nil
195   "Adaptive score files."
196   :group 'gnus-score)
197
198 (defgroup gnus-score-default nil
199   "Default values for score files."
200   :group 'gnus-score)
201
202 (defgroup gnus-score-expire nil
203   "Expiring score rules."
204   :group 'gnus-score)
205
206 (defgroup gnus-score-decay nil
207   "Decaying score rules."
208   :group 'gnus-score)
209
210 (defgroup gnus-score-files nil
211   "Score and kill file names."
212   :group 'gnus-score
213   :group 'gnus-files)
214
215 (defgroup gnus-score-various nil
216   "Various scoring and killing options."
217   :group 'gnus-score)
218
219 ;; Other
220 (defgroup gnus-visual nil
221   "Options controling the visual fluff."
222   :group 'gnus
223   :group 'faces)
224
225 (defgroup gnus-agent nil
226   "Offline support for Gnus."
227   :group 'gnus)
228
229 (defgroup gnus-files nil
230   "Files used by Gnus."
231   :group 'gnus)
232
233 (defgroup gnus-dribble-file nil
234   "Auto save file."
235   :link '(custom-manual "(gnus)Auto Save")
236   :group 'gnus-files)
237
238 (defgroup gnus-newsrc nil
239   "Storing Gnus state."
240   :group 'gnus-files)
241
242 (defgroup gnus-server nil
243   "Options related to newsservers and other servers used by Gnus."
244   :group 'gnus)
245
246 (defgroup gnus-server-visual nil
247   "Highlighting and menus in the server buffer."
248   :group 'gnus-visual
249   :group 'gnus-server)
250
251 (defgroup gnus-message '((message custom-group))
252   "Composing replies and followups in Gnus."
253   :group 'gnus)
254
255 (defgroup gnus-meta nil
256   "Meta variables controling major portions of Gnus.
257 In general, modifying these variables does not take affect until Gnus
258 is restarted, and sometimes reloaded."
259   :group 'gnus)
260
261 (defgroup gnus-various nil
262   "Other Gnus options."
263   :link '(custom-manual "(gnus)Various Various")
264   :group 'gnus)
265
266 (defgroup gnus-mime nil
267   "Variables for controlling the Gnus MIME interface."
268   :group 'gnus)
269
270 (defgroup gnus-exit nil
271   "Exiting gnus."
272   :link '(custom-manual "(gnus)Exiting Gnus")
273   :group 'gnus)
274
275 (defgroup gnus-fun nil
276   "Frivolous Gnus extensions."
277   :link '(custom-manual "(gnus)Exiting Gnus")
278   :group 'gnus)
279
280 (defconst gnus-version-number "0.07"
281   "Version number for this version of Gnus.")
282
283 (defconst gnus-version (format "Oort Gnus v%s" gnus-version-number)
284   "Version string for this version of Gnus.")
285
286 (defcustom gnus-inhibit-startup-message nil
287   "If non-nil, the startup message will not be displayed.
288 This variable is used before `.gnus.el' is loaded, so it should
289 be set in `.emacs' instead."
290   :group 'gnus-start
291   :type 'boolean)
292
293 (defcustom gnus-play-startup-jingle nil
294   "If non-nil, play the Gnus jingle at startup."
295   :group 'gnus-start
296   :type 'boolean)
297
298 (unless (fboundp 'gnus-group-remove-excess-properties)
299   (defalias 'gnus-group-remove-excess-properties 'ignore))
300
301 (unless (fboundp 'gnus-set-text-properties)
302   (defalias 'gnus-set-text-properties 'set-text-properties))
303
304 (unless (featurep 'gnus-xmas)
305   (defalias 'gnus-make-overlay 'make-overlay)
306   (defalias 'gnus-delete-overlay 'delete-overlay)
307   (defalias 'gnus-overlay-put 'overlay-put)
308   (defalias 'gnus-move-overlay 'move-overlay)
309   (defalias 'gnus-overlay-buffer 'overlay-buffer)
310   (defalias 'gnus-overlay-start 'overlay-start)
311   (defalias 'gnus-overlay-end 'overlay-end)
312   (defalias 'gnus-extent-detached-p 'ignore)
313   (defalias 'gnus-extent-start-open 'ignore)
314   (defalias 'gnus-appt-select-lowest-window 'appt-select-lowest-window)
315   (defalias 'gnus-mail-strip-quoted-names 'mail-strip-quoted-names)
316   (defalias 'gnus-character-to-event 'identity)
317   (defalias 'gnus-add-text-properties 'add-text-properties)
318   (defalias 'gnus-put-text-property 'put-text-property)
319   (defvar gnus-mode-line-image-cache t)
320   (if (fboundp 'find-image)
321       (defun gnus-mode-line-buffer-identification (line)
322         (let ((str (car-safe line)))
323           (if (and (stringp str)
324                    (string-match "^Gnus:" str))
325               (progn (add-text-properties
326                       0 5
327                       (list 'display
328                             (if (eq t gnus-mode-line-image-cache)
329                                 (setq gnus-mode-line-image-cache
330                                       (find-image
331                                        '((:type xpm :file "gnus-pointer.xpm"
332                                                 :ascent center)
333                                          (:type xbm :file "gnus-pointer.xbm"
334                                                 :ascent center))))
335                               gnus-mode-line-image-cache)
336                             'help-echo "This is Gnus")
337                       str)
338                      (list str))
339             line)))
340     (defalias 'gnus-mode-line-buffer-identification 'identity))
341   (defalias 'gnus-characterp 'numberp)
342   (defalias 'gnus-deactivate-mark 'deactivate-mark)
343   (defalias 'gnus-window-edges 'window-edges)
344   (defalias 'gnus-key-press-event-p 'numberp)
345   ;;(defalias 'gnus-decode-rfc1522 'ignore)
346   )
347
348 ;; We define these group faces here to avoid the display
349 ;; update forced when creating new faces.
350
351 (defface gnus-group-news-1-face
352   '((((class color)
353       (background dark))
354      (:foreground "PaleTurquoise" :bold t))
355     (((class color)
356       (background light))
357      (:foreground "ForestGreen" :bold t))
358     (t
359      ()))
360   "Level 1 newsgroup face.")
361
362 (defface gnus-group-news-1-empty-face
363   '((((class color)
364       (background dark))
365      (:foreground "PaleTurquoise"))
366     (((class color)
367       (background light))
368      (:foreground "ForestGreen"))
369     (t
370      ()))
371   "Level 1 empty newsgroup face.")
372
373 (defface gnus-group-news-2-face
374   '((((class color)
375       (background dark))
376      (:foreground "turquoise" :bold t))
377     (((class color)
378       (background light))
379      (:foreground "CadetBlue4" :bold t))
380     (t
381      ()))
382   "Level 2 newsgroup face.")
383
384 (defface gnus-group-news-2-empty-face
385   '((((class color)
386       (background dark))
387      (:foreground "turquoise"))
388     (((class color)
389       (background light))
390      (:foreground "CadetBlue4"))
391     (t
392      ()))
393   "Level 2 empty newsgroup face.")
394
395 (defface gnus-group-news-3-face
396   '((((class color)
397       (background dark))
398      (:bold t))
399     (((class color)
400       (background light))
401      (:bold t))
402     (t
403      ()))
404   "Level 3 newsgroup face.")
405
406 (defface gnus-group-news-3-empty-face
407   '((((class color)
408       (background dark))
409      ())
410     (((class color)
411       (background light))
412      ())
413     (t
414      ()))
415   "Level 3 empty newsgroup face.")
416
417 (defface gnus-group-news-4-face
418   '((((class color)
419       (background dark))
420      (:bold t))
421     (((class color)
422       (background light))
423      (:bold t))
424     (t
425      ()))
426   "Level 4 newsgroup face.")
427
428 (defface gnus-group-news-4-empty-face
429   '((((class color)
430       (background dark))
431      ())
432     (((class color)
433       (background light))
434      ())
435     (t
436      ()))
437   "Level 4 empty newsgroup face.")
438
439 (defface gnus-group-news-5-face
440   '((((class color)
441       (background dark))
442      (:bold t))
443     (((class color)
444       (background light))
445      (:bold t))
446     (t
447      ()))
448   "Level 5 newsgroup face.")
449
450 (defface gnus-group-news-5-empty-face
451   '((((class color)
452       (background dark))
453      ())
454     (((class color)
455       (background light))
456      ())
457     (t
458      ()))
459   "Level 5 empty newsgroup face.")
460
461 (defface gnus-group-news-6-face
462   '((((class color)
463       (background dark))
464      (:bold t))
465     (((class color)
466       (background light))
467      (:bold t))
468     (t
469      ()))
470   "Level 6 newsgroup face.")
471
472 (defface gnus-group-news-6-empty-face
473   '((((class color)
474       (background dark))
475      ())
476     (((class color)
477       (background light))
478      ())
479     (t
480      ()))
481   "Level 6 empty newsgroup face.")
482
483 (defface gnus-group-news-low-face
484   '((((class color)
485       (background dark))
486      (:foreground "DarkTurquoise" :bold t))
487     (((class color)
488       (background light))
489      (:foreground "DarkGreen" :bold t))
490     (t
491      ()))
492   "Low level newsgroup face.")
493
494 (defface gnus-group-news-low-empty-face
495   '((((class color)
496       (background dark))
497      (:foreground "DarkTurquoise"))
498     (((class color)
499       (background light))
500      (:foreground "DarkGreen"))
501     (t
502      ()))
503   "Low level empty newsgroup face.")
504
505 (defface gnus-group-mail-1-face
506   '((((class color)
507       (background dark))
508      (:foreground "aquamarine1" :bold t))
509     (((class color)
510       (background light))
511      (:foreground "DeepPink3" :bold t))
512     (t
513      (:bold t)))
514   "Level 1 mailgroup face.")
515
516 (defface gnus-group-mail-1-empty-face
517   '((((class color)
518       (background dark))
519      (:foreground "aquamarine1"))
520     (((class color)
521       (background light))
522      (:foreground "DeepPink3"))
523     (t
524      (:italic t :bold t)))
525   "Level 1 empty mailgroup face.")
526
527 (defface gnus-group-mail-2-face
528   '((((class color)
529       (background dark))
530      (:foreground "aquamarine2" :bold t))
531     (((class color)
532       (background light))
533      (:foreground "HotPink3" :bold t))
534     (t
535      (:bold t)))
536   "Level 2 mailgroup face.")
537
538 (defface gnus-group-mail-2-empty-face
539   '((((class color)
540       (background dark))
541      (:foreground "aquamarine2"))
542     (((class color)
543       (background light))
544      (:foreground "HotPink3"))
545     (t
546      (:bold t)))
547   "Level 2 empty mailgroup face.")
548
549 (defface gnus-group-mail-3-face
550   '((((class color)
551       (background dark))
552      (:foreground "aquamarine3" :bold t))
553     (((class color)
554       (background light))
555      (:foreground "magenta4" :bold t))
556     (t
557      (:bold t)))
558   "Level 3 mailgroup face.")
559
560 (defface gnus-group-mail-3-empty-face
561   '((((class color)
562       (background dark))
563      (:foreground "aquamarine3"))
564     (((class color)
565       (background light))
566      (:foreground "magenta4"))
567     (t
568      ()))
569   "Level 3 empty mailgroup face.")
570
571 (defface gnus-group-mail-low-face
572   '((((class color)
573       (background dark))
574      (:foreground "aquamarine4" :bold t))
575     (((class color)
576       (background light))
577      (:foreground "DeepPink4" :bold t))
578     (t
579      (:bold t)))
580   "Low level mailgroup face.")
581
582 (defface gnus-group-mail-low-empty-face
583   '((((class color)
584       (background dark))
585      (:foreground "aquamarine4"))
586     (((class color)
587       (background light))
588      (:foreground "DeepPink4"))
589     (t
590      (:bold t)))
591   "Low level empty mailgroup face.")
592
593 ;; Summary mode faces.
594
595 (defface gnus-summary-selected-face '((t
596                                        (:underline t)))
597   "Face used for selected articles.")
598
599 (defface gnus-summary-cancelled-face
600   '((((class color))
601      (:foreground "yellow" :background "black")))
602   "Face used for cancelled articles.")
603
604 (defface gnus-summary-high-ticked-face
605   '((((class color)
606       (background dark))
607      (:foreground "pink" :bold t))
608     (((class color)
609       (background light))
610      (:foreground "firebrick" :bold t))
611     (t
612      (:bold t)))
613   "Face used for high interest ticked articles.")
614
615 (defface gnus-summary-low-ticked-face
616   '((((class color)
617       (background dark))
618      (:foreground "pink" :italic t))
619     (((class color)
620       (background light))
621      (:foreground "firebrick" :italic t))
622     (t
623      (:italic t)))
624   "Face used for low interest ticked articles.")
625
626 (defface gnus-summary-normal-ticked-face
627   '((((class color)
628       (background dark))
629      (:foreground "pink"))
630     (((class color)
631       (background light))
632      (:foreground "firebrick"))
633     (t
634      ()))
635   "Face used for normal interest ticked articles.")
636
637 (defface gnus-summary-high-ancient-face
638   '((((class color)
639       (background dark))
640      (:foreground "SkyBlue" :bold t))
641     (((class color)
642       (background light))
643      (:foreground "RoyalBlue" :bold t))
644     (t
645      (:bold t)))
646   "Face used for high interest ancient articles.")
647
648 (defface gnus-summary-low-ancient-face
649   '((((class color)
650       (background dark))
651      (:foreground "SkyBlue" :italic t))
652     (((class color)
653       (background light))
654      (:foreground "RoyalBlue" :italic t))
655     (t
656      (:italic t)))
657   "Face used for low interest ancient articles.")
658
659 (defface gnus-summary-normal-ancient-face
660   '((((class color)
661       (background dark))
662      (:foreground "SkyBlue"))
663     (((class color)
664       (background light))
665      (:foreground "RoyalBlue"))
666     (t
667      ()))
668   "Face used for normal interest ancient articles.")
669
670 (defface gnus-summary-high-unread-face
671   '((t
672      (:bold t)))
673   "Face used for high interest unread articles.")
674
675 (defface gnus-summary-low-unread-face
676   '((t
677      (:italic t)))
678   "Face used for low interest unread articles.")
679
680 (defface gnus-summary-normal-unread-face
681   '((t
682      ()))
683   "Face used for normal interest unread articles.")
684
685 (defface gnus-summary-high-read-face
686   '((((class color)
687       (background dark))
688      (:foreground "PaleGreen"
689                   :bold t))
690     (((class color)
691       (background light))
692      (:foreground "DarkGreen"
693                   :bold t))
694     (t
695      (:bold t)))
696   "Face used for high interest read articles.")
697
698 (defface gnus-summary-low-read-face
699   '((((class color)
700       (background dark))
701      (:foreground "PaleGreen"
702                   :italic t))
703     (((class color)
704       (background light))
705      (:foreground "DarkGreen"
706                   :italic t))
707     (t
708      (:italic t)))
709   "Face used for low interest read articles.")
710
711 (defface gnus-summary-normal-read-face
712   '((((class color)
713       (background dark))
714      (:foreground "PaleGreen"))
715     (((class color)
716       (background light))
717      (:foreground "DarkGreen"))
718     (t
719      ()))
720   "Face used for normal interest read articles.")
721
722
723 ;;;
724 ;;; Gnus buffers
725 ;;;
726
727 (defvar gnus-buffers nil)
728
729 (defun gnus-get-buffer-create (name)
730   "Do the same as `get-buffer-create', but store the created buffer."
731   (or (get-buffer name)
732       (car (push (get-buffer-create name) gnus-buffers))))
733
734 (defun gnus-add-buffer ()
735   "Add the current buffer to the list of Gnus buffers."
736   (push (current-buffer) gnus-buffers))
737
738 (defun gnus-buffers ()
739   "Return a list of live Gnus buffers."
740   (while (and gnus-buffers
741               (not (buffer-name (car gnus-buffers))))
742     (pop gnus-buffers))
743   (let ((buffers gnus-buffers))
744     (while (cdr buffers)
745       (if (buffer-name (cadr buffers))
746           (pop buffers)
747         (setcdr buffers (cddr buffers)))))
748   gnus-buffers)
749
750 ;;; Splash screen.
751
752 (defvar gnus-group-buffer "*Group*")
753
754 (eval-and-compile
755   (autoload 'gnus-play-jingle "gnus-audio"))
756
757 (defface gnus-splash-face
758   '((((class color)
759       (background dark))
760      (:foreground "#888888"))
761     (((class color)
762       (background light))
763      (:foreground "#888888"))
764     (t
765      ()))
766   "Face for the splash screen.")
767
768 (defun gnus-splash ()
769   (save-excursion
770     (switch-to-buffer (gnus-get-buffer-create gnus-group-buffer))
771     (let ((buffer-read-only nil))
772       (erase-buffer)
773       (unless gnus-inhibit-startup-message
774         (gnus-group-startup-message)
775         (sit-for 0)
776         (when gnus-play-startup-jingle
777           (gnus-play-jingle))))))
778
779 (defun gnus-indent-rigidly (start end arg)
780   "Indent rigidly using only spaces and no tabs."
781   (save-excursion
782     (save-restriction
783       (narrow-to-region start end)
784       (let ((tab-width 8))
785         (indent-rigidly start end arg)
786         ;; We translate tabs into spaces -- not everybody uses
787         ;; an 8-character tab.
788         (goto-char (point-min))
789         (while (search-forward "\t" nil t)
790           (replace-match "        " t t))))))
791
792 (defvar gnus-simple-splash nil)
793
794 ;;(format "%02x%02x%02x" 114 66 20) "724214"
795
796 (defvar gnus-logo-color-alist
797   '((flame "#cc3300" "#ff2200")
798     (pine "#c0cc93" "#f8ffb8")
799     (moss "#a1cc93" "#d2ffb8")
800     (irish "#04cc90" "#05ff97")
801     (sky "#049acc" "#05deff")
802     (tin "#6886cc" "#82b6ff")
803     (velvet "#7c68cc" "#8c82ff")
804     (grape "#b264cc" "#cf7df")
805     (labia "#cc64c2" "#fd7dff")
806     (berry "#cc6485" "#ff7db5")
807     (dino "#724214" "#1e3f03")
808     (oort "#cccccc" "#888888")
809     (storm "#666699" "#99ccff")
810     (pdino "#9999cc" "#99ccff")
811     (purp "#9999cc" "#666699")
812     (neutral "#b4b4b4" "#878787")
813     (september "#bf9900" "#ffcc00"))
814   "Color alist used for the Gnus logo.")
815
816 (defcustom gnus-logo-color-style 'oort
817   "*Color styles used for the Gnus logo."
818   :type `(choice ,@(mapcar (lambda (elem) (list 'const (car elem)))
819                            gnus-logo-color-alist))
820   :group 'gnus-xmas)
821
822 (defvar gnus-logo-colors
823   (cdr (assq gnus-logo-color-style gnus-logo-color-alist))
824   "Colors used for the Gnus logo.")
825
826 (defun gnus-group-startup-message (&optional x y)
827   "Insert startup message in current buffer."
828   ;; Insert the message.
829   (erase-buffer)
830   (cond
831    ((and
832      (fboundp 'find-image)
833      (display-graphic-p)
834      (let ((image (find-image
835                    `((:type xpm :file "gnus.xpm"
836                             :color-symbols
837                             (("thing" . ,(car gnus-logo-colors))
838                              ("shadow" . ,(cadr gnus-logo-colors))
839                              ("background" . ,(face-background 'default))))
840                      (:type pbm :file "gnus.pbm"
841                             ;; Account for the pbm's blackground.
842                             :background ,(face-foreground 'gnus-splash-face)
843                             :foreground ,(face-background 'default))
844                      (:type xbm :file "gnus.xbm"
845                             ;; Account for the xbm's blackground.
846                             :background ,(face-foreground 'gnus-splash-face)
847                             :foreground ,(face-background 'default))))))
848        (when image
849          (let ((size (image-size image)))
850            (insert-char ?\n (max 0 (round (- (window-height)
851                                              (or y (cdr size)) 1) 2)))
852            (insert-char ?\  (max 0 (round (- (window-width)
853                                              (or x (car size))) 2)))
854            (insert-image image))
855          (setq gnus-simple-splash nil)
856          t))))
857    (t
858     (insert
859      (format "              %s
860           _    ___ _             _
861           _ ___ __ ___  __    _ ___
862           __   _     ___    __  ___
863               _           ___     _
864              _  _ __             _
865              ___   __            _
866                    __           _
867                     _      _   _
868                    _      _    _
869                       _  _    _
870                   __  ___
871                  _   _ _     _
872                 _   _
873               _    _
874              _    _
875             _
876           __
877
878 "
879              ""))
880     ;; And then hack it.
881     (gnus-indent-rigidly (point-min) (point-max)
882                          (/ (max (- (window-width) (or x 46)) 0) 2))
883     (goto-char (point-min))
884     (forward-line 1)
885     (let* ((pheight (count-lines (point-min) (point-max)))
886            (wheight (window-height))
887            (rest (- wheight pheight)))
888       (insert (make-string (max 0 (* 2 (/ rest 3))) ?\n)))
889     ;; Fontify some.
890     (put-text-property (point-min) (point-max) 'face 'gnus-splash-face)
891     (setq gnus-simple-splash t)))
892   (goto-char (point-min))
893   (setq mode-line-buffer-identification (concat " " gnus-version))
894   (set-buffer-modified-p t))
895
896 (eval-when (load)
897   (let ((command (format "%s" this-command)))
898     (if (and (string-match "gnus" command)
899              (not (string-match "gnus-other-frame" command)))
900         (gnus-splash)
901       (gnus-get-buffer-create gnus-group-buffer))))
902
903 ;;; Do the rest.
904
905 (require 'gnus-util)
906 (require 'nnheader)
907
908 (defcustom gnus-parameters nil
909   "Alist of group parameters.
910
911 For example:
912    ((\"mail\\\\..*\"  (gnus-show-threads nil)
913                   (gnus-use-scoring nil)
914                   (gnus-summary-line-format
915                         \"%U%R%z%I%(%[%d:%ub%-23,23f%]%) %s\\n\")
916                   (gcc-self . t)
917                   (display . all))
918      (\"mail\\\\.me\" (gnus-use-scoring  t))
919      (\"list\\\\..*\" (total-expire . t)
920                   (broken-reply-to . t)))"
921   :group 'gnus-group-various
922   :type '(repeat (cons regexp
923                        (repeat sexp))))
924
925 (defvar gnus-group-parameters-more nil)
926
927 (defmacro gnus-define-group-parameter (param &rest rest)
928   "Define a group parameter PARAM.
929 REST is a plist of following:
930 :type               One of `bool', `list' or `nil'.
931 :function           The name of the function.
932 :function-document  The documentation of the function.
933 :parameter-type     The type for customizing the parameter.
934 :parameter-document The documentation for the parameter.
935 :variable           The name of the variable.
936 :variable-document  The documentation for the variable.
937 :variable-group     The group for customizing the variable.
938 :variable-type      The type for customizing the variable.
939 :variable-default   The default value of the variable."
940   (let* ((type (plist-get rest :type))
941          (parameter-type (plist-get rest :parameter-type))
942          (parameter-document (plist-get rest :parameter-document))
943          (function (or (plist-get rest :function)
944                        (intern (format "gnus-parameter-%s" param))))
945          (function-document (or (plist-get rest :function-document) ""))
946          (variable (or (plist-get rest :variable)
947                        (intern (format "gnus-parameter-%s-alist" param))))
948          (variable-document (or (plist-get rest :variable-document) ""))
949          (variable-group (plist-get rest :variable-group))
950          (variable-type (or (plist-get rest :variable-type)
951                             `(quote (repeat
952                                      (list (regexp :tag "Group")
953                                            ,(car (cdr parameter-type)))))))
954          (variable-default (plist-get rest :variable-default)))
955     (list
956      'progn
957      `(defcustom ,variable ,variable-default
958         ,variable-document
959         :group 'gnus-group-parameter
960         :group ',variable-group
961         :type ,variable-type)
962      `(setq gnus-group-parameters-more
963             (delq (assq ',param gnus-group-parameters-more)
964                   gnus-group-parameters-more))
965      `(add-to-list 'gnus-group-parameters-more
966                    (list ',param
967                          ,parameter-type
968                          ,parameter-document))
969      (if (eq type 'bool)
970          `(defun ,function (name)
971             ,function-document
972             (let ((params (gnus-group-find-parameter name))
973                   val)
974               (cond
975                ((memq ',param params)
976                 t)
977                ((setq val (assq ',param params))
978                 (cdr val))
979                ((stringp ,variable)
980                 (string-match ,variable name))
981                (,variable
982                 (let ((alist ,variable)
983                       elem value)
984                   (while (setq elem (pop alist))
985                     (when (and name
986                                (string-match (car elem) name))
987                       (setq alist nil
988                             value (cdr elem))))
989                   (if (consp value) (car value) value))))))
990        `(defun ,function (name)
991           ,function-document
992           (and name
993                (or (gnus-group-find-parameter name ',param ,(and type t))
994                    (let ((alist ,variable)
995                          elem value)
996                      (while (setq elem (pop alist))
997                        (when (and name
998                                   (string-match (car elem) name))
999                          (setq alist nil
1000                                value (cdr elem))))
1001                      ,(if type
1002                           'value
1003                         '(if (consp value) (car value) value))))))))))
1004
1005 (defcustom gnus-home-directory "~/"
1006   "Directory variable that specifies the \"home\" directory.
1007 All other Gnus path variables are initialized from this variable."
1008   :group 'gnus-files
1009   :type 'directory)
1010
1011 (defcustom gnus-directory (or (getenv "SAVEDIR")
1012                               (nnheader-concat gnus-home-directory "News/"))
1013   "*Directory variable from which all other Gnus file variables are derived.
1014
1015 Note that Gnus is mostly loaded when the `.gnus.el' file is read.
1016 This means that other directory variables that are initialized from
1017 this variable won't be set properly if you set this variable in `.gnus.el'.
1018 Set this variable in `.emacs' instead."
1019   :group 'gnus-files
1020   :type 'directory)
1021
1022 (defcustom gnus-default-directory nil
1023   "*Default directory for all Gnus buffers."
1024   :group 'gnus-files
1025   :type '(choice (const :tag "current" nil)
1026                  directory))
1027
1028 ;; Site dependent variables.  These variables should be defined in
1029 ;; paths.el.
1030
1031 (defvar gnus-default-nntp-server nil
1032   "Specify a default NNTP server.
1033 This variable should be defined in paths.el, and should never be set
1034 by the user.
1035 If you want to change servers, you should use `gnus-select-method'.
1036 See the documentation to that variable.")
1037
1038 ;; Don't touch this variable.
1039 (defvar gnus-nntp-service "nntp"
1040   "NNTP service name (\"nntp\" or 119).
1041 This is an obsolete variable, which is scarcely used.  If you use an
1042 nntp server for your newsgroup and want to change the port number
1043 used to 899, you would say something along these lines:
1044
1045  (setq gnus-select-method '(nntp \"my.nntp.server\" (nntp-port-number 899)))")
1046
1047 (defcustom gnus-nntpserver-file "/etc/nntpserver"
1048   "A file with only the name of the nntp server in it."
1049   :group 'gnus-files
1050   :group 'gnus-server
1051   :type 'file)
1052
1053 ;; This function is used to check both the environment variable
1054 ;; NNTPSERVER and the /etc/nntpserver file to see whether one can find
1055 ;; an nntp server name default.
1056 (defun gnus-getenv-nntpserver ()
1057   (or (getenv "NNTPSERVER")
1058       (and (file-readable-p gnus-nntpserver-file)
1059            (save-excursion
1060              (set-buffer (gnus-get-buffer-create " *gnus nntp*"))
1061              (insert-file-contents gnus-nntpserver-file)
1062              (let ((name (buffer-string)))
1063                (prog1
1064                    (if (string-match "\\'[ \t\n]*$" name)
1065                        nil
1066                      name)
1067                  (kill-buffer (current-buffer))))))))
1068
1069 (defcustom gnus-select-method
1070   (condition-case nil
1071       (nconc
1072        (list 'nntp (or (condition-case nil
1073                            (gnus-getenv-nntpserver)
1074                          (error nil))
1075                        (when (and gnus-default-nntp-server
1076                                   (not (string= gnus-default-nntp-server "")))
1077                          gnus-default-nntp-server)
1078                        "news"))
1079        (if (or (null gnus-nntp-service)
1080                (equal gnus-nntp-service "nntp"))
1081            nil
1082          (list gnus-nntp-service)))
1083     (error nil))
1084   "Default method for selecting a newsgroup.
1085 This variable should be a list, where the first element is how the
1086 news is to be fetched, the second is the address.
1087
1088 For instance, if you want to get your news via \"flab.flab.edu\" using
1089 NNTP, you could say:
1090
1091 \(setq gnus-select-method '(nntp \"flab.flab.edu\"))
1092
1093 If you want to use your local spool, say:
1094
1095 \(setq gnus-select-method (list 'nnspool (system-name)))
1096
1097 If you use this variable, you must set `gnus-nntp-server' to nil.
1098
1099 There is a lot more to know about select methods and virtual servers -
1100 see the manual for details."
1101   :group 'gnus-server
1102   :type 'gnus-select-method)
1103
1104 (defcustom gnus-message-archive-method "archive"
1105   "*Method used for archiving messages you've sent.
1106 This should be a mail method."
1107   :group 'gnus-server
1108   :group 'gnus-message
1109   :type 'gnus-select-method)
1110
1111 (defcustom gnus-message-archive-group nil
1112   "*Name of the group in which to save the messages you've written.
1113 This can either be a string; a list of strings; or an alist
1114 of regexps/functions/forms to be evaluated to return a string (or a list
1115 of strings).  The functions are called with the name of the current
1116 group (or nil) as a parameter.
1117
1118 If you want to save your mail in one group and the news articles you
1119 write in another group, you could say something like:
1120
1121  \(setq gnus-message-archive-group
1122         '((if (message-news-p)
1123               \"misc-news\"
1124             \"misc-mail\")))
1125
1126 Normally the group names returned by this variable should be
1127 unprefixed -- which implicitly means \"store on the archive server\".
1128 However, you may wish to store the message on some other server.  In
1129 that case, just return a fully prefixed name of the group --
1130 \"nnml+private:mail.misc\", for instance."
1131   :group 'gnus-message
1132   :type '(choice (const :tag "none" nil)
1133                  function
1134                  sexp
1135                  string))
1136
1137 (defcustom gnus-secondary-servers nil
1138   "List of NNTP servers that the user can choose between interactively.
1139 To make Gnus query you for a server, you have to give `gnus' a
1140 non-numeric prefix - `C-u M-x gnus', in short."
1141   :group 'gnus-server
1142   :type '(repeat string))
1143
1144 (defcustom gnus-nntp-server nil
1145   "*The name of the host running the NNTP server.
1146 This variable is semi-obsolete.  Use the `gnus-select-method'
1147 variable instead."
1148   :group 'gnus-server
1149   :type '(choice (const :tag "disable" nil)
1150                  string))
1151
1152 (defcustom gnus-secondary-select-methods nil
1153   "A list of secondary methods that will be used for reading news.
1154 This is a list where each element is a complete select method (see
1155 `gnus-select-method').
1156
1157 If, for instance, you want to read your mail with the nnml back end,
1158 you could set this variable:
1159
1160 \(setq gnus-secondary-select-methods '((nnml \"\")))"
1161   :group 'gnus-server
1162   :type '(repeat gnus-select-method))
1163
1164 (defvar gnus-backup-default-subscribed-newsgroups
1165   '("news.announce.newusers" "news.groups.questions" "gnu.emacs.gnus")
1166   "Default default new newsgroups the first time Gnus is run.
1167 Should be set in paths.el, and shouldn't be touched by the user.")
1168
1169 (defcustom gnus-local-domain nil
1170   "Local domain name without a host name.
1171 The DOMAINNAME environment variable is used instead if it is defined.
1172 If the function `system-name' returns the full Internet name, there is
1173 no need to set this variable."
1174   :group 'gnus-message
1175   :type '(choice (const :tag "default" nil)
1176                  string))
1177
1178 (defvar gnus-local-organization nil
1179   "String with a description of what organization (if any) the user belongs to.
1180 Obsolete variable; use `message-user-organization' instead.")
1181
1182 ;; Customization variables
1183
1184 (defcustom gnus-refer-article-method nil
1185   "Preferred method for fetching an article by Message-ID.
1186 If you are reading news from the local spool (with nnspool), fetching
1187 articles by Message-ID is painfully slow.  By setting this method to an
1188 nntp method, you might get acceptable results.
1189
1190 The value of this variable must be a valid select method as discussed
1191 in the documentation of `gnus-select-method'.
1192
1193 It can also be a list of select methods, as well as the special symbol
1194 `current', which means to use the current select method.  If it is a
1195 list, Gnus will try all the methods in the list until it finds a match."
1196   :group 'gnus-server
1197   :type '(choice (const :tag "default" nil)
1198                  (const :tag "Google" (nnweb "refer" (nnweb-type google)))
1199                  gnus-select-method
1200                  (repeat :menu-tag "Try multiple"
1201                          :tag "Multiple"
1202                          :value (current (nnweb "refer" (nnweb-type google)))
1203                          (choice :tag "Method"
1204                                  (const current)
1205                                  (const :tag "Google"
1206                                         (nnweb "refer" (nnweb-type google)))
1207                                  gnus-select-method))))
1208
1209 (defcustom gnus-group-faq-directory
1210   '("/ftp@mirrors.aol.com:/pub/rtfm/usenet/"
1211     "/ftp@sunsite.doc.ic.ac.uk:/pub/usenet/news-faqs/"
1212     "/ftp@src.doc.ic.ac.uk:/usenet/news-FAQS/"
1213     "/ftp@ftp.seas.gwu.edu:/pub/rtfm/"
1214     "/ftp@ftp.pasteur.fr:/pub/FAQ/"
1215     "/ftp@rtfm.mit.edu:/pub/usenet/"
1216     "/ftp@ftp.uni-paderborn.de:/pub/FAQ/"
1217     "/ftp@ftp.sunet.se:/pub/usenet/"
1218     "/ftp@nctuccca.edu.tw:/USENET/FAQ/"
1219     "/ftp@hwarang.postech.ac.kr:/pub/usenet/"
1220     "/ftp@ftp.hk.super.net:/mirror/faqs/")
1221   "*Directory where the group FAQs are stored.
1222 This will most commonly be on a remote machine, and the file will be
1223 fetched by ange-ftp.
1224
1225 This variable can also be a list of directories.  In that case, the
1226 first element in the list will be used by default.  The others can
1227 be used when being prompted for a site.
1228
1229 Note that Gnus uses an aol machine as the default directory.  If this
1230 feels fundamentally unclean, just think of it as a way to finally get
1231 something of value back from them.
1232
1233 If the default site is too slow, try one of these:
1234
1235    North America: mirrors.aol.com                /pub/rtfm/usenet
1236                   ftp.seas.gwu.edu               /pub/rtfm
1237                   rtfm.mit.edu                   /pub/usenet
1238    Europe:        ftp.uni-paderborn.de           /pub/FAQ
1239                   src.doc.ic.ac.uk               /usenet/news-FAQS
1240                   ftp.sunet.se                   /pub/usenet
1241                   ftp.pasteur.fr                 /pub/FAQ
1242    Asia:          nctuccca.edu.tw                /USENET/FAQ
1243                   hwarang.postech.ac.kr          /pub/usenet
1244                   ftp.hk.super.net               /mirror/faqs"
1245   :group 'gnus-group-various
1246   :type '(choice directory
1247                  (repeat directory)))
1248
1249 (defcustom gnus-use-cross-reference t
1250   "*Non-nil means that cross referenced articles will be marked as read.
1251 If nil, ignore cross references.  If t, mark articles as read in
1252 subscribed newsgroups.  If neither t nor nil, mark as read in all
1253 newsgroups."
1254   :group 'gnus-server
1255   :type '(choice (const :tag "off" nil)
1256                  (const :tag "subscribed" t)
1257                  (sexp :format "all"
1258                        :value always)))
1259
1260 (defcustom gnus-process-mark ?#
1261   "*Process mark."
1262   :group 'gnus-group-visual
1263   :group 'gnus-summary-marks
1264   :type 'character)
1265
1266 (defcustom gnus-large-newsgroup 200
1267   "*The number of articles which indicates a large newsgroup.
1268 If the number of articles in a newsgroup is greater than this value,
1269 confirmation is required for selecting the newsgroup.
1270 If it is `nil', no confirmation is required."
1271   :group 'gnus-group-select
1272   :type 'integer)
1273
1274 (defcustom gnus-use-long-file-name (not (memq system-type '(usg-unix-v xenix)))
1275   "*Non-nil means that the default name of a file to save articles in is the group name.
1276 If it's nil, the directory form of the group name is used instead.
1277
1278 If this variable is a list, and the list contains the element
1279 `not-score', long file names will not be used for score files; if it
1280 contains the element `not-save', long file names will not be used for
1281 saving; and if it contains the element `not-kill', long file names
1282 will not be used for kill files.
1283
1284 Note that the default for this variable varies according to what system
1285 type you're using.  On `usg-unix-v' and `xenix' this variable defaults
1286 to nil while on all other systems it defaults to t."
1287   :group 'gnus-start
1288   :type 'boolean)
1289
1290 (defcustom gnus-kill-files-directory gnus-directory
1291   "*Name of the directory where kill files will be stored (default \"~/News\")."
1292   :group 'gnus-score-files
1293   :group 'gnus-score-kill
1294   :type 'directory)
1295
1296 (defcustom gnus-save-score nil
1297   "*If non-nil, save group scoring info."
1298   :group 'gnus-score-various
1299   :group 'gnus-start
1300   :type 'boolean)
1301
1302 (defcustom gnus-use-undo t
1303   "*If non-nil, allow undoing in Gnus group mode buffers."
1304   :group 'gnus-meta
1305   :type 'boolean)
1306
1307 (defcustom gnus-use-adaptive-scoring nil
1308   "*If non-nil, use some adaptive scoring scheme.
1309 If a list, then the values `word' and `line' are meaningful.  The
1310 former will perform adaption on individual words in the subject
1311 header while `line' will perform adaption on several headers."
1312   :group 'gnus-meta
1313   :group 'gnus-score-adapt
1314   :type '(set (const word) (const line)))
1315
1316 (defcustom gnus-use-cache 'passive
1317   "*If nil, Gnus will ignore the article cache.
1318 If `passive', it will allow entering (and reading) articles
1319 explicitly entered into the cache.  If anything else, use the
1320 cache to the full extent of the law."
1321   :group 'gnus-meta
1322   :group 'gnus-cache
1323   :type '(choice (const :tag "off" nil)
1324                  (const :tag "passive" passive)
1325                  (const :tag "active" t)))
1326
1327 (defcustom gnus-use-trees nil
1328   "*If non-nil, display a thread tree buffer."
1329   :group 'gnus-meta
1330   :type 'boolean)
1331
1332 (defcustom gnus-use-grouplens nil
1333   "*If non-nil, use GroupLens ratings."
1334   :group 'gnus-meta
1335   :type 'boolean)
1336
1337 (defcustom gnus-keep-backlog nil
1338   "*If non-nil, Gnus will keep read articles for later re-retrieval.
1339 If it is a number N, then Gnus will only keep the last N articles
1340 read.  If it is neither nil nor a number, Gnus will keep all read
1341 articles.  This is not a good idea."
1342   :group 'gnus-meta
1343   :type '(choice (const :tag "off" nil)
1344                  integer
1345                  (sexp :format "all"
1346                        :value t)))
1347
1348 (defcustom gnus-use-nocem nil
1349   "*If non-nil, Gnus will read NoCeM cancel messages."
1350   :group 'gnus-meta
1351   :type 'boolean)
1352
1353 (defcustom gnus-suppress-duplicates nil
1354   "*If non-nil, Gnus will mark duplicate copies of the same article as read."
1355   :group 'gnus-meta
1356   :type 'boolean)
1357
1358 (defcustom gnus-use-scoring t
1359   "*If non-nil, enable scoring."
1360   :group 'gnus-meta
1361   :type 'boolean)
1362
1363 (defcustom gnus-summary-prepare-exit-hook
1364   '(gnus-summary-expire-articles)
1365   "*A hook called when preparing to exit from the summary buffer.
1366 It calls `gnus-summary-expire-articles' by default."
1367   :group 'gnus-summary-exit
1368   :type 'hook)
1369
1370 (defcustom gnus-novice-user t
1371   "*Non-nil means that you are a usenet novice.
1372 If non-nil, verbose messages may be displayed and confirmations may be
1373 required."
1374   :group 'gnus-meta
1375   :type 'boolean)
1376
1377 (defcustom gnus-expert-user nil
1378   "*Non-nil means that you will never be asked for confirmation about anything.
1379 That doesn't mean *anything* anything; particularly destructive
1380 commands will still require prompting."
1381   :group 'gnus-meta
1382   :type 'boolean)
1383
1384 (defcustom gnus-interactive-catchup t
1385   "*If non-nil, require your confirmation when catching up a group."
1386   :group 'gnus-group-select
1387   :type 'boolean)
1388
1389 (defcustom gnus-interactive-exit t
1390   "*If non-nil, require your confirmation when exiting Gnus."
1391   :group 'gnus-exit
1392   :type 'boolean)
1393
1394 (defcustom gnus-extract-address-components 'gnus-extract-address-components
1395   "*Function for extracting address components from a From header.
1396 Two pre-defined function exist: `gnus-extract-address-components',
1397 which is the default, quite fast, and too simplistic solution, and
1398 `mail-extract-address-components', which works much better, but is
1399 slower."
1400   :group 'gnus-summary-format
1401   :type '(radio (function-item gnus-extract-address-components)
1402                 (function-item mail-extract-address-components)
1403                 (function :tag "Other")))
1404
1405 (defcustom gnus-carpal nil
1406   "*If non-nil, display clickable icons."
1407   :group 'gnus-meta
1408   :type 'boolean)
1409
1410 (defcustom gnus-shell-command-separator ";"
1411   "String used to separate to shell commands."
1412   :group 'gnus-files
1413   :type 'string)
1414
1415 (defcustom gnus-valid-select-methods
1416   '(("nntp" post address prompt-address physical-address)
1417     ("nnspool" post address)
1418     ("nnvirtual" post-mail virtual prompt-address)
1419     ("nnmbox" mail respool address)
1420     ("nnml" post-mail respool address)
1421     ("nnmh" mail respool address)
1422     ("nndir" post-mail prompt-address physical-address)
1423     ("nneething" none address prompt-address physical-address)
1424     ("nndoc" none address prompt-address)
1425     ("nnbabyl" mail address respool)
1426     ("nnkiboze" post virtual)
1427     ("nnsoup" post-mail address)
1428     ("nndraft" post-mail)
1429     ("nnfolder" mail respool address)
1430     ("nngateway" post-mail address prompt-address physical-address)
1431     ("nnweb" none)
1432     ("nngoogle" post)
1433     ("nnslashdot" post)
1434     ("nnultimate" none)
1435     ("nnrss" none)
1436     ("nnwfm" none)
1437     ("nnwarchive" none)
1438     ("nnlistserv" none)
1439     ("nnagent" post-mail)
1440     ("nnimap" post-mail address prompt-address physical-address)
1441     ("nnmaildir" mail respool address)
1442     ("nnnil" none))
1443   "*An alist of valid select methods.
1444 The first element of each list lists should be a string with the name
1445 of the select method.  The other elements may be the category of
1446 this method (i. e., `post', `mail', `none' or whatever) or other
1447 properties that this method has (like being respoolable).
1448 If you implement a new select method, all you should have to change is
1449 this variable.  I think."
1450   :group 'gnus-server
1451   :type '(repeat (group (string :tag "Name")
1452                         (radio-button-choice (const :format "%v " post)
1453                                              (const :format "%v " mail)
1454                                              (const :format "%v " none)
1455                                              (const post-mail))
1456                         (checklist :inline t
1457                                    (const :format "%v " address)
1458                                    (const :format "%v " prompt-address)
1459                                    (const :format "%v " physical-address)
1460                                    (const :format "%v " virtual)
1461                                    (const respool)))))
1462
1463 (defun gnus-redefine-select-method-widget ()
1464   "Recomputes the select-method widget based on the value of
1465 `gnus-valid-select-methods'."
1466   (define-widget 'gnus-select-method 'list
1467     "Widget for entering a select method."
1468     :value '(nntp "")
1469     :tag "Select Method"
1470     :args `((choice :tag "Method"
1471                     ,@(mapcar (lambda (entry)
1472                                 (list 'const :format "%v\n"
1473                                       (intern (car entry))))
1474                               gnus-valid-select-methods)
1475                     (symbol :tag "other"))
1476             (string :tag "Address")
1477             (repeat :tag "Options"
1478                     :inline t
1479                     (list :format "%v"
1480                           variable
1481                           (sexp :tag "Value"))))))
1482
1483 (gnus-redefine-select-method-widget)
1484
1485 (defcustom gnus-updated-mode-lines '(group article summary tree)
1486   "List of buffers that should update their mode lines.
1487 The list may contain the symbols `group', `article', `tree' and
1488 `summary'.  If the corresponding symbol is present, Gnus will keep
1489 that mode line updated with information that may be pertinent.
1490 If this variable is nil, screen refresh may be quicker."
1491   :group 'gnus-various
1492   :type '(set (const group)
1493               (const article)
1494               (const summary)
1495               (const tree)))
1496
1497 ;; Added by Keinonen Kari <kk85613@cs.tut.fi>.
1498 (defcustom gnus-mode-non-string-length nil
1499   "*Max length of mode-line non-string contents.
1500 If this is nil, Gnus will take space as is needed, leaving the rest
1501 of the modeline intact.  Note that the default of nil is unlikely
1502 to be desirable; see the manual for further details."
1503   :group 'gnus-various
1504   :type '(choice (const nil)
1505                  integer))
1506
1507 ;; There should be special validation for this.
1508 (define-widget 'gnus-email-address 'string
1509   "An email address")
1510
1511 (gnus-define-group-parameter
1512  to-address
1513  :function-document
1514  "Return GROUP's to-address."
1515  :variable-document
1516  "*Alist of group regexps and correspondent to-addresses."
1517  :parameter-type '(gnus-email-address :tag "To Address")
1518  :parameter-document "\
1519 This will be used when doing followups and posts.
1520
1521 This is primarily useful in mail groups that represent closed
1522 mailing lists--mailing lists where it's expected that everybody that
1523 writes to the mailing list is subscribed to it.  Since using this
1524 parameter ensures that the mail only goes to the mailing list itself,
1525 it means that members won't receive two copies of your followups.
1526
1527 Using `to-address' will actually work whether the group is foreign or
1528 not.  Let's say there's a group on the server that is called
1529 `fa.4ad-l'.  This is a real newsgroup, but the server has gotten the
1530 articles from a mail-to-news gateway.  Posting directly to this group
1531 is therefore impossible--you have to send mail to the mailing list
1532 address instead.
1533
1534 The gnus-group-split mail splitting mechanism will behave as if this
1535 address was listed in gnus-group-split Addresses (see below).")
1536
1537 (gnus-define-group-parameter
1538  to-list
1539  :function-document
1540  "Return GROUP's to-list."
1541  :variable-document
1542  "*Alist of group regexps and correspondent to-lists."
1543  :parameter-type '(gnus-email-address :tag "To List")
1544  :parameter-document "\
1545 This address will be used when doing a `a' in the group.
1546
1547 It is totally ignored when doing a followup--except that if it is
1548 present in a news group, you'll get mail group semantics when doing
1549 `f'.
1550
1551 The gnus-group-split mail splitting mechanism will behave as if this
1552 address was listed in gnus-group-split Addresses (see below).")
1553
1554 (gnus-define-group-parameter
1555  subscribed
1556  :type bool
1557  :function-document
1558  "Return GROUP's subscription status."
1559  :variable-document
1560  "*Groups which are automatically considered subscribed."
1561  :parameter-type '(const :tag "Subscribed" t)
1562  :parameter-document "\
1563 Gnus assumed that you are subscribed to the To/List address.
1564
1565 When constructing a list of subscribed groups using
1566 `gnus-find-subscribed-addresses', Gnus includes the To address given
1567 above, or the list address (if the To address has not been set).")
1568
1569 (gnus-define-group-parameter
1570  auto-expire
1571  :type bool
1572  :function gnus-group-auto-expirable-p
1573  :function-document
1574  "Check whether GROUP is auto-expirable or not."
1575  :variable gnus-auto-expirable-newsgroups
1576  :variable-default nil
1577  :variable-document
1578  "*Groups in which to automatically mark read articles as expirable.
1579 If non-nil, this should be a regexp that should match all groups in
1580 which to perform auto-expiry.  This only makes sense for mail groups."
1581  :variable-group nnmail-expire
1582  :variable-type '(choice (const nil)
1583                          regexp)
1584  :parameter-type '(const :tag "Automatic Expire" t)
1585  :parameter-document
1586  "All articles that are read will be marked as expirable.")
1587
1588 (gnus-define-group-parameter
1589  total-expire
1590  :type bool
1591  :function gnus-group-total-expirable-p
1592  :function-document
1593  "Check whether GROUP is total-expirable or not."
1594  :variable gnus-total-expirable-newsgroups
1595  :variable-default nil
1596  :variable-document
1597  "*Groups in which to perform expiry of all read articles.
1598 Use with extreme caution.  All groups that match this regexp will be
1599 expiring - which means that all read articles will be deleted after
1600 \(say) one week.         (This only goes for mail groups and the like, of
1601 course.)"
1602  :variable-group nnmail-expire
1603  :variable-type '(choice (const nil)
1604                          regexp)
1605  :parameter-type '(const :tag "Total Expire" t)
1606  :parameter-document
1607  "All read articles will be put through the expiry process
1608
1609 This happens even if they are not marked as expirable.
1610 Use with caution.")
1611
1612 (gnus-define-group-parameter
1613  charset
1614  :function-document
1615  "Return the default charset of GROUP."
1616  :variable gnus-group-charset-alist
1617  :variable-default
1618  '(("\\(^\\|:\\)hk\\>\\|\\(^\\|:\\)tw\\>\\|\\<big5\\>" cn-big5)
1619    ("\\(^\\|:\\)cn\\>\\|\\<chinese\\>" cn-gb-2312)
1620    ("\\(^\\|:\\)fj\\>\\|\\(^\\|:\\)japan\\>" iso-2022-jp-2)
1621    ("\\(^\\|:\\)tnn\\>\\|\\(^\\|:\\)pin\\>\\|\\(^\\|:\\)sci.lang.japan" iso-2022-7bit)
1622    ("\\(^\\|:\\)relcom\\>" koi8-r)
1623    ("\\(^\\|:\\)fido7\\>" koi8-r)
1624    ("\\(^\\|:\\)\\(cz\\|hun\\|pl\\|sk\\|hr\\)\\>" iso-8859-2)
1625    ("\\(^\\|:\\)israel\\>" iso-8859-1)
1626    ("\\(^\\|:\\)han\\>" euc-kr)
1627    ("\\(^\\|:\\)alt.chinese.text.big5\\>" chinese-big5)
1628    ("\\(^\\|:\\)soc.culture.vietnamese\\>" vietnamese-viqr)
1629    ("\\(^\\|:\\)\\(comp\\|rec\\|alt\\|sci\\|soc\\|news\\|gnu\\|bofh\\)\\>" iso-8859-1))
1630  :variable-document
1631  "Alist of regexps (to match group names) and default charsets to be used when reading."
1632  :variable-group gnus-charset
1633  :variable-type '(repeat (list (regexp :tag "Group")
1634                                (symbol :tag "Charset")))
1635  :parameter-type '(symbol :tag "Charset")
1636  :parameter-document "\
1637 The default charset to use in the group.")
1638
1639 (gnus-define-group-parameter
1640  post-method
1641  :type list
1642  :function-document
1643  "Return a posting method for GROUP."
1644  :variable gnus-post-method-alist
1645  :variable-document
1646  "Alist of regexps (to match group names) and method to be used when
1647 posting an article."
1648  :variable-group gnus-group-foreign
1649  :parameter-type
1650  '(choice :tag "Posting Method"
1651           (const :tag "Use native server" native)
1652           (const :tag "Use current server" current)
1653           (list :convert-widget
1654                 (lambda (widget)
1655                   (list 'sexp :tag "Methods"
1656                         :value gnus-select-method))))
1657  :parameter-document
1658  "Posting method for this group.")
1659
1660 (gnus-define-group-parameter
1661  large-newsgroup-initial
1662  :type integer
1663  :function-document
1664  "Return GROUP's initial input of the number of articles."
1665  :variable-document
1666  "*Alist of group regexps and its initial input of the number of articles."
1667  :parameter-type '(choice :tag "Initial Input for Large Newsgroup"
1668                           (const :tag "All" nil)
1669                           (integer))
1670  :parameter-document "\
1671
1672 This number will be prompted as the initial value of the number of
1673 articles to list when the group is a large newsgroup (see
1674 `gnus-large-newsgroup').  If it is `nil', the default value is the
1675 total number of articles in the group.")
1676
1677 (defcustom gnus-group-uncollapsed-levels 1
1678   "Number of group name elements to leave alone when making a short group name."
1679   :group 'gnus-group-visual
1680   :type 'integer)
1681
1682 (defcustom gnus-group-use-permanent-levels nil
1683   "*If non-nil, once you set a level, Gnus will use this level."
1684   :group 'gnus-group-levels
1685   :type 'boolean)
1686
1687 ;; Hooks.
1688
1689 (defcustom gnus-load-hook nil
1690   "A hook run while Gnus is loaded."
1691   :group 'gnus-start
1692   :type 'hook)
1693
1694 (defcustom gnus-apply-kill-hook '(gnus-apply-kill-file)
1695   "A hook called to apply kill files to a group.
1696 This hook is intended to apply a kill file to the selected newsgroup.
1697 The function `gnus-apply-kill-file' is called by default.
1698
1699 Since a general kill file is too heavy to use only for a few
1700 newsgroups, I recommend you to use a lighter hook function.  For
1701 example, if you'd like to apply a kill file to articles which contains
1702 a string `rmgroup' in subject in newsgroup `control', you can use the
1703 following hook:
1704
1705  (setq gnus-apply-kill-hook
1706       (list
1707         (lambda ()
1708           (cond ((string-match \"control\" gnus-newsgroup-name)
1709                  (gnus-kill \"Subject\" \"rmgroup\")
1710                  (gnus-expunge \"X\"))))))"
1711   :group 'gnus-score-kill
1712   :options '(gnus-apply-kill-file)
1713   :type 'hook)
1714
1715 (defcustom gnus-group-change-level-function nil
1716   "Function run when a group level is changed.
1717 It is called with three parameters -- GROUP, LEVEL and OLDLEVEL."
1718   :group 'gnus-group-levels
1719   :type 'function)
1720
1721 ;;; Face thingies.
1722
1723 (defcustom gnus-visual
1724   '(summary-highlight group-highlight article-highlight
1725                       mouse-face
1726                       summary-menu group-menu article-menu
1727                       tree-highlight menu highlight
1728                       browse-menu server-menu
1729                       page-marker tree-menu binary-menu pick-menu
1730                       grouplens-menu)
1731   "*Enable visual features.
1732 If `visual' is disabled, there will be no menus and few faces.  Most of
1733 the visual customization options below will be ignored.  Gnus will use
1734 less space and be faster as a result.
1735
1736 This variable can also be a list of visual elements to switch on.  For
1737 instance, to switch off all visual things except menus, you can say:
1738
1739    (setq gnus-visual '(menu))
1740
1741 Valid elements include `summary-highlight', `group-highlight',
1742 `article-highlight', `mouse-face', `summary-menu', `group-menu',
1743 `article-menu', `tree-highlight', `menu', `highlight', `browse-menu',
1744 `server-menu', `page-marker', `tree-menu', `binary-menu', `pick-menu',
1745 and `grouplens-menu'."
1746   :group 'gnus-meta
1747   :group 'gnus-visual
1748   :type '(set (const summary-highlight)
1749               (const group-highlight)
1750               (const article-highlight)
1751               (const mouse-face)
1752               (const summary-menu)
1753               (const group-menu)
1754               (const article-menu)
1755               (const tree-highlight)
1756               (const menu)
1757               (const highlight)
1758               (const browse-menu)
1759               (const server-menu)
1760               (const page-marker)
1761               (const tree-menu)
1762               (const binary-menu)
1763               (const pick-menu)
1764               (const grouplens-menu)))
1765
1766 ;; Byte-compiler warning.
1767 (defvar gnus-visual)
1768 ;; Find out whether the gnus-visual TYPE is wanted.
1769 (defun gnus-visual-p (&optional type class)
1770   (and gnus-visual                      ; Has to be non-nil, at least.
1771        (if (not type)                   ; We don't care about type.
1772            gnus-visual
1773          (if (listp gnus-visual)        ; It's a list, so we check it.
1774              (or (memq type gnus-visual)
1775                  (memq class gnus-visual))
1776            t))))
1777
1778 (defcustom gnus-mouse-face
1779   (condition-case ()
1780       (if (gnus-visual-p 'mouse-face 'highlight)
1781           (if (boundp 'gnus-mouse-face)
1782               (or gnus-mouse-face 'highlight)
1783             'highlight)
1784         'default)
1785     (error 'highlight))
1786   "*Face used for group or summary buffer mouse highlighting.
1787 The line beneath the mouse pointer will be highlighted with this
1788 face."
1789   :group 'gnus-visual
1790   :type 'face)
1791
1792 (defcustom gnus-article-save-directory gnus-directory
1793   "*Name of the directory articles will be saved in (default \"~/News\")."
1794   :group 'gnus-article-saving
1795   :type 'directory)
1796
1797 (defvar gnus-plugged t
1798   "Whether Gnus is plugged or not.")
1799
1800 (defcustom gnus-agent-cache t
1801   "Whether Gnus use agent cache."
1802   :version "21.3"
1803   :group 'gnus-agent
1804   :type 'boolean)
1805
1806 (defcustom gnus-default-charset (mm-guess-mime-charset)
1807   "Default charset assumed to be used when viewing non-ASCII characters.
1808 This variable is overridden on a group-to-group basis by the
1809 gnus-group-charset-alist variable and is only used on groups not
1810 covered by that variable."
1811   :type 'symbol
1812   :group 'gnus-charset)
1813
1814 (defcustom gnus-agent nil
1815   "Whether we want to use the Gnus agent or not.
1816 Putting (gnus-agentize) in ~/.gnus is obsolete by (setq gnus-agent t)."
1817   :version "21.3"
1818   :group 'gnus-agent
1819   :type 'boolean)
1820
1821 \f
1822 ;;; Internal variables
1823
1824 (defvar gnus-agent-gcc-header "X-Gnus-Agent-Gcc")
1825 (defvar gnus-agent-meta-information-header "X-Gnus-Agent-Meta-Information")
1826 (defvar gnus-draft-meta-information-header "X-Draft-From")
1827 (defvar gnus-group-get-parameter-function 'gnus-group-get-parameter)
1828 (defvar gnus-original-article-buffer " *Original Article*")
1829 (defvar gnus-newsgroup-name nil)
1830 (defvar gnus-ephemeral-servers nil)
1831 (defvar gnus-server-method-cache nil)
1832
1833 (defvar gnus-agent-fetching nil
1834   "Whether Gnus agent is in fetching mode.")
1835
1836 (defvar gnus-agent-covered-methods nil)
1837
1838 (defvar gnus-command-method nil
1839   "Dynamically bound variable that says what the current back end is.")
1840
1841 (defvar gnus-current-select-method nil
1842   "The current method for selecting a newsgroup.")
1843
1844 (defvar gnus-tree-buffer "*Tree*"
1845   "Buffer where Gnus thread trees are displayed.")
1846
1847 ;; Dummy variable.
1848 (defvar gnus-use-generic-from nil)
1849
1850 ;; Variable holding the user answers to all method prompts.
1851 (defvar gnus-method-history nil)
1852
1853 ;; Variable holding the user answers to all mail method prompts.
1854 (defvar gnus-mail-method-history nil)
1855
1856 ;; Variable holding the user answers to all group prompts.
1857 (defvar gnus-group-history nil)
1858
1859 (defvar gnus-server-alist nil
1860   "List of available servers.")
1861
1862 (defcustom gnus-cache-directory
1863   (nnheader-concat gnus-directory "cache/")
1864   "*The directory where cached articles will be stored."
1865   :group 'gnus-cache
1866   :type 'directory)
1867
1868 (defvar gnus-predefined-server-alist
1869   `(("cache"
1870      nnspool "cache"
1871      (nnspool-spool-directory ,gnus-cache-directory)
1872      (nnspool-nov-directory ,gnus-cache-directory)
1873      (nnspool-active-file
1874       ,(nnheader-concat gnus-cache-directory "active"))))
1875   "List of predefined (convenience) servers.")
1876
1877 (defvar gnus-topic-indentation "") ;; Obsolete variable.
1878
1879 (defconst gnus-article-mark-lists
1880   '((marked . tick) (replied . reply)
1881     (expirable . expire) (killed . killed)
1882     (bookmarks . bookmark) (dormant . dormant)
1883     (scored . score) (saved . save)
1884     (cached . cache) (downloadable . download)
1885     (unsendable . unsend) (forwarded . forward)
1886     (recent . recent) (seen . seen)))
1887
1888 (defconst gnus-article-special-mark-lists
1889   '((seen range)
1890     (killed range)
1891     (bookmark tuple)
1892     (score tuple)))
1893
1894 ;; Propagate flags to server, with the following exceptions:
1895 ;; `seen' is private to each gnus installation
1896 ;; `cache' is a internal gnus flag for each gnus installation
1897 ;; `download' is a agent flag private to each gnus installation
1898 ;; `unsend' are for nndraft groups only
1899 ;; `score' is not a proper mark
1900 ;; `bookmark': don't propagated it, or fix the bug in update-mark.
1901 (defconst gnus-article-unpropagated-mark-lists
1902   '(seen cache download unsend score bookmark)
1903   "Marks that shouldn't be propagated to back ends.
1904 Typical marks are those that make no sense in a standalone back end,
1905 such as a mark that says whether an article is stored in the cache
1906 \(which doesn't make sense in a standalone back end).")
1907
1908 (defvar gnus-headers-retrieved-by nil)
1909 (defvar gnus-article-reply nil)
1910 (defvar gnus-override-method nil)
1911 (defvar gnus-article-check-size nil)
1912 (defvar gnus-opened-servers nil)
1913
1914 (defvar gnus-current-kill-article nil)
1915
1916 (defvar gnus-have-read-active-file nil)
1917
1918 (defconst gnus-maintainer
1919   "bugs@gnus.org (The Gnus Bugfixing Girls + Boys)"
1920   "The mail address of the Gnus maintainers.")
1921
1922 (defvar gnus-info-nodes
1923   '((gnus-group-mode "(gnus)Group Buffer")
1924     (gnus-summary-mode "(gnus)Summary Buffer")
1925     (gnus-article-mode "(gnus)Article Buffer")
1926     (gnus-server-mode "(gnus)Server Buffer")
1927     (gnus-browse-mode "(gnus)Browse Foreign Server")
1928     (gnus-tree-mode "(gnus)Tree Display"))
1929   "Alist of major modes and related Info nodes.")
1930
1931 (defvar gnus-group-buffer "*Group*")
1932 (defvar gnus-summary-buffer "*Summary*")
1933 (defvar gnus-article-buffer "*Article*")
1934 (defvar gnus-server-buffer "*Server*")
1935
1936 (defvar gnus-slave nil
1937   "Whether this Gnus is a slave or not.")
1938
1939 (defvar gnus-batch-mode nil
1940   "Whether this Gnus is running in batch mode or not.")
1941
1942 (defvar gnus-variable-list
1943   '(gnus-newsrc-options gnus-newsrc-options-n
1944                         gnus-newsrc-last-checked-date
1945                         gnus-newsrc-alist gnus-server-alist
1946                         gnus-killed-list gnus-zombie-list
1947                         gnus-topic-topology gnus-topic-alist
1948                         gnus-format-specs)
1949   "Gnus variables saved in the quick startup file.")
1950
1951 (defvar gnus-newsrc-alist nil
1952   "Assoc list of read articles.
1953 gnus-newsrc-hashtb should be kept so that both hold the same information.")
1954
1955 (defvar gnus-newsrc-hashtb nil
1956   "Hashtable of gnus-newsrc-alist.")
1957
1958 (defvar gnus-killed-list nil
1959   "List of killed newsgroups.")
1960
1961 (defvar gnus-killed-hashtb nil
1962   "Hash table equivalent of gnus-killed-list.")
1963
1964 (defvar gnus-zombie-list nil
1965   "List of almost dead newsgroups.")
1966
1967 (defvar gnus-description-hashtb nil
1968   "Descriptions of newsgroups.")
1969
1970 (defvar gnus-list-of-killed-groups nil
1971   "List of newsgroups that have recently been killed by the user.")
1972
1973 (defvar gnus-active-hashtb nil
1974   "Hashtable of active articles.")
1975
1976 (defvar gnus-moderated-hashtb nil
1977   "Hashtable of moderated newsgroups.")
1978
1979 ;; Save window configuration.
1980 (defvar gnus-prev-winconf nil)
1981
1982 (defvar gnus-reffed-article-number nil)
1983
1984 ;;; Let the byte-compiler know that we know about this variable.
1985 (defvar rmail-default-rmail-file)
1986
1987 (defvar gnus-dead-summary nil)
1988
1989 (defvar gnus-invalid-group-regexp "[: `'\"/]\\|^$"
1990   "Regexp matching invalid groups.")
1991
1992 ;;; End of variables.
1993
1994 ;; Define some autoload functions Gnus might use.
1995 (eval-and-compile
1996
1997   ;; This little mapcar goes through the list below and marks the
1998   ;; symbols in question as autoloaded functions.
1999   (mapcar
2000    (lambda (package)
2001      (let ((interactive (nth 1 (memq ':interactive package))))
2002        (mapcar
2003         (lambda (function)
2004           (let (keymap)
2005             (when (consp function)
2006               (setq keymap (car (memq 'keymap function)))
2007               (setq function (car function)))
2008             (unless (fboundp function)
2009               (autoload function (car package) nil interactive keymap))))
2010         (if (eq (nth 1 package) ':interactive)
2011             (nthcdr 3 package)
2012           (cdr package)))))
2013    '(("info" :interactive t Info-goto-node)
2014      ("pp" pp-to-string)
2015      ("qp" quoted-printable-decode-region quoted-printable-decode-string)
2016      ("ps-print" ps-print-preprint)
2017      ("message" :interactive t
2018       message-send-and-exit message-yank-original)
2019      ("babel" babel-as-string)
2020      ("nnmail" nnmail-split-fancy nnmail-article-group)
2021      ("nnvirtual" nnvirtual-catchup-group nnvirtual-convert-headers)
2022      ("rmailout" rmail-output rmail-output-to-rmail-file)
2023      ("rmail" rmail-insert-rmail-file-header rmail-count-new-messages
2024       rmail-show-message rmail-summary-exists
2025       rmail-select-summary rmail-update-summary)
2026      ("gnus-audio" :interactive t gnus-audio-play)
2027      ("gnus-xmas" gnus-xmas-splash)
2028      ("gnus-soup" :interactive t
2029       gnus-group-brew-soup gnus-brew-soup gnus-soup-add-article
2030       gnus-soup-send-replies gnus-soup-save-areas gnus-soup-pack-packet)
2031      ("nnsoup" nnsoup-pack-replies)
2032      ("score-mode" :interactive t gnus-score-mode)
2033      ("gnus-mh" gnus-summary-save-article-folder
2034       gnus-Folder-save-name gnus-folder-save-name)
2035      ("gnus-mh" :interactive t gnus-summary-save-in-folder)
2036      ("gnus-demon" gnus-demon-add-nocem gnus-demon-add-scanmail
2037       gnus-demon-add-rescan gnus-demon-add-scan-timestamps
2038       gnus-demon-add-disconnection gnus-demon-add-handler
2039       gnus-demon-remove-handler)
2040      ("gnus-demon" :interactive t
2041       gnus-demon-init gnus-demon-cancel)
2042      ("gnus-fun" gnus-convert-gray-x-face-to-xpm gnus-display-x-face-in-from
2043       gnus-convert-image-to-gray-x-face)
2044      ("gnus-salt" gnus-highlight-selected-tree gnus-possibly-generate-tree
2045       gnus-tree-open gnus-tree-close gnus-carpal-setup-buffer)
2046      ("gnus-nocem" gnus-nocem-scan-groups gnus-nocem-close
2047       gnus-nocem-unwanted-article-p)
2048      ("gnus-srvr" gnus-enter-server-buffer gnus-server-set-info
2049       gnus-server-server-name)
2050      ("gnus-srvr" gnus-browse-foreign-server)
2051      ("gnus-cite" :interactive t
2052       gnus-article-highlight-citation gnus-article-hide-citation-maybe
2053       gnus-article-hide-citation gnus-article-fill-cited-article
2054       gnus-article-hide-citation-in-followups)
2055      ("gnus-kill" gnus-kill gnus-apply-kill-file-internal
2056       gnus-kill-file-edit-file gnus-kill-file-raise-followups-to-author
2057       gnus-execute gnus-expunge gnus-batch-kill gnus-batch-score)
2058      ("gnus-cache" gnus-cache-possibly-enter-article gnus-cache-save-buffers
2059       gnus-cache-possibly-remove-articles gnus-cache-request-article
2060       gnus-cache-retrieve-headers gnus-cache-possibly-alter-active
2061       gnus-cache-enter-remove-article gnus-cached-article-p
2062       gnus-cache-open gnus-cache-close gnus-cache-update-article
2063       gnus-cache-articles-in-group)
2064      ("gnus-cache" :interactive t gnus-jog-cache gnus-cache-enter-article
2065       gnus-cache-remove-article gnus-summary-insert-cached-articles)
2066      ("gnus-score" :interactive t
2067       gnus-summary-increase-score gnus-summary-set-score
2068       gnus-summary-raise-thread gnus-summary-raise-same-subject
2069       gnus-summary-raise-score gnus-summary-raise-same-subject-and-select
2070       gnus-summary-lower-thread gnus-summary-lower-same-subject
2071       gnus-summary-lower-score gnus-summary-lower-same-subject-and-select
2072       gnus-summary-current-score gnus-score-delta-default
2073       gnus-score-flush-cache gnus-score-close
2074       gnus-possibly-score-headers gnus-score-followup-article
2075       gnus-score-followup-thread)
2076      ("gnus-score"
2077       (gnus-summary-score-map keymap) gnus-score-save gnus-score-headers
2078       gnus-current-score-file-nondirectory gnus-score-adaptive
2079       gnus-score-find-trace gnus-score-file-name)
2080      ("gnus-cus" :interactive t gnus-group-customize gnus-score-customize)
2081      ("gnus-topic" :interactive t gnus-topic-mode)
2082      ("gnus-topic" gnus-topic-remove-group gnus-topic-set-parameters
2083       gnus-subscribe-topics)
2084      ("gnus-salt" :interactive t gnus-pick-mode gnus-binary-mode)
2085      ("gnus-uu" (gnus-uu-extract-map keymap) (gnus-uu-mark-map keymap))
2086      ("gnus-uu" :interactive t
2087       gnus-uu-digest-mail-forward gnus-uu-digest-post-forward
2088       gnus-uu-mark-series gnus-uu-mark-region gnus-uu-mark-buffer
2089       gnus-uu-mark-by-regexp gnus-uu-mark-all
2090       gnus-uu-mark-sparse gnus-uu-mark-thread gnus-uu-decode-uu
2091       gnus-uu-decode-uu-and-save gnus-uu-decode-unshar
2092       gnus-uu-decode-unshar-and-save gnus-uu-decode-save
2093       gnus-uu-decode-binhex gnus-uu-decode-uu-view
2094       gnus-uu-decode-uu-and-save-view gnus-uu-decode-unshar-view
2095       gnus-uu-decode-unshar-and-save-view gnus-uu-decode-save-view
2096       gnus-uu-decode-binhex-view gnus-uu-unmark-thread
2097       gnus-uu-mark-over gnus-uu-post-news)
2098      ("gnus-uu" gnus-uu-delete-work-dir gnus-uu-unmark-thread)
2099      ("gnus-msg" (gnus-summary-send-map keymap)
2100       gnus-article-mail gnus-copy-article-buffer gnus-extended-version)
2101      ("gnus-msg" :interactive t
2102       gnus-group-post-news gnus-group-mail gnus-group-news
2103       gnus-summary-post-news gnus-summary-news-other-window
2104       gnus-summary-followup gnus-summary-followup-with-original
2105       gnus-summary-cancel-article gnus-summary-supersede-article
2106       gnus-post-news gnus-summary-reply gnus-summary-reply-with-original
2107       gnus-summary-mail-forward gnus-summary-mail-other-window
2108       gnus-summary-resend-message gnus-summary-resend-bounced-mail
2109       gnus-summary-wide-reply gnus-summary-followup-to-mail
2110       gnus-summary-followup-to-mail-with-original gnus-bug
2111       gnus-summary-wide-reply-with-original
2112       gnus-summary-post-forward gnus-summary-wide-reply-with-original
2113       gnus-summary-post-forward)
2114      ("gnus-picon" :interactive t gnus-treat-from-picon)
2115      ("gnus-gl" bbb-login bbb-logout bbb-grouplens-group-p
2116       gnus-grouplens-mode)
2117      ("smiley" :interactive t smiley-region)
2118      ("gnus-win" gnus-configure-windows gnus-add-configuration)
2119      ("gnus-sum" gnus-summary-insert-line gnus-summary-read-group
2120       gnus-list-of-unread-articles gnus-list-of-read-articles
2121       gnus-offer-save-summaries gnus-make-thread-indent-array
2122       gnus-summary-exit gnus-update-read-articles gnus-summary-last-subject
2123       gnus-summary-skip-intangible gnus-summary-article-number
2124       gnus-data-header gnus-data-find)
2125      ("gnus-group" gnus-group-insert-group-line gnus-group-quit
2126       gnus-group-list-groups gnus-group-first-unread-group
2127       gnus-group-set-mode-line gnus-group-set-info gnus-group-save-newsrc
2128       gnus-group-setup-buffer gnus-group-get-new-news
2129       gnus-group-make-help-group gnus-group-update-group
2130       gnus-group-iterate gnus-group-group-name)
2131      ("gnus-bcklg" gnus-backlog-request-article gnus-backlog-enter-article
2132       gnus-backlog-remove-article)
2133      ("gnus-art" gnus-article-read-summary-keys gnus-article-save
2134       gnus-article-prepare gnus-article-set-window-start
2135       gnus-article-next-page gnus-article-prev-page
2136       gnus-request-article-this-buffer gnus-article-mode
2137       gnus-article-setup-buffer gnus-narrow-to-page
2138       gnus-article-delete-invisible-text gnus-treat-article)
2139      ("gnus-art" :interactive t
2140       gnus-article-hide-headers gnus-article-hide-boring-headers
2141       gnus-article-treat-overstrike
2142       gnus-article-remove-cr gnus-article-remove-trailing-blank-lines
2143       gnus-article-display-x-face gnus-article-de-quoted-unreadable
2144       gnus-article-de-base64-unreadable
2145       gnus-article-decode-HZ
2146       gnus-article-wash-html
2147       gnus-article-unsplit-urls
2148       gnus-article-hide-pgp
2149       gnus-article-hide-pem gnus-article-hide-signature
2150       gnus-article-strip-leading-blank-lines gnus-article-date-local
2151       gnus-article-date-original gnus-article-date-lapsed
2152 ;;      gnus-article-show-all-headers
2153       gnus-article-edit-mode gnus-article-edit-article
2154       gnus-article-edit-done gnus-article-decode-encoded-words
2155       gnus-start-date-timer gnus-stop-date-timer
2156       gnus-mime-view-all-parts)
2157      ("gnus-int" gnus-request-type)
2158      ("gnus-start" gnus-newsrc-parse-options gnus-1 gnus-no-server-1
2159       gnus-dribble-enter gnus-read-init-file gnus-dribble-touch)
2160      ("gnus-dup" gnus-dup-suppress-articles gnus-dup-unsuppress-article
2161       gnus-dup-enter-articles)
2162      ("gnus-range" gnus-copy-sequence)
2163      ("gnus-eform" gnus-edit-form)
2164      ("gnus-move" :interactive t
2165       gnus-group-move-group-to-server gnus-change-server)
2166      ("gnus-logic" gnus-score-advanced)
2167      ("gnus-undo" gnus-undo-mode gnus-undo-register)
2168      ("gnus-async" gnus-async-request-fetched-article gnus-async-prefetch-next
2169       gnus-async-prefetch-article gnus-async-prefetch-remove-group
2170       gnus-async-halt-prefetch)
2171      ("gnus-agent" gnus-open-agent gnus-agent-get-function
2172       gnus-agent-save-groups gnus-agent-save-active gnus-agent-method-p
2173       gnus-agent-get-undownloaded-list gnus-agent-fetch-session
2174       gnus-summary-set-agent-mark gnus-agent-save-group-info
2175       gnus-agent-request-article gnus-agent-retrieve-headers)
2176      ("gnus-agent" :interactive t
2177       gnus-unplugged gnus-agentize gnus-agent-batch)
2178      ("gnus-vm" :interactive t gnus-summary-save-in-vm
2179       gnus-summary-save-article-vm)
2180      ("compface" uncompface)
2181      ("gnus-draft" :interactive t gnus-draft-mode gnus-group-send-queue)
2182      ("gnus-mlspl" gnus-group-split gnus-group-split-fancy)
2183      ("gnus-mlspl" :interactive t gnus-group-split-setup
2184       gnus-group-split-update))))
2185
2186 ;;; gnus-sum.el thingies
2187
2188
2189 (defcustom gnus-summary-line-format "%U%R%z%I%(%[%4L: %-23,23f%]%) %s\n"
2190   "*The format specification of the lines in the summary buffer.
2191
2192 It works along the same lines as a normal formatting string,
2193 with some simple extensions.
2194
2195 %N   Article number, left padded with spaces (string)
2196 %S   Subject (string)
2197 %s   Subject if it is at the root of a thread, and \"\" otherwise (string)
2198 %n   Name of the poster (string)
2199 %a   Extracted name of the poster (string)
2200 %A   Extracted address of the poster (string)
2201 %F   Contents of the From: header (string)
2202 %f   Contents of the From: or To: headers (string)
2203 %x   Contents of the Xref: header (string)
2204 %D   Date of the article (string)
2205 %d   Date of the article (string) in DD-MMM format
2206 %o   Date of the article (string) in YYYYMMDD`T'HHMMSS format
2207 %M   Message-id of the article (string)
2208 %r   References of the article (string)
2209 %c   Number of characters in the article (integer)
2210 %L   Number of lines in the article (integer)
2211 %I   Indentation based on thread level (a string of spaces)
2212 %B   A complex trn-style thread tree (string)
2213      The variables `gnus-sum-thread-*' can be used for customization.
2214 %T   A string with two possible values: 80 spaces if the article
2215      is on thread level two or larger and 0 spaces on level one
2216 %R   \"A\" if this article has been replied to, \" \" otherwise (character)
2217 %U   Status of this article (character, \"R\", \"K\", \"-\" or \" \")
2218 %[   Opening bracket (character, \"[\" or \"<\")
2219 %]   Closing bracket (character, \"]\" or \">\")
2220 %>   Spaces of length thread-level (string)
2221 %<   Spaces of length (- 20 thread-level) (string)
2222 %i   Article score (number)
2223 %z   Article zcore (character)
2224 %t   Number of articles under the current thread (number).
2225 %e   Whether the thread is empty or not (character).
2226 %l   GroupLens score (string).
2227 %V   Total thread score (number).
2228 %P   The line number (number).
2229 %O   Download mark (character).
2230 %u   User defined specifier.  The next character in the format string should
2231      be a letter.  Gnus will call the function gnus-user-format-function-X,
2232      where X is the letter following %u.  The function will be passed the
2233      current header as argument.  The function should return a string, which
2234      will be inserted into the summary just like information from any other
2235      summary specifier.
2236
2237 The %U (status), %R (replied) and %z (zcore) specs have to be handled
2238 with care.  For reasons of efficiency, Gnus will compute what column
2239 these characters will end up in, and \"hard-code\" that.  This means that
2240 it is invalid to have these specs after a variable-length spec.  Well,
2241 you might not be arrested, but your summary buffer will look strange,
2242 which is bad enough.
2243
2244 The smart choice is to have these specs as far to the left as
2245 possible.
2246
2247 This restriction may disappear in later versions of Gnus.
2248
2249 General format specifiers can also be used.
2250 See `(gnus)Formatting Variables'."
2251   :link '(custom-manual "(gnus)Formatting Variables")
2252   :type 'string
2253   :group 'gnus-summary-format)
2254
2255 ;;;
2256 ;;; Skeleton keymaps
2257 ;;;
2258
2259 (defun gnus-suppress-keymap (keymap)
2260   (suppress-keymap keymap)
2261   (let ((keys `([backspace] [delete] "\177" "\M-u"))) ;gnus-mouse-2
2262     (while keys
2263       (define-key keymap (pop keys) 'undefined))))
2264
2265 (defvar gnus-article-mode-map
2266   (let ((keymap (make-sparse-keymap)))
2267     (gnus-suppress-keymap keymap)
2268     keymap))
2269 (defvar gnus-summary-mode-map
2270   (let ((keymap (make-keymap)))
2271     (gnus-suppress-keymap keymap)
2272     keymap))
2273 (defvar gnus-group-mode-map
2274   (let ((keymap (make-keymap)))
2275     (gnus-suppress-keymap keymap)
2276     keymap))
2277
2278 \f
2279
2280 ;; Fix by Hallvard B Furuseth <h.b.furuseth@usit.uio.no>.
2281 ;; If you want the cursor to go somewhere else, set these two
2282 ;; functions in some startup hook to whatever you want.
2283 (defalias 'gnus-summary-position-point 'gnus-goto-colon)
2284 (defalias 'gnus-group-position-point 'gnus-goto-colon)
2285
2286 ;;; Various macros and substs.
2287
2288 (defun gnus-header-from (header)
2289   (mail-header-from header))
2290
2291 (defmacro gnus-gethash (string hashtable)
2292   "Get hash value of STRING in HASHTABLE."
2293   `(symbol-value (intern-soft ,string ,hashtable)))
2294
2295 (defmacro gnus-gethash-safe (string hashtable)
2296   "Get hash value of STRING in HASHTABLE.
2297 Return nil if not defined."
2298   `(let ((sym (intern-soft ,string ,hashtable)))
2299      (and (boundp sym) (symbol-value sym))))
2300
2301 (defmacro gnus-sethash (string value hashtable)
2302   "Set hash value.  Arguments are STRING, VALUE, and HASHTABLE."
2303   `(set (intern ,string ,hashtable) ,value))
2304 (put 'gnus-sethash 'edebug-form-spec '(form form form))
2305
2306 (defmacro gnus-group-unread (group)
2307   "Get the currently computed number of unread articles in GROUP."
2308   `(car (gnus-gethash ,group gnus-newsrc-hashtb)))
2309
2310 (defmacro gnus-group-entry (group)
2311   "Get the newsrc entry for GROUP."
2312   `(gnus-gethash ,group gnus-newsrc-hashtb))
2313
2314 (defmacro gnus-active (group)
2315   "Get active info on GROUP."
2316   `(gnus-gethash ,group gnus-active-hashtb))
2317
2318 (defmacro gnus-set-active (group active)
2319   "Set GROUP's active info."
2320   `(gnus-sethash ,group ,active gnus-active-hashtb))
2321
2322 ;; Info access macros.
2323
2324 (defmacro gnus-info-group (info)
2325   `(nth 0 ,info))
2326 (defmacro gnus-info-rank (info)
2327   `(nth 1 ,info))
2328 (defmacro gnus-info-read (info)
2329   `(nth 2 ,info))
2330 (defmacro gnus-info-marks (info)
2331   `(nth 3 ,info))
2332 (defmacro gnus-info-method (info)
2333   `(nth 4 ,info))
2334 (defmacro gnus-info-params (info)
2335   `(nth 5 ,info))
2336
2337 (defmacro gnus-info-level (info)
2338   `(let ((rank (gnus-info-rank ,info)))
2339      (if (consp rank)
2340          (car rank)
2341        rank)))
2342 (defmacro gnus-info-score (info)
2343   `(let ((rank (gnus-info-rank ,info)))
2344      (or (and (consp rank) (cdr rank)) 0)))
2345
2346 (defmacro gnus-info-set-group (info group)
2347   `(setcar ,info ,group))
2348 (defmacro gnus-info-set-rank (info rank)
2349   `(setcar (nthcdr 1 ,info) ,rank))
2350 (defmacro gnus-info-set-read (info read)
2351   `(setcar (nthcdr 2 ,info) ,read))
2352 (defmacro gnus-info-set-marks (info marks &optional extend)
2353   (if extend
2354       `(gnus-info-set-entry ,info ,marks 3)
2355     `(setcar (nthcdr 3 ,info) ,marks)))
2356 (defmacro gnus-info-set-method (info method &optional extend)
2357   (if extend
2358       `(gnus-info-set-entry ,info ,method 4)
2359     `(setcar (nthcdr 4 ,info) ,method)))
2360 (defmacro gnus-info-set-params (info params &optional extend)
2361   (if extend
2362       `(gnus-info-set-entry ,info ,params 5)
2363     `(setcar (nthcdr 5 ,info) ,params)))
2364
2365 (defun gnus-info-set-entry (info entry number)
2366   ;; Extend the info until we have enough elements.
2367   (while (<= (length info) number)
2368     (nconc info (list nil)))
2369   ;; Set the entry.
2370   (setcar (nthcdr number info) entry))
2371
2372 (defmacro gnus-info-set-level (info level)
2373   `(let ((rank (cdr ,info)))
2374      (if (consp (car rank))
2375          (setcar (car rank) ,level)
2376        (setcar rank ,level))))
2377 (defmacro gnus-info-set-score (info score)
2378   `(let ((rank (cdr ,info)))
2379      (if (consp (car rank))
2380          (setcdr (car rank) ,score)
2381        (setcar rank (cons (car rank) ,score)))))
2382
2383 (defmacro gnus-get-info (group)
2384   `(nth 2 (gnus-gethash ,group gnus-newsrc-hashtb)))
2385
2386 ;;; Load the compatability functions.
2387
2388 (require 'gnus-ems)
2389
2390 \f
2391 ;;;
2392 ;;; Shutdown
2393 ;;;
2394
2395 (defvar gnus-shutdown-alist nil)
2396
2397 (defun gnus-add-shutdown (function &rest symbols)
2398   "Run FUNCTION whenever one of SYMBOLS is shut down."
2399   (push (cons function symbols) gnus-shutdown-alist))
2400
2401 (defun gnus-shutdown (symbol)
2402   "Shut down everything that waits for SYMBOL."
2403   (let ((alist gnus-shutdown-alist)
2404         entry)
2405     (while (setq entry (pop alist))
2406       (when (memq symbol (cdr entry))
2407         (funcall (car entry))))))
2408
2409 \f
2410 ;;;
2411 ;;; Gnus Utility Functions
2412 ;;;
2413
2414 (defun gnus-find-subscribed-addresses ()
2415   "Return a regexp matching the addresses of all subscribed mail groups.
2416 It consists of the `to-address' or `to-list' parameter of all groups
2417 with a `subscribed' parameter."
2418   (let (group address addresses)
2419     (dolist (entry (cdr gnus-newsrc-alist))
2420       (setq group (car entry))
2421       (when (gnus-parameter-subscribed group)
2422         (setq address (mail-strip-quoted-names
2423                        (or (gnus-group-fast-parameter group 'to-address)
2424                            (gnus-group-fast-parameter group 'to-list))))
2425         (when address
2426           (push address addresses))))
2427     (when addresses
2428       (list (mapconcat 'regexp-quote addresses "\\|")))))
2429
2430 (defmacro gnus-string-or (&rest strings)
2431   "Return the first element of STRINGS that is a non-blank string.
2432 STRINGS will be evaluated in normal `or' order."
2433   `(gnus-string-or-1 ',strings))
2434
2435 (defun gnus-string-or-1 (strings)
2436   (let (string)
2437     (while strings
2438       (setq string (eval (pop strings)))
2439       (if (string-match "^[ \t]*$" string)
2440           (setq string nil)
2441         (setq strings nil)))
2442     string))
2443
2444 (defun gnus-version (&optional arg)
2445   "Version number of this version of Gnus.
2446 If ARG, insert string at point."
2447   (interactive "P")
2448   (if arg
2449       (insert (message gnus-version))
2450     (message gnus-version)))
2451
2452 (defun gnus-continuum-version (&optional version)
2453   "Return VERSION as a floating point number."
2454   (interactive)
2455   (unless version
2456     (setq version gnus-version))
2457   (when (or (string-match "^\\([^ ]+\\)? ?Gnus v?\\([0-9.]+\\)$" version)
2458             (string-match "^\\(.?\\)gnus-\\([0-9.]+\\)$" version))
2459     (let ((alpha (and (match-beginning 1) (match-string 1 version)))
2460           (number (match-string 2 version))
2461           major minor least)
2462       (unless (string-match
2463                "\\([0-9]\\)\\.\\([0-9]+\\)\\.?\\([0-9]+\\)?" number)
2464         (error "Invalid version string: %s" version))
2465       (setq major (string-to-number (match-string 1 number))
2466             minor (string-to-number (match-string 2 number))
2467             least (if (match-beginning 3)
2468                       (string-to-number (match-string 3 number))
2469                     0))
2470       (string-to-number
2471        (if (zerop major)
2472              (format "%s00%02d%02d"
2473                      (if (member alpha '("(ding)" "d"))
2474                          "4.99"
2475                        (+ 5 (* 0.02
2476                                (abs
2477                                 (- (mm-char-int (aref (downcase alpha) 0))
2478                                    (mm-char-int ?t))))
2479                           -0.01))
2480                      minor least)
2481          (format "%d.%02d%02d" major minor least))))))
2482
2483 (defun gnus-info-find-node (&optional nodename)
2484   "Find Info documentation of Gnus."
2485   (interactive)
2486   ;; Enlarge info window if needed.
2487   (let (gnus-info-buffer)
2488     (Info-goto-node (or nodename (cadr (assq major-mode gnus-info-nodes))))
2489     (setq gnus-info-buffer (current-buffer))
2490     (gnus-configure-windows 'info)))
2491
2492 ;;;
2493 ;;; gnus-interactive
2494 ;;;
2495
2496 (defvar gnus-current-prefix-symbol nil
2497   "Current prefix symbol.")
2498
2499 (defvar gnus-current-prefix-symbols nil
2500   "List of current prefix symbols.")
2501
2502 (defun gnus-interactive (string &optional params)
2503   "Return a list that can be fed to `interactive'.
2504 See `interactive' for full documentation.
2505
2506 Adds the following specs:
2507
2508 y -- The current symbolic prefix.
2509 Y -- A list of the current symbolic prefix(es).
2510 A -- Article number.
2511 H -- Article header.
2512 g -- Group name."
2513   (let ((i 0)
2514         out c prompt)
2515     (while (< i (length string))
2516       (string-match ".\\([^\n]*\\)\n?" string i)
2517       (setq c (aref string i))
2518       (when (match-end 1)
2519         (setq prompt (match-string 1 string)))
2520       (setq i (match-end 0))
2521       ;; We basically emulate just about everything that
2522       ;; `interactive' does, but add the specs listed above.
2523       (push
2524        (cond
2525         ((= c ?a)
2526          (completing-read prompt obarray 'fboundp t))
2527         ((= c ?b)
2528          (read-buffer prompt (current-buffer) t))
2529         ((= c ?B)
2530          (read-buffer prompt (other-buffer (current-buffer))))
2531         ((= c ?c)
2532          (read-char))
2533         ((= c ?C)
2534          (completing-read prompt obarray 'commandp t))
2535         ((= c ?d)
2536          (point))
2537         ((= c ?D)
2538          (read-file-name prompt nil default-directory 'lambda))
2539         ((= c ?f)
2540          (read-file-name prompt nil nil 'lambda))
2541         ((= c ?F)
2542          (read-file-name prompt))
2543         ((= c ?k)
2544          (read-key-sequence prompt))
2545         ((= c ?K)
2546          (error "Not implemented spec"))
2547         ((= c ?e)
2548          (error "Not implemented spec"))
2549         ((= c ?m)
2550          (mark))
2551         ((= c ?N)
2552          (error "Not implemented spec"))
2553         ((= c ?n)
2554          (string-to-number (read-from-minibuffer prompt)))
2555         ((= c ?p)
2556          (prefix-numeric-value current-prefix-arg))
2557         ((= c ?P)
2558          current-prefix-arg)
2559         ((= c ?r)
2560          'gnus-prefix-nil)
2561         ((= c ?s)
2562          (read-string prompt))
2563         ((= c ?S)
2564          (intern (read-string prompt)))
2565         ((= c ?v)
2566          (read-variable prompt))
2567         ((= c ?x)
2568          (read-minibuffer prompt))
2569         ((= c ?x)
2570          (eval-minibuffer prompt))
2571         ;; And here the new specs come.
2572         ((= c ?y)
2573          gnus-current-prefix-symbol)
2574         ((= c ?Y)
2575          gnus-current-prefix-symbols)
2576         ((= c ?g)
2577          (gnus-group-group-name))
2578         ((= c ?A)
2579          (gnus-summary-skip-intangible)
2580          (or (get-text-property (point) 'gnus-number)
2581              (gnus-summary-last-subject)))
2582         ((= c ?H)
2583          (gnus-data-header (gnus-data-find (gnus-summary-article-number))))
2584         (t
2585          (error "Non-implemented spec")))
2586        out)
2587       (cond
2588        ((= c ?r)
2589         (push (if (< (point) (mark)) (point) (mark)) out)
2590         (push (if (> (point) (mark)) (point) (mark)) out))))
2591     (setq out (delq 'gnus-prefix-nil out))
2592     (nreverse out)))
2593
2594 (defun gnus-symbolic-argument (&optional arg)
2595   "Read a symbolic argument and a command, and then execute command."
2596   (interactive "P")
2597   (let* ((in-command (this-command-keys))
2598          (command in-command)
2599          gnus-current-prefix-symbols
2600          gnus-current-prefix-symbol
2601          syms)
2602     (while (equal in-command command)
2603       (message "%s-" (key-description (this-command-keys)))
2604       (push (intern (char-to-string (read-char))) syms)
2605       (setq command (read-key-sequence nil t)))
2606     (setq gnus-current-prefix-symbols (nreverse syms)
2607           gnus-current-prefix-symbol (car gnus-current-prefix-symbols))
2608     (call-interactively (key-binding command t))))
2609
2610 ;;; More various functions.
2611
2612 (defsubst gnus-check-backend-function (func group)
2613   "Check whether GROUP supports function FUNC.
2614 GROUP can either be a string (a group name) or a select method."
2615   (ignore-errors
2616     (let ((method (if (stringp group)
2617                       (car (gnus-find-method-for-group group))
2618                     group)))
2619       (unless (featurep method)
2620         (require method))
2621       (fboundp (intern (format "%s-%s" method func))))))
2622
2623 (defun gnus-group-read-only-p (&optional group)
2624   "Check whether GROUP supports editing or not.
2625 If GROUP is nil, `gnus-newsgroup-name' will be checked instead.  Note
2626 that that variable is buffer-local to the summary buffers."
2627   (let ((group (or group gnus-newsgroup-name)))
2628     (not (gnus-check-backend-function 'request-replace-article group))))
2629
2630 (defun gnus-virtual-group-p (group)
2631   "Say whether GROUP is virtual or not."
2632   (memq 'virtual (assoc (symbol-name (car (gnus-find-method-for-group group)))
2633                         gnus-valid-select-methods)))
2634
2635 (defun gnus-news-group-p (group &optional article)
2636   "Return non-nil if GROUP (and ARTICLE) come from a news server."
2637   (cond ((gnus-member-of-valid 'post group) ;Ordinary news group
2638          t)                             ;is news of course.
2639         ((not (gnus-member-of-valid 'post-mail group)) ;Non-combined.
2640          nil)                           ;must be mail then.
2641         ((vectorp article)              ;Has header info.
2642          (eq (gnus-request-type group (mail-header-id article)) 'news))
2643         ((null article)                 ;Hasn't header info
2644          (eq (gnus-request-type group) 'news)) ;(unknown ==> mail)
2645         ((< article 0)                  ;Virtual message
2646          nil)                           ;we don't know, guess mail.
2647         (t                              ;Has positive number
2648          (eq (gnus-request-type group article) 'news)))) ;use it.
2649
2650 ;; Returns a list of writable groups.
2651 (defun gnus-writable-groups ()
2652   (let ((alist gnus-newsrc-alist)
2653         groups group)
2654     (while (setq group (car (pop alist)))
2655       (unless (gnus-group-read-only-p group)
2656         (push group groups)))
2657     (nreverse groups)))
2658
2659 ;; Check whether to use long file names.
2660 (defun gnus-use-long-file-name (symbol)
2661   ;; The variable has to be set...
2662   (and gnus-use-long-file-name
2663        ;; If it isn't a list, then we return t.
2664        (or (not (listp gnus-use-long-file-name))
2665            ;; If it is a list, and the list contains `symbol', we
2666            ;; return nil.
2667            (not (memq symbol gnus-use-long-file-name)))))
2668
2669 ;; Generate a unique new group name.
2670 (defun gnus-generate-new-group-name (leaf)
2671   (let ((name leaf)
2672         (num 0))
2673     (while (gnus-gethash name gnus-newsrc-hashtb)
2674       (setq name (concat leaf "<" (int-to-string (setq num (1+ num))) ">")))
2675     name))
2676
2677 (defun gnus-ephemeral-group-p (group)
2678   "Say whether GROUP is ephemeral or not."
2679   (gnus-group-get-parameter group 'quit-config t))
2680
2681 (defun gnus-group-quit-config (group)
2682   "Return the quit-config of GROUP."
2683   (gnus-group-get-parameter group 'quit-config t))
2684
2685 (defun gnus-kill-ephemeral-group (group)
2686   "Remove ephemeral GROUP from relevant structures."
2687   (gnus-sethash group nil gnus-newsrc-hashtb))
2688
2689 (defun gnus-simplify-mode-line ()
2690   "Make mode lines a bit simpler."
2691   (setq mode-line-modified (cdr gnus-mode-line-modified))
2692   (when (listp mode-line-format)
2693     (make-local-variable 'mode-line-format)
2694     (setq mode-line-format (copy-sequence mode-line-format))
2695     (when (equal (nth 3 mode-line-format) "   ")
2696       (setcar (nthcdr 3 mode-line-format) " "))))
2697
2698 ;;; Servers and groups.
2699
2700 (defsubst gnus-server-add-address (method)
2701   (let ((method-name (symbol-name (car method))))
2702     (if (and (memq 'address (assoc method-name gnus-valid-select-methods))
2703              (not (assq (intern (concat method-name "-address")) method))
2704              (memq 'physical-address (assq (car method)
2705                                            gnus-valid-select-methods)))
2706         (append method (list (list (intern (concat method-name "-address"))
2707                                    (nth 1 method))))
2708       method)))
2709
2710 (defsubst gnus-server-to-method (server)
2711   "Map virtual server names to select methods."
2712   (or (and server (listp server) server)
2713       (cdr (assoc server gnus-server-method-cache))
2714       (let ((result
2715              (or
2716               ;; Perhaps this is the native server?
2717               (and (equal server "native") gnus-select-method)
2718               ;; It should be in the server alist.
2719               (cdr (assoc server gnus-server-alist))
2720               ;; It could be in the predefined server alist.
2721               (cdr (assoc server gnus-predefined-server-alist))
2722               ;; If not, we look through all the opened server
2723               ;; to see whether we can find it there.
2724               (let ((opened gnus-opened-servers))
2725                 (while (and opened
2726                             (not (equal server (format "%s:%s" (caaar opened)
2727                                                        (cadaar opened)))))
2728                   (pop opened))
2729                 (caar opened))
2730               ;; It could be a named method, search all servers
2731               (let ((servers gnus-secondary-select-methods))
2732                 (while (and servers
2733                             (not (equal server (format "%s:%s" (caar servers)
2734                                                        (cadar servers)))))
2735                   (pop servers))
2736                 (car servers)))))
2737         (push (cons server result) gnus-server-method-cache)
2738         result)))
2739
2740 (defsubst gnus-server-get-method (group method)
2741   ;; Input either a server name, and extended server name, or a
2742   ;; select method, and return a select method.
2743   (cond ((stringp method)
2744          (gnus-server-to-method method))
2745         ((equal method gnus-select-method)
2746          gnus-select-method)
2747         ((and (stringp (car method))
2748               group)
2749          (gnus-server-extend-method group method))
2750         ((and method
2751               (not group)
2752               (equal (cadr method) ""))
2753          method)
2754         (t
2755          (gnus-server-add-address method))))
2756
2757 (defmacro gnus-method-equal (ss1 ss2)
2758   "Say whether two servers are equal."
2759   `(let ((s1 ,ss1)
2760          (s2 ,ss2))
2761      (or (equal s1 s2)
2762          (and (= (length s1) (length s2))
2763               (progn
2764                 (while (and s1 (member (car s1) s2))
2765                   (setq s1 (cdr s1)))
2766                 (null s1))))))
2767
2768 (defun gnus-methods-equal-p (m1 m2)
2769   (let ((m1 (or m1 gnus-select-method))
2770         (m2 (or m2 gnus-select-method)))
2771     (or (equal m1 m2)
2772         (and (eq (car m1) (car m2))
2773              (or (not (memq 'address (assoc (symbol-name (car m1))
2774                                             gnus-valid-select-methods)))
2775                  (equal (nth 1 m1) (nth 1 m2)))))))
2776
2777 (defun gnus-server-equal (m1 m2)
2778   "Say whether two methods are equal."
2779   (let ((m1 (cond ((null m1) gnus-select-method)
2780                   ((stringp m1) (gnus-server-to-method m1))
2781                   (t m1)))
2782         (m2 (cond ((null m2) gnus-select-method)
2783                   ((stringp m2) (gnus-server-to-method m2))
2784                   (t m2))))
2785     (gnus-method-equal m1 m2)))
2786
2787 (defun gnus-servers-using-backend (backend)
2788   "Return a list of known servers using BACKEND."
2789   (let ((opened gnus-opened-servers)
2790         out)
2791     (while opened
2792       (when (eq backend (caaar opened))
2793         (push (caar opened) out))
2794       (pop opened))
2795     out))
2796
2797 (defun gnus-archive-server-wanted-p ()
2798   "Say whether the user wants to use the archive server."
2799   (cond
2800    ((or (not gnus-message-archive-method)
2801         (not gnus-message-archive-group))
2802     nil)
2803    ((and gnus-message-archive-method gnus-message-archive-group)
2804     t)
2805    (t
2806     (let ((active (cadr (assq 'nnfolder-active-file
2807                               gnus-message-archive-method))))
2808       (and active
2809            (file-exists-p active))))))
2810
2811 (defsubst gnus-method-to-server-name (method)
2812   (concat
2813    (format "%s" (car method))
2814    (when (and
2815           (or (assoc (format "%s" (car method))
2816                      (gnus-methods-using 'address))
2817               (gnus-server-equal method gnus-message-archive-method))
2818           (nth 1 method)
2819           (not (string= (nth 1 method) "")))
2820      (concat "+" (nth 1 method)))))
2821
2822 (defsubst gnus-method-to-full-server-name (method)
2823   (format "%s+%s" (car method) (nth 1 method)))
2824
2825 (defun gnus-group-prefixed-name (group method)
2826   "Return the whole name from GROUP and METHOD."
2827   (and (stringp method) (setq method (gnus-server-to-method method)))
2828   (if (or (not method)
2829           (gnus-server-equal method "native")
2830           (string-match ":" group))
2831       group
2832     (concat (gnus-method-to-server-name method) ":" group)))
2833
2834 (defun gnus-group-real-prefix (group)
2835   "Return the prefix of the current group name."
2836   (if (string-match "^[^:]+:" group)
2837       (substring group 0 (match-end 0))
2838     ""))
2839
2840 (defun gnus-group-method (group)
2841   "Return the server or method used for selecting GROUP.
2842 You should probably use `gnus-find-method-for-group' instead."
2843   (let ((prefix (gnus-group-real-prefix group)))
2844     (if (equal prefix "")
2845         gnus-select-method
2846       (let ((servers gnus-opened-servers)
2847             (server "")
2848             backend possible found)
2849         (if (string-match "^[^\\+]+\\+" prefix)
2850             (setq backend (intern (substring prefix 0 (1- (match-end 0))))
2851                   server (substring prefix (match-end 0) (1- (length prefix))))
2852           (setq backend (intern (substring prefix 0 (1- (length prefix))))))
2853         (while servers
2854           (when (eq (caaar servers) backend)
2855             (setq possible (caar servers))
2856             (when (equal (cadaar servers) server)
2857               (setq found (caar servers))))
2858           (pop servers))
2859         (or (car (rassoc found gnus-server-alist))
2860             found
2861             (car (rassoc possible gnus-server-alist))
2862             possible
2863             (list backend server))))))
2864
2865 (defsubst gnus-native-method-p (method)
2866   "Return whether METHOD is the native select method."
2867   (gnus-method-equal method gnus-select-method))
2868
2869 (defsubst gnus-secondary-method-p (method)
2870   "Return whether METHOD is a secondary select method."
2871   (let ((methods gnus-secondary-select-methods)
2872         (gmethod (gnus-server-get-method nil method)))
2873     (while (and methods
2874                 (not (gnus-method-equal
2875                       (gnus-server-get-method nil (car methods))
2876                       gmethod)))
2877       (setq methods (cdr methods)))
2878     methods))
2879
2880 (defun gnus-method-simplify (method)
2881   "Return the shortest uniquely identifying string or method for METHOD."
2882   (cond ((stringp method)
2883          method)
2884         ((gnus-native-method-p method)
2885          nil)
2886         ((gnus-secondary-method-p method)
2887          (format "%s:%s" (nth 0 method) (nth 1 method)))
2888         (t
2889          method)))
2890
2891 (defun gnus-groups-from-server (server)
2892   "Return a list of all groups that are fetched from SERVER."
2893   (let ((alist (cdr gnus-newsrc-alist))
2894         info groups)
2895     (while (setq info (pop alist))
2896       (when (gnus-server-equal (gnus-info-method info) server)
2897         (push (gnus-info-group info) groups)))
2898     (sort groups 'string<)))
2899
2900 (defun gnus-group-foreign-p (group)
2901   "Say whether a group is foreign or not."
2902   (and (not (gnus-group-native-p group))
2903        (not (gnus-group-secondary-p group))))
2904
2905 (defun gnus-group-native-p (group)
2906   "Say whether the group is native or not."
2907   (not (string-match ":" group)))
2908
2909 (defun gnus-group-secondary-p (group)
2910   "Say whether the group is secondary or not."
2911   (gnus-secondary-method-p (gnus-find-method-for-group group)))
2912
2913 (defun gnus-parameters-get-parameter (group)
2914   "Return the group parameters for GROUP from `gnus-parameters'."
2915   (let (params-list)
2916     (dolist (elem gnus-parameters)
2917       (when (string-match (car elem) group)
2918         (setq params-list
2919               (nconc (gnus-expand-group-parameters
2920                       (car elem) (cdr elem) group)
2921                      params-list))))
2922     params-list))
2923
2924 (defun gnus-expand-group-parameter (match value group)
2925   "Use MATCH to expand VALUE in GROUP."
2926   (with-temp-buffer
2927     (insert group)
2928     (goto-char (point-min))
2929     (while (re-search-forward match nil t)
2930       (replace-match value))
2931     (buffer-string)))
2932
2933 (defun gnus-expand-group-parameters (match parameters group)
2934   "Go through PARAMETERS and expand them according to the match data."
2935   (let (new)
2936     (dolist (elem parameters)
2937       (if (and (stringp (cdr elem))
2938                (string-match "\\\\[0-9&]" (cdr elem)))
2939           (push (cons (car elem)
2940                       (gnus-expand-group-parameter match (cdr elem) group))
2941                 new)
2942         (push elem new)))
2943     new))
2944
2945 (defun gnus-group-fast-parameter (group symbol &optional allow-list)
2946   "For GROUP, return the value of SYMBOL.
2947
2948 You should call this in the `gnus-group-buffer' buffer.
2949 The function `gnus-group-find-parameter' will do that for you."
2950   ;; The speed trick:  No cons'ing and quit early.
2951   (or (let ((params (funcall gnus-group-get-parameter-function group)))
2952         ;; Start easy, check the "real" group parameters.
2953         (gnus-group-parameter-value params symbol allow-list))
2954       ;; We didn't found it there, try `gnus-parameters'.
2955       (let ((result nil)
2956             (head nil)
2957             (tail gnus-parameters))
2958         ;; A good old-fashioned non-cl loop.
2959         (while tail
2960           (setq head (car tail)
2961                 tail (cdr tail))
2962           ;; The car is regexp matching for matching the group name.
2963           (when (string-match (car head) group)
2964             ;; The cdr is the parameters.
2965             (setq result (gnus-group-parameter-value (cdr head)
2966                                                      symbol allow-list))
2967             (when result
2968               ;; Expand if necessary.
2969               (if (and (stringp result) (string-match "\\\\[0-9&]" result))
2970                   (setq result (gnus-expand-group-parameter (car head)
2971                                                             result group)))
2972               ;; Exit the loop early.
2973               (setq tail nil))))
2974         ;; Done.
2975         result)))
2976
2977 (defun gnus-group-find-parameter (group &optional symbol allow-list)
2978   "Return the group parameters for GROUP.
2979 If SYMBOL, return the value of that symbol in the group parameters.
2980
2981 If you call this function inside a loop, consider using the faster
2982 `gnus-group-fast-parameter' instead."
2983   (save-excursion
2984     (set-buffer gnus-group-buffer)
2985     (if symbol
2986         (gnus-group-fast-parameter group symbol allow-list)
2987       (nconc
2988        (copy-sequence
2989         (funcall gnus-group-get-parameter-function group))
2990        (gnus-parameters-get-parameter group)))))
2991
2992 (defun gnus-group-get-parameter (group &optional symbol allow-list)
2993   "Return the group parameters for GROUP.
2994 If SYMBOL, return the value of that symbol in the group parameters.
2995 Most functions should use `gnus-group-find-parameter', which
2996 also examines the topic parameters."
2997   (let ((params (gnus-info-params (gnus-get-info group))))
2998     (if symbol
2999         (gnus-group-parameter-value params symbol allow-list)
3000       params)))
3001
3002 (defun gnus-group-parameter-value (params symbol &optional allow-list)
3003   "Return the value of SYMBOL in group PARAMS."
3004   ;; We only wish to return group parameters (dotted lists) and
3005   ;; not local variables, which may have the same names.
3006   ;; But first we handle single elements...
3007   (or (car (memq symbol params))
3008       ;; Handle alist.
3009       (let (elem)
3010         (catch 'found
3011           (while (setq elem (pop params))
3012             (when (and (consp elem)
3013                        (eq (car elem) symbol)
3014                        (or allow-list
3015                            (atom (cdr elem))))
3016               (throw 'found (cdr elem))))))))
3017
3018 (defun gnus-group-add-parameter (group param)
3019   "Add parameter PARAM to GROUP."
3020   (let ((info (gnus-get-info group)))
3021     (when info
3022       (gnus-group-remove-parameter group (if (consp param) (car param) param))
3023       ;; Cons the new param to the old one and update.
3024       (gnus-group-set-info (cons param (gnus-info-params info))
3025                            group 'params))))
3026
3027 (defun gnus-group-set-parameter (group name value)
3028   "Set parameter NAME to VALUE in GROUP."
3029   (let ((info (gnus-get-info group)))
3030     (when info
3031       (gnus-group-remove-parameter group name)
3032       (let ((old-params (gnus-info-params info))
3033             (new-params (list (cons name value))))
3034         (while old-params
3035           (when (or (not (listp (car old-params)))
3036                     (not (eq (caar old-params) name)))
3037             (setq new-params (append new-params (list (car old-params)))))
3038           (setq old-params (cdr old-params)))
3039         (gnus-group-set-info new-params group 'params)))))
3040
3041 (defun gnus-group-remove-parameter (group name)
3042   "Remove parameter NAME from GROUP."
3043   (let ((info (gnus-get-info group)))
3044     (when info
3045       (let ((params (gnus-info-params info)))
3046         (when params
3047           (setq params (delq name params))
3048           (while (assq name params)
3049             (gnus-pull name params))
3050           (gnus-info-set-params info params))))))
3051
3052 (defun gnus-group-add-score (group &optional score)
3053   "Add SCORE to the GROUP score.
3054 If SCORE is nil, add 1 to the score of GROUP."
3055   (let ((info (gnus-get-info group)))
3056     (when info
3057       (gnus-info-set-score info (+ (gnus-info-score info) (or score 1))))))
3058
3059 (defun gnus-short-group-name (group &optional levels)
3060   "Collapse GROUP name LEVELS.
3061 Select methods are stripped and any remote host name is stripped down to
3062 just the host name."
3063   (let* ((name "")
3064          (foreign "")
3065          (depth 0)
3066          (skip 1)
3067          (levels (or levels
3068                      gnus-group-uncollapsed-levels
3069                      (progn
3070                        (while (string-match "\\." group skip)
3071                          (setq skip (match-end 0)
3072                                depth (+ depth 1)))
3073                        depth))))
3074     ;; Separate foreign select method from group name and collapse.
3075    ;; If method contains a server, collapse to non-domain server name,
3076     ;; otherwise collapse to select method.
3077     (let* ((colon (string-match ":" group))
3078            (server (and colon (substring group 0 colon)))
3079            (plus (and server (string-match "+" server))))
3080       (when server
3081         (if plus
3082             (setq foreign (substring server (+ 1 plus)
3083                                      (string-match "\\." server))
3084                   group (substring group (+ 1 colon)))
3085           (setq foreign server
3086                 group (substring group (+ 1 colon))))
3087         (setq foreign (concat foreign ":")))
3088       ;; Collapse group name leaving LEVELS uncollapsed elements
3089       (let* ((slist (split-string group "/"))
3090              (slen (length slist))
3091              (dlist (split-string group "\\."))
3092              (dlen (length dlist))
3093              glist
3094              glen
3095              gsep
3096              res)
3097         (if (> slen dlen)
3098             (setq glist slist
3099                   glen slen
3100                   gsep "/")
3101           (setq glist dlist
3102                 glen dlen
3103                 gsep "."))
3104         (setq levels (- glen levels))
3105         (dolist (g glist)
3106           (push (if (>= (decf levels) 0)
3107                     (if (zerop (length g))
3108                         ""
3109                       (substring g 0 1))
3110                   g)
3111                 res))
3112         (concat foreign (mapconcat 'identity (nreverse res) gsep))))))
3113
3114 (defun gnus-narrow-to-body ()
3115   "Narrow to the body of an article."
3116   (narrow-to-region
3117    (progn
3118      (goto-char (point-min))
3119      (or (search-forward "\n\n" nil t)
3120          (point-max)))
3121    (point-max)))
3122
3123 \f
3124 ;;;
3125 ;;; Kill file handling.
3126 ;;;
3127
3128 (defun gnus-apply-kill-file ()
3129   "Apply a kill file to the current newsgroup.
3130 Returns the number of articles marked as read."
3131   (if (or (file-exists-p (gnus-newsgroup-kill-file nil))
3132           (file-exists-p (gnus-newsgroup-kill-file gnus-newsgroup-name)))
3133       (gnus-apply-kill-file-internal)
3134     0))
3135
3136 (defun gnus-kill-save-kill-buffer ()
3137   (let ((file (gnus-newsgroup-kill-file gnus-newsgroup-name)))
3138     (when (get-file-buffer file)
3139       (save-excursion
3140         (set-buffer (get-file-buffer file))
3141         (when (buffer-modified-p)
3142           (save-buffer))
3143         (kill-buffer (current-buffer))))))
3144
3145 (defcustom gnus-kill-file-name "KILL"
3146   "Suffix of the kill files."
3147   :group 'gnus-score-kill
3148   :group 'gnus-score-files
3149   :type 'string)
3150
3151 (defun gnus-newsgroup-kill-file (newsgroup)
3152   "Return the name of a kill file name for NEWSGROUP.
3153 If NEWSGROUP is nil, return the global kill file name instead."
3154   (cond
3155    ;; The global KILL file is placed at top of the directory.
3156    ((or (null newsgroup)
3157         (string-equal newsgroup ""))
3158     (expand-file-name gnus-kill-file-name
3159                       gnus-kill-files-directory))
3160    ;; Append ".KILL" to newsgroup name.
3161    ((gnus-use-long-file-name 'not-kill)
3162     (expand-file-name (concat (gnus-newsgroup-savable-name newsgroup)
3163                               "." gnus-kill-file-name)
3164                       gnus-kill-files-directory))
3165    ;; Place "KILL" under the hierarchical directory.
3166    (t
3167     (expand-file-name (concat (gnus-newsgroup-directory-form newsgroup)
3168                               "/" gnus-kill-file-name)
3169                       gnus-kill-files-directory))))
3170
3171 ;;; Server things.
3172
3173 (defun gnus-member-of-valid (symbol group)
3174   "Find out if GROUP has SYMBOL as part of its \"valid\" spec."
3175   (memq symbol (assoc
3176                 (symbol-name (car (gnus-find-method-for-group group)))
3177                 gnus-valid-select-methods)))
3178
3179 (defun gnus-method-option-p (method option)
3180   "Return non-nil if select METHOD has OPTION as a parameter."
3181   (when (stringp method)
3182     (setq method (gnus-server-to-method method)))
3183   (memq option (assoc (format "%s" (car method))
3184                       gnus-valid-select-methods)))
3185
3186 (defun gnus-similar-server-opened (method)
3187   (let ((opened gnus-opened-servers))
3188     (while (and method opened)
3189       (when (and (equal (cadr method) (cadaar opened))
3190                  (equal (car method) (caaar opened))
3191                  (not (equal method (caar opened))))
3192         (setq method nil))
3193       (pop opened))
3194     (not method)))
3195
3196 (defun gnus-server-extend-method (group method)
3197   ;; This function "extends" a virtual server.  If the server is
3198   ;; "hello", and the select method is ("hello" (my-var "something"))
3199   ;; in the group "alt.alt", this will result in a new virtual server
3200   ;; called "hello+alt.alt".
3201   (if (or (not (inline (gnus-similar-server-opened method)))
3202           (not (cddr method)))
3203       method
3204     `(,(car method) ,(concat (cadr method) "+" group)
3205       (,(intern (format "%s-address" (car method))) ,(cadr method))
3206       ,@(cddr method))))
3207
3208 (defun gnus-server-status (method)
3209   "Return the status of METHOD."
3210   (nth 1 (assoc method gnus-opened-servers)))
3211
3212 (defun gnus-group-name-to-method (group)
3213   "Guess a select method based on GROUP."
3214   (if (string-match ":" group)
3215       (let ((server (substring group 0 (match-beginning 0))))
3216         (if (string-match "\\+" server)
3217             (list (intern (substring server 0 (match-beginning 0)))
3218                   (substring server (match-end 0)))
3219           (list (intern server) "")))
3220     gnus-select-method))
3221
3222 (defun gnus-server-string (server)
3223   "Return a readable string that describes SERVER."
3224   (let* ((server (gnus-server-to-method server))
3225          (address (nth 1 server)))
3226     (if (and address
3227              (not (zerop (length address))))
3228         (format "%s using %s" address (car server))
3229       (format "%s" (car server)))))
3230
3231 (defun gnus-find-method-for-group (group &optional info)
3232   "Find the select method that GROUP uses."
3233   (or gnus-override-method
3234       (and (not group)
3235            gnus-select-method)
3236       (and (not (gnus-group-entry group)) ;; a new group
3237            (gnus-group-name-to-method group))
3238       (let ((info (or info (gnus-get-info group)))
3239             method)
3240         (if (or (not info)
3241                 (not (setq method (gnus-info-method info)))
3242                 (equal method "native"))
3243             gnus-select-method
3244           (setq method
3245                 (cond ((stringp method)
3246                        (inline (gnus-server-to-method method)))
3247                       ((stringp (cadr method))
3248                        (inline (gnus-server-extend-method group method)))
3249                       (t
3250                        method)))
3251           (cond ((equal (cadr method) "")
3252                  method)
3253                 ((null (cadr method))
3254                  (list (car method) ""))
3255                 (t
3256                  (gnus-server-add-address method)))))))
3257
3258 (defun gnus-methods-using (feature)
3259   "Find all methods that have FEATURE."
3260   (let ((valids gnus-valid-select-methods)
3261         outs)
3262     (while valids
3263       (when (memq feature (car valids))
3264         (push (car valids) outs))
3265       (setq valids (cdr valids)))
3266     outs))
3267
3268 (defun gnus-read-group (prompt &optional default)
3269   "Prompt the user for a group name.
3270 Disallow invalid group names."
3271   (let ((prefix "")
3272         group)
3273     (while (not group)
3274       (when (string-match
3275              gnus-invalid-group-regexp
3276              (setq group (read-string (concat prefix prompt)
3277                                       (cons (or default "") 0)
3278                                       'gnus-group-history)))
3279         (setq prefix (format "Invalid group name: \"%s\".  " group)
3280               group nil)))
3281     group))
3282
3283 (defun gnus-read-method (prompt)
3284   "Prompt the user for a method.
3285 Allow completion over sensible values."
3286   (let* ((open-servers
3287           (mapcar (lambda (i) (cons (format "%s:%s" (caar i) (cadar i)) i))
3288                   gnus-opened-servers))
3289          (valid-methods
3290           (let (methods)
3291             (dolist (method gnus-valid-select-methods)
3292               (if (or (memq 'prompt-address method)
3293                       (not (assoc (format "%s:" (car method)) open-servers)))
3294                   (push method methods)))
3295             methods))
3296          (servers
3297           (append valid-methods
3298                   open-servers
3299                   gnus-predefined-server-alist
3300                   gnus-server-alist))
3301          (method
3302           (completing-read
3303            prompt servers
3304            nil t nil 'gnus-method-history)))
3305     (cond
3306      ((equal method "")
3307       (setq method gnus-select-method))
3308      ((assoc method gnus-valid-select-methods)
3309       (let ((address (if (memq 'prompt-address
3310                                (assoc method gnus-valid-select-methods))
3311                          (read-string "Address: ")
3312                        "")))
3313         (or (cadr (assoc (format "%s:%s" method address) open-servers))
3314             (list (intern method) address))))
3315      ((assoc method servers)
3316       method)
3317      (t
3318       (list (intern method) "")))))
3319
3320 ;;; Agent functions
3321
3322 (defun gnus-agent-method-p (method)
3323   "Say whether METHOD is covered by the agent."
3324   (member method gnus-agent-covered-methods))
3325
3326 (defun gnus-online (method)
3327   (not
3328    (if gnus-plugged
3329        (eq (cadr (assoc method gnus-opened-servers)) 'offline)
3330      (gnus-agent-method-p method))))
3331
3332 ;;; User-level commands.
3333
3334 ;;;###autoload
3335 (defun gnus-slave-no-server (&optional arg)
3336   "Read network news as a slave, without connecting to the local server."
3337   (interactive "P")
3338   (gnus-no-server arg t))
3339
3340 ;;;###autoload
3341 (defun gnus-no-server (&optional arg slave)
3342   "Read network news.
3343 If ARG is a positive number, Gnus will use that as the startup
3344 level. If ARG is nil, Gnus will be started at level 2.  If ARG is
3345 non-nil and not a positive number, Gnus will prompt the user for the
3346 name of an NNTP server to use.
3347 As opposed to `gnus', this command will not connect to the local
3348 server."
3349   (interactive "P")
3350   (gnus-no-server-1 arg slave))
3351
3352 ;;;###autoload
3353 (defun gnus-slave (&optional arg)
3354   "Read news as a slave."
3355   (interactive "P")
3356   (gnus arg nil 'slave))
3357
3358 ;;;###autoload
3359 (defun gnus-other-frame (&optional arg)
3360   "Pop up a frame to read news."
3361   (interactive "P")
3362   (let ((window (get-buffer-window gnus-group-buffer)))
3363     (cond (window
3364            (select-frame (window-frame window)))
3365           (t
3366            (select-frame (make-frame)))))
3367   (gnus arg))
3368
3369 ;;(setq thing ?                         ; this is a comment
3370 ;;      more 'yes)
3371
3372 ;;;###autoload
3373 (defun gnus (&optional arg dont-connect slave)
3374   "Read network news.
3375 If ARG is non-nil and a positive number, Gnus will use that as the
3376 startup level.  If ARG is non-nil and not a positive number, Gnus will
3377 prompt the user for the name of an NNTP server to use."
3378   (interactive "P")
3379   (unless (byte-code-function-p (symbol-function 'gnus))
3380     (message "You should byte-compile Gnus")
3381     (sit-for 2))
3382   (gnus-1 arg dont-connect slave))
3383
3384 ;; Allow redefinition of Gnus functions.
3385
3386 (gnus-ems-redefine)
3387
3388 (provide 'gnus)
3389
3390 ;;; gnus.el ends here