*** empty log message ***
[gnus] / lisp / gnus-load.el
1 ;;; gnus-load.el --- various Gnus variables
2 ;; Copyright (C) 1996 Free Software Foundation, Inc.
3
4 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
5 ;; Keywords: news
6
7 ;; This file is part of GNU Emacs.
8
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
12 ;; any later version.
13
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 ;; GNU General Public License for more details.
18
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
23
24 ;;; Commentary:
25
26 ;;; Code:
27
28 (require 'gnus-util)
29 (require 'nnheader)
30
31 (defvar gnus-directory (or (getenv "SAVEDIR") "~/News/")
32   "*Directory variable from which all other Gnus file variables are derived.")
33
34 (defvar gnus-default-directory nil
35   "*Default directory for all Gnus buffers.")
36
37 ;; Site dependent variables.  These variables should be defined in
38 ;; paths.el.
39
40 (defvar gnus-default-nntp-server nil
41   "Specify a default NNTP server.
42 This variable should be defined in paths.el, and should never be set
43 by the user.
44 If you want to change servers, you should use `gnus-select-method'.
45 See the documentation to that variable.")
46
47 ;; Don't touch this variable.
48 (defvar gnus-nntp-service "nntp"
49   "*NNTP service name (\"nntp\" or 119).
50 This is an obsolete variable, which is scarcely used.  If you use an
51 nntp server for your newsgroup and want to change the port number
52 used to 899, you would say something along these lines:
53
54  (setq gnus-select-method '(nntp \"my.nntp.server\" (nntp-port-number 899)))")
55
56 (defvar gnus-nntpserver-file "/etc/nntpserver"
57   "*A file with only the name of the nntp server in it.")
58
59 ;; This function is used to check both the environment variable
60 ;; NNTPSERVER and the /etc/nntpserver file to see whether one can find
61 ;; an nntp server name default.
62 (defun gnus-getenv-nntpserver ()
63   (or (getenv "NNTPSERVER")
64       (and (file-readable-p gnus-nntpserver-file)
65            (save-excursion
66              (set-buffer (get-buffer-create " *gnus nntp*"))
67              (buffer-disable-undo (current-buffer))
68              (insert-file-contents gnus-nntpserver-file)
69              (let ((name (buffer-string)))
70                (prog1
71                    (if (string-match "^[ \t\n]*$" name)
72                        nil
73                      name)
74                  (kill-buffer (current-buffer))))))))
75
76 (defvar gnus-select-method
77   (nconc
78    (list 'nntp (or (condition-case ()
79                        (gnus-getenv-nntpserver)
80                      (error nil))
81                    (if (and gnus-default-nntp-server
82                             (not (string= gnus-default-nntp-server "")))
83                        gnus-default-nntp-server)
84                    (system-name)))
85    (if (or (null gnus-nntp-service)
86            (equal gnus-nntp-service "nntp"))
87        nil
88      (list gnus-nntp-service)))
89   "*Default method for selecting a newsgroup.
90 This variable should be a list, where the first element is how the
91 news is to be fetched, the second is the address.
92
93 For instance, if you want to get your news via NNTP from
94 \"flab.flab.edu\", you could say:
95
96 (setq gnus-select-method '(nntp \"flab.flab.edu\"))
97
98 If you want to use your local spool, say:
99
100 (setq gnus-select-method (list 'nnspool (system-name)))
101
102 If you use this variable, you must set `gnus-nntp-server' to nil.
103
104 There is a lot more to know about select methods and virtual servers -
105 see the manual for details.")
106
107 (defvar gnus-message-archive-method 
108   `(nnfolder
109     "archive"
110     (nnfolder-directory ,(nnheader-concat message-directory "archive"))
111     (nnfolder-active-file 
112      ,(nnheader-concat message-directory "archive/active"))
113     (nnfolder-get-new-mail nil)
114     (nnfolder-inhibit-expiry t))
115   "*Method used for archiving messages you've sent.
116 This should be a mail method.
117
118 It's probably not a very effective to change this variable once you've
119 run Gnus once.  After doing that, you must edit this server from the
120 server buffer.")
121
122 (defvar gnus-message-archive-group nil
123   "*Name of the group in which to save the messages you've written.
124 This can either be a string, a list of strings; or an alist
125 of regexps/functions/forms to be evaluated to return a string (or a list
126 of strings).  The functions are called with the name of the current
127 group (or nil) as a parameter.
128
129 If you want to save your mail in one group and the news articles you
130 write in another group, you could say something like:
131
132  \(setq gnus-message-archive-group 
133         '((if (message-news-p)
134               \"misc-news\" 
135             \"misc-mail\")))
136
137 Normally the group names returned by this variable should be
138 unprefixed -- which implictly means \"store on the archive server\".
139 However, you may wish to store the message on some other server.  In
140 that case, just return a fully prefixed name of the group --
141 \"nnml+private:mail.misc\", for instance.")
142
143 (defvar gnus-secondary-servers nil
144   "*List of NNTP servers that the user can choose between interactively.
145 To make Gnus query you for a server, you have to give `gnus' a
146 non-numeric prefix - `C-u M-x gnus', in short.")
147
148 (defvar gnus-nntp-server nil
149   "*The name of the host running the NNTP server.
150 This variable is semi-obsolete.  Use the `gnus-select-method'
151 variable instead.")
152
153 (defvar gnus-secondary-select-methods nil
154   "*A list of secondary methods that will be used for reading news.
155 This is a list where each element is a complete select method (see
156 `gnus-select-method').
157
158 If, for instance, you want to read your mail with the nnml backend,
159 you could set this variable:
160
161 (setq gnus-secondary-select-methods '((nnml \"\")))")
162
163 (defvar gnus-backup-default-subscribed-newsgroups
164   '("news.announce.newusers" "news.groups.questions" "gnu.emacs.gnus")
165   "Default default new newsgroups the first time Gnus is run.
166 Should be set in paths.el, and shouldn't be touched by the user.")
167
168 (defvar gnus-local-domain nil
169   "Local domain name without a host name.
170 The DOMAINNAME environment variable is used instead if it is defined.
171 If the `system-name' function returns the full Internet name, there is
172 no need to set this variable.")
173
174 (defvar gnus-local-organization nil
175   "String with a description of what organization (if any) the user belongs to.
176 The ORGANIZATION environment variable is used instead if it is defined.
177 If this variable contains a function, this function will be called
178 with the current newsgroup name as the argument.  The function should
179 return a string.
180
181 In any case, if the string (either in the variable, in the environment
182 variable, or returned by the function) is a file name, the contents of
183 this file will be used as the organization.")
184
185 ;; Customization variables
186
187 (defvar gnus-refer-article-method nil
188   "*Preferred method for fetching an article by Message-ID.
189 If you are reading news from the local spool (with nnspool), fetching
190 articles by Message-ID is painfully slow.  By setting this method to an
191 nntp method, you might get acceptable results.
192
193 The value of this variable must be a valid select method as discussed
194 in the documentation of `gnus-select-method'.")
195
196 (defvar gnus-group-faq-directory
197   '("/ftp@mirrors.aol.com:/pub/rtfm/usenet/"
198     "/ftp@sunsite.auc.dk:/pub/usenet/"
199     "/ftp@sunsite.doc.ic.ac.uk:/pub/usenet/news-faqs/"
200     "/ftp@src.doc.ic.ac.uk:/usenet/news-FAQS/"
201     "/ftp@ftp.seas.gwu.edu:/pub/rtfm/"
202     "/ftp@rtfm.mit.edu:/pub/usenet/"
203     "/ftp@ftp.uni-paderborn.de:/pub/FAQ/"
204     "/ftp@ftp.sunet.se:/pub/usenet/"
205     "/ftp@nctuccca.edu.tw:/USENET/FAQ/"
206     "/ftp@hwarang.postech.ac.kr:/pub/usenet/"
207     "/ftp@ftp.hk.super.net:/mirror/faqs/")
208   "*Directory where the group FAQs are stored.
209 This will most commonly be on a remote machine, and the file will be
210 fetched by ange-ftp.
211
212 This variable can also be a list of directories.  In that case, the
213 first element in the list will be used by default.  The others can
214 be used when being prompted for a site.
215
216 Note that Gnus uses an aol machine as the default directory.  If this
217 feels fundamentally unclean, just think of it as a way to finally get
218 something of value back from them.
219
220 If the default site is too slow, try one of these:
221
222    North America: mirrors.aol.com                /pub/rtfm/usenet
223                   ftp.seas.gwu.edu               /pub/rtfm
224                   rtfm.mit.edu                   /pub/usenet
225    Europe:        ftp.uni-paderborn.de           /pub/FAQ
226                   src.doc.ic.ac.uk               /usenet/news-FAQS
227                   ftp.sunet.se                   /pub/usenet
228                   sunsite.auc.dk                 /pub/usenet
229    Asia:          nctuccca.edu.tw                /USENET/FAQ
230                   hwarang.postech.ac.kr          /pub/usenet
231                   ftp.hk.super.net               /mirror/faqs")
232
233 (defvar gnus-use-cross-reference t
234   "*Non-nil means that cross referenced articles will be marked as read.
235 If nil, ignore cross references.  If t, mark articles as read in
236 subscribed newsgroups.  If neither t nor nil, mark as read in all
237 newsgroups.")
238
239 (defvar gnus-process-mark ?#
240   "*Process mark.")
241
242 (defvar gnus-asynchronous nil
243   "*If non-nil, Gnus will supply backends with data needed for async article fetching.")
244
245 (defvar gnus-large-newsgroup 200
246   "*The number of articles which indicates a large newsgroup.
247 If the number of articles in a newsgroup is greater than this value,
248 confirmation is required for selecting the newsgroup.")
249
250 (defvar gnus-use-long-file-name (not (memq system-type '(usg-unix-v xenix)))
251   "*Non-nil means that the default name of a file to save articles in is the group name.
252 If it's nil, the directory form of the group name is used instead.
253
254 If this variable is a list, and the list contains the element
255 `not-score', long file names will not be used for score files; if it
256 contains the element `not-save', long file names will not be used for
257 saving; and if it contains the element `not-kill', long file names
258 will not be used for kill files.
259
260 Note that the default for this variable varies according to what system
261 type you're using.  On `usg-unix-v' and `xenix' this variable defaults
262 to nil while on all other systems it defaults to t.")
263
264 (defvar gnus-kill-files-directory gnus-directory
265   "*Name of the directory where kill files will be stored (default \"~/News\").")
266
267 (defvar gnus-save-score nil
268   "*If non-nil, save group scoring info.")
269
270 (defvar gnus-use-undo t
271   "*If non-nil, allow undoing in Gnus group mode buffers.")
272
273 (defvar gnus-use-adaptive-scoring nil
274   "*If non-nil, use some adaptive scoring scheme.
275 If a list, then the values `word' and `line' are meaningful.  The
276 former will perform adaption on individual words in the subject
277 header while `line' will perform adaption on several headers.")
278
279 (defvar gnus-use-cache 'passive
280   "*If nil, Gnus will ignore the article cache.
281 If `passive', it will allow entering (and reading) articles
282 explicitly entered into the cache.  If anything else, use the
283 cache to the full extent of the law.")
284
285 (defvar gnus-use-trees nil
286   "*If non-nil, display a thread tree buffer.")
287
288 (defvar gnus-use-grouplens nil
289   "*If non-nil, use GroupLens ratings.")
290
291 (defvar gnus-keep-backlog nil
292   "*If non-nil, Gnus will keep read articles for later re-retrieval.
293 If it is a number N, then Gnus will only keep the last N articles
294 read.  If it is neither nil nor a number, Gnus will keep all read
295 articles.  This is not a good idea.")
296
297 (defvar gnus-use-nocem nil
298   "*If non-nil, Gnus will read NoCeM cancel messages.")
299
300 (defvar gnus-suppress-duplicates nil
301   "*If non-nil, Gnus will mark duplicate copies of the same article as read.")
302
303 (defvar gnus-use-demon nil
304   "If non-nil, Gnus might use some demons.")
305
306 (defvar gnus-use-scoring t
307   "*If non-nil, enable scoring.")
308
309 (defvar gnus-use-picons nil
310   "*If non-nil, display picons.")
311
312 (defvar gnus-summary-prepare-exit-hook nil
313   "*A hook called when preparing to exit from the summary buffer.
314 It calls `gnus-summary-expire-articles' by default.")
315 (add-hook 'gnus-summary-prepare-exit-hook 'gnus-summary-expire-articles)
316
317 (defvar gnus-novice-user t
318   "*Non-nil means that you are a usenet novice.
319 If non-nil, verbose messages may be displayed and confirmations may be
320 required.")
321
322 (defvar gnus-expert-user nil
323   "*Non-nil means that you will never be asked for confirmation about anything.
324 And that means *anything*.")
325
326 (defvar gnus-interactive-catchup t
327   "*If non-nil, require your confirmation when catching up a group.")
328
329 (defvar gnus-interactive-exit t
330   "*If non-nil, require your confirmation when exiting Gnus.")
331
332 (defvar gnus-extract-address-components 'gnus-extract-address-components
333   "*Function for extracting address components from a From header.
334 Two pre-defined function exist: `gnus-extract-address-components',
335 which is the default, quite fast, and too simplistic solution, and
336 `mail-extract-address-components', which works much better, but is
337 slower.")
338
339 (defvar gnus-carpal nil
340   "*If non-nil, display clickable icons.")
341
342 (defvar gnus-shell-command-separator ";"
343   "String used to separate to shell commands.")
344
345 (defvar gnus-valid-select-methods
346   '(("nntp" post address prompt-address)
347     ("nnspool" post address)
348     ("nnvirtual" post-mail virtual prompt-address)
349     ("nnmbox" mail respool address)
350     ("nnml" mail respool address)
351     ("nnmh" mail respool address)
352     ("nndir" post-mail prompt-address address)
353     ("nneething" none address prompt-address)
354     ("nndoc" none address prompt-address)
355     ("nnbabyl" mail address respool)
356     ("nnkiboze" post virtual)
357     ("nnsoup" post-mail address)
358     ("nndraft" post-mail)
359     ("nnfolder" mail respool address)
360     ("nngateway" none address prompt-address))
361   "An alist of valid select methods.
362 The first element of each list lists should be a string with the name
363 of the select method.  The other elements may be the category of
364 this method (ie. `post', `mail', `none' or whatever) or other
365 properties that this method has (like being respoolable).
366 If you implement a new select method, all you should have to change is
367 this variable.  I think.")
368
369 (defvar gnus-updated-mode-lines '(group article summary tree)
370   "*List of buffers that should update their mode lines.
371 The list may contain the symbols `group', `article' and `summary'.  If
372 the corresponding symbol is present, Gnus will keep that mode line
373 updated with information that may be pertinent.
374 If this variable is nil, screen refresh may be quicker.")
375
376 ;; Added by Keinonen Kari <kk85613@cs.tut.fi>.
377 (defvar gnus-mode-non-string-length nil
378   "*Max length of mode-line non-string contents.
379 If this is nil, Gnus will take space as is needed, leaving the rest
380 of the modeline intact.")
381
382 (defvar gnus-auto-expirable-newsgroups nil
383   "*Groups in which to automatically mark read articles as expirable.
384 If non-nil, this should be a regexp that should match all groups in
385 which to perform auto-expiry.  This only makes sense for mail groups.")
386
387 (defvar gnus-total-expirable-newsgroups nil
388   "*Groups in which to perform expiry of all read articles.
389 Use with extreme caution.  All groups that match this regexp will be
390 expiring - which means that all read articles will be deleted after
391 (say) one week.  (This only goes for mail groups and the like, of
392 course.)")
393
394 (defvar gnus-group-uncollapsed-levels 1
395   "Number of group name elements to leave alone when making a short group name.")
396
397 (defvar gnus-group-use-permanent-levels nil
398   "*If non-nil, once you set a level, Gnus will use this level.")
399
400 ;; Hooks.
401
402 (defvar gnus-load-hook nil
403   "*A hook run while Gnus is loaded.")
404
405 (defvar gnus-apply-kill-hook '(gnus-apply-kill-file)
406   "*A hook called to apply kill files to a group.
407 This hook is intended to apply a kill file to the selected newsgroup.
408 The function `gnus-apply-kill-file' is called by default.
409
410 Since a general kill file is too heavy to use only for a few
411 newsgroups, I recommend you to use a lighter hook function.  For
412 example, if you'd like to apply a kill file to articles which contains
413 a string `rmgroup' in subject in newsgroup `control', you can use the
414 following hook:
415
416  (setq gnus-apply-kill-hook
417       (list
418         (lambda ()
419           (cond ((string-match \"control\" gnus-newsgroup-name)
420                  (gnus-kill \"Subject\" \"rmgroup\")
421                  (gnus-expunge \"X\"))))))")
422
423 (defvar gnus-group-change-level-function nil
424   "Function run when a group level is changed.
425 It is called with three parameters -- GROUP, LEVEL and OLDLEVEL.")
426
427 \f
428 ;;; Internal variables
429
430 (defvar gnus-original-article-buffer " *Original Article*")
431 (defvar gnus-newsgroup-name nil)
432
433 (defvar gnus-current-select-method nil
434   "The current method for selecting a newsgroup.")
435
436 (defvar gnus-tree-buffer "*Tree*"
437   "Buffer where Gnus thread trees are displayed.")
438
439 ;; Dummy variable.
440 (defvar gnus-use-generic-from nil)
441
442 ;; Variable holding the user answers to all method prompts.
443 (defvar gnus-method-history nil)
444
445 ;; Variable holding the user answers to all group prompts.
446 (defvar gnus-group-history nil)
447
448 (defvar gnus-server-alist nil
449   "List of available servers.")
450
451 (defvar gnus-topic-indentation "") ;; Obsolete variable.
452
453 (defconst gnus-article-mark-lists
454   '((marked . tick) (replied . reply)
455     (expirable . expire) (killed . killed)
456     (bookmarks . bookmark) (dormant . dormant)
457     (scored . score) (saved . save)
458     (cached . cache)))
459
460 (defvar gnus-headers-retrieved-by nil)
461 (defvar gnus-article-reply nil)
462 (defvar gnus-override-method nil)
463 (defvar gnus-article-check-size nil)
464 (defvar gnus-opened-servers nil)
465
466 (defvar gnus-current-kill-article nil)
467
468 (defvar gnus-have-read-active-file nil)
469
470 (defconst gnus-maintainer
471   "gnus-bug@ifi.uio.no (The Gnus Bugfixing Girls + Boys)"
472   "The mail address of the Gnus maintainers.")
473
474 (defvar gnus-info-nodes
475   '((gnus-group-mode "(gnus)The Group Buffer")
476     (gnus-summary-mode "(gnus)The Summary Buffer")
477     (gnus-article-mode "(gnus)The Article Buffer")
478     (mime/viewer-mode "(gnus)The Article Buffer")
479     (gnus-server-mode "(gnus)The Server Buffer")
480     (gnus-browse-mode "(gnus)Browse Foreign Server")
481     (gnus-tree-mode "(gnus)Tree Display"))
482   "Alist of major modes and related Info nodes.")
483
484 (defvar gnus-group-buffer "*Group*")
485 (defvar gnus-summary-buffer "*Summary*")
486 (defvar gnus-article-buffer "*Article*")
487 (defvar gnus-server-buffer "*Server*")
488
489 (defvar gnus-buffer-list nil
490   "Gnus buffers that should be killed on exit.")
491
492 (defvar gnus-slave nil
493   "Whether this Gnus is a slave or not.")
494
495 (defvar gnus-variable-list
496   '(gnus-newsrc-options gnus-newsrc-options-n
497     gnus-newsrc-last-checked-date
498     gnus-newsrc-alist gnus-server-alist
499     gnus-killed-list gnus-zombie-list
500     gnus-topic-topology gnus-topic-alist
501     gnus-format-specs)
502   "Gnus variables saved in the quick startup file.")
503
504 (defvar gnus-newsrc-alist nil
505   "Assoc list of read articles.
506 gnus-newsrc-hashtb should be kept so that both hold the same information.")
507
508 (defvar gnus-newsrc-hashtb nil
509   "Hashtable of gnus-newsrc-alist.")
510
511 (defvar gnus-killed-list nil
512   "List of killed newsgroups.")
513
514 (defvar gnus-killed-hashtb nil
515   "Hash table equivalent of gnus-killed-list.")
516
517 (defvar gnus-zombie-list nil
518   "List of almost dead newsgroups.")
519
520 (defvar gnus-description-hashtb nil
521   "Descriptions of newsgroups.")
522
523 (defvar gnus-list-of-killed-groups nil
524   "List of newsgroups that have recently been killed by the user.")
525
526 (defvar gnus-active-hashtb nil
527   "Hashtable of active articles.")
528
529 (defvar gnus-moderated-list nil
530   "List of moderated newsgroups.")
531
532 ;; Save window configuration.
533 (defvar gnus-prev-winconf nil)
534
535 (defvar gnus-reffed-article-number nil)
536
537 ;;; Let the byte-compiler know that we know about this variable.
538 (defvar rmail-default-rmail-file)
539
540 (defvar gnus-dead-summary nil)
541
542 ;;; End of variables.
543
544 ;; Define some autoload functions Gnus might use.
545 (eval-and-compile
546
547   ;; This little mapcar goes through the list below and marks the
548   ;; symbols in question as autoloaded functions.
549   (mapcar
550    (lambda (package)
551      (let ((interactive (nth 1 (memq ':interactive package))))
552        (mapcar
553         (lambda (function)
554           (let (keymap)
555             (when (consp function)
556               (setq keymap (car (memq 'keymap function)))
557               (setq function (car function)))
558             (autoload function (car package) nil interactive keymap)))
559         (if (eq (nth 1 package) ':interactive)
560             (cdddr package)
561           (cdr package)))))
562    '(("metamail" metamail-buffer)
563      ("info" Info-goto-node)
564      ("hexl" hexl-hex-string-to-integer)
565      ("pp" pp pp-to-string pp-eval-expression)
566      ("mail-extr" mail-extract-address-components)
567      ("nnmail" nnmail-split-fancy nnmail-article-group)
568      ("nnvirtual" nnvirtual-catchup-group nnvirtual-convert-headers)
569      ("timezone" timezone-make-date-arpa-standard timezone-fix-time
570       timezone-make-sortable-date timezone-make-time-string)
571      ("rmailout" rmail-output)
572      ("rmail" rmail-insert-rmail-file-header rmail-count-new-messages
573       rmail-show-message)
574      ("gnus-soup" :interactive t
575       gnus-group-brew-soup gnus-brew-soup gnus-soup-add-article
576       gnus-soup-send-replies gnus-soup-save-areas gnus-soup-pack-packet)
577      ("nnsoup" nnsoup-pack-replies)
578      ("score-mode" :interactive t gnus-score-mode)
579      ("gnus-mh" gnus-mh-mail-setup gnus-summary-save-article-folder
580       gnus-Folder-save-name gnus-folder-save-name)
581      ("gnus-mh" :interactive t gnus-summary-save-in-folder)
582      ("gnus-vis" gnus-group-make-menu-bar gnus-summary-make-menu-bar
583       gnus-server-make-menu-bar gnus-article-make-menu-bar
584       gnus-browse-make-menu-bar gnus-highlight-selected-summary
585       gnus-summary-highlight-line gnus-carpal-setup-buffer
586       gnus-group-highlight-line
587       gnus-article-add-button gnus-insert-next-page-button
588       gnus-insert-prev-page-button gnus-visual-turn-off-edit-menu)
589      ("gnus-vis" :interactive t
590       gnus-article-push-button gnus-article-press-button
591       gnus-article-highlight gnus-article-highlight-some
592       gnus-article-highlight-headers gnus-article-highlight-signature
593       gnus-article-add-buttons gnus-article-add-buttons-to-head
594       gnus-article-next-button gnus-article-prev-button)
595      ("gnus-demon" gnus-demon-add-nocem gnus-demon-add-scanmail
596       gnus-demon-add-disconnection gnus-demon-add-handler
597       gnus-demon-remove-handler)
598      ("gnus-demon" :interactive t
599       gnus-demon-init gnus-demon-cancel)
600      ("gnus-salt" gnus-highlight-selected-tree gnus-possibly-generate-tree
601       gnus-tree-open gnus-tree-close)
602      ("gnus-nocem" gnus-nocem-scan-groups gnus-nocem-close
603       gnus-nocem-unwanted-article-p)
604      ("gnus-srvr" gnus-enter-server-buffer gnus-server-set-info)
605      ("gnus-srvr" gnus-browse-foreign-server)
606      ("gnus-cite" :interactive t
607       gnus-article-highlight-citation gnus-article-hide-citation-maybe
608       gnus-article-hide-citation gnus-article-fill-cited-article
609       gnus-article-hide-citation-in-followups)
610      ("gnus-kill" gnus-kill gnus-apply-kill-file-internal
611       gnus-kill-file-edit-file gnus-kill-file-raise-followups-to-author
612       gnus-execute gnus-expunge)
613      ("gnus-cache" gnus-cache-possibly-enter-article gnus-cache-save-buffers
614       gnus-cache-possibly-remove-articles gnus-cache-request-article
615       gnus-cache-retrieve-headers gnus-cache-possibly-alter-active
616       gnus-cache-enter-remove-article gnus-cached-article-p
617       gnus-cache-open gnus-cache-close gnus-cache-update-article)
618      ("gnus-cache" :interactive t gnus-jog-cache gnus-cache-enter-article
619       gnus-cache-remove-article)
620      ("gnus-score" :interactive t
621       gnus-summary-increase-score gnus-summary-lower-score
622       gnus-score-flush-cache gnus-score-close
623       gnus-score-raise-same-subject-and-select
624       gnus-score-raise-same-subject gnus-score-default
625       gnus-score-raise-thread gnus-score-lower-same-subject-and-select
626       gnus-score-lower-same-subject gnus-score-lower-thread
627       gnus-possibly-score-headers gnus-summary-raise-score 
628       gnus-summary-set-score gnus-summary-current-score)
629      ("gnus-score"
630       (gnus-summary-score-map keymap) gnus-score-save gnus-score-headers
631       gnus-current-score-file-nondirectory gnus-score-adaptive
632       gnus-score-find-trace gnus-score-file-name)
633      ("gnus-edit" :interactive t gnus-score-customize)
634      ("gnus-topic" :interactive t gnus-topic-mode)
635      ("gnus-topic" gnus-topic-remove-group)
636      ("gnus-salt" :interactive t gnus-pick-mode gnus-binary-mode)
637      ("gnus-uu" (gnus-uu-extract-map keymap) (gnus-uu-mark-map keymap))
638      ("gnus-uu" :interactive t
639       gnus-uu-digest-mail-forward gnus-uu-digest-post-forward
640       gnus-uu-mark-series gnus-uu-mark-region gnus-uu-mark-buffer
641       gnus-uu-mark-by-regexp gnus-uu-mark-all
642       gnus-uu-mark-sparse gnus-uu-mark-thread gnus-uu-decode-uu
643       gnus-uu-decode-uu-and-save gnus-uu-decode-unshar
644       gnus-uu-decode-unshar-and-save gnus-uu-decode-save
645       gnus-uu-decode-binhex gnus-uu-decode-uu-view
646       gnus-uu-decode-uu-and-save-view gnus-uu-decode-unshar-view
647       gnus-uu-decode-unshar-and-save-view gnus-uu-decode-save-view
648       gnus-uu-decode-binhex-view)
649      ("gnus-msg" (gnus-summary-send-map keymap)
650       gnus-mail-yank-original gnus-mail-send-and-exit
651       gnus-article-mail gnus-new-mail gnus-mail-reply
652       gnus-copy-article-buffer gnus-extended-version)
653      ("gnus-msg" :interactive t
654       gnus-group-post-news gnus-group-mail gnus-summary-post-news
655       gnus-summary-followup gnus-summary-followup-with-original
656       gnus-summary-cancel-article gnus-summary-supersede-article
657       gnus-post-news gnus-inews-news 
658       gnus-summary-reply gnus-summary-reply-with-original
659       gnus-summary-mail-forward gnus-summary-mail-other-window
660       gnus-bug)
661      ("gnus-picon" :interactive t gnus-article-display-picons
662       gnus-group-display-picons gnus-picons-article-display-x-face
663       gnus-picons-display-x-face)
664      ("gnus-gl" bbb-login bbb-logout bbb-grouplens-group-p 
665       gnus-grouplens-mode)
666      ("smiley" :interactive t gnus-smiley-display)
667      ("gnus" gnus-add-current-to-buffer-list gnus-add-shutdown)
668      ("gnus-win" gnus-configure-windows)
669      ("gnus-sum" gnus-summary-insert-line gnus-summary-read-group
670       gnus-list-of-unread-articles gnus-list-of-read-articles
671       gnus-offer-save-summaries gnus-make-thread-indent-array
672       gnus-summary-exit)
673      ("gnus-group" gnus-group-insert-group-line gnus-group-quit
674       gnus-group-list-groups gnus-group-first-unread-group
675       gnus-group-set-mode-line gnus-group-set-info gnus-group-save-newsrc
676       gnus-group-setup-buffer gnus-group-get-new-news
677       gnus-group-make-help-group gnus-group-update-group)
678      ("gnus-bcklg" gnus-backlog-request-article gnus-backlog-enter-article
679       gnus-backlog-remove-article) 
680      ("gnus-art" gnus-article-read-summary-keys gnus-article-save
681       gnus-article-prepare gnus-article-set-window-start
682       gnus-article-show-all-headers gnus-article-next-page
683       gnus-article-prev-page gnus-request-article-this-buffer
684       gnus-article-mode gnus-article-setup-buffer gnus-narrow-to-page)
685      ("gnus-art" :interactive t
686       gnus-article-hide-headers gnus-article-hide-boring-headers
687       gnus-article-treat-overstrike gnus-article-word-wrap
688       gnus-article-remove-cr gnus-article-remove-trailing-blank-lines
689       gnus-article-display-x-face gnus-article-de-quoted-unreadable
690       gnus-article-mime-decode-quoted-printable gnus-article-hide-pgp
691       gnus-article-hide-pem gnus-article-hide-signature
692       gnus-article-strip-leading-blank-lines gnus-article-date-local
693       gnus-article-date-original gnus-article-date-lapsed
694       gnus-decode-rfc1522 gnus-article-show-all-headers
695       gnus-article-edit-mode gnus-article-edit-article
696       gnus-article-edit-done)
697      ("gnus-int" gnus-request-type)
698      ("gnus-start" gnus-newsrc-parse-options gnus-1 gnus-no-server-1
699       gnus-dribble-enter)
700      ("gnus-dup" gnus-dup-suppress-articles gnus-dup-enter-articles)
701      ("gnus-range" gnus-copy-sequence)
702      ("gnus-vm" gnus-vm-mail-setup)
703      ("gnus-eform" gnus-edit-form)
704      ("gnus-move" :interactive t
705       gnus-group-move-group-to-server gnus-change-server)
706      ("gnus-logic" gnus-score-advanced)
707      ("gnus-undo" gnus-undo-mode gnus-undo-register 
708       gnus-dup-unsuppress-article)
709      ("gnus-async" gnus-async-request-fetched-article gnus-async-prefetch-next
710       gnus-async-prefetch-article gnus-async-prefetch-remove-group)
711      ("gnus-vm" :interactive t gnus-summary-save-in-vm
712       gnus-summary-save-article-vm))))
713
714 ;;; gnus-sum.el thingies
715
716
717 (defvar gnus-summary-line-format "%U\%R\%z\%I\%(%[%4L: %-20,20n%]%) %s\n"
718   "*The format specification of the lines in the summary buffer.
719
720 It works along the same lines as a normal formatting string,
721 with some simple extensions.
722
723 %N   Article number, left padded with spaces (string)
724 %S   Subject (string)
725 %s   Subject if it is at the root of a thread, and \"\" otherwise (string)
726 %n   Name of the poster (string)
727 %a   Extracted name of the poster (string)
728 %A   Extracted address of the poster (string)
729 %F   Contents of the From: header (string)
730 %x   Contents of the Xref: header (string)
731 %D   Date of the article (string)
732 %d   Date of the article (string) in DD-MMM format
733 %M   Message-id of the article (string)
734 %r   References of the article (string)
735 %c   Number of characters in the article (integer)
736 %L   Number of lines in the article (integer)
737 %I   Indentation based on thread level (a string of spaces)
738 %T   A string with two possible values: 80 spaces if the article
739      is on thread level two or larger and 0 spaces on level one
740 %R   \"A\" if this article has been replied to, \" \" otherwise (character)
741 %U   Status of this article (character, \"R\", \"K\", \"-\" or \" \")
742 %[   Opening bracket (character, \"[\" or \"<\")
743 %]   Closing bracket (character, \"]\" or \">\")
744 %>   Spaces of length thread-level (string)
745 %<   Spaces of length (- 20 thread-level) (string)
746 %i   Article score (number)
747 %z   Article zcore (character)
748 %t   Number of articles under the current thread (number).
749 %e   Whether the thread is empty or not (character).
750 %l   GroupLens score (string).
751 %P   The line number (number).
752 %u   User defined specifier.  The next character in the format string should
753      be a letter.  Gnus will call the function gnus-user-format-function-X,
754      where X is the letter following %u.  The function will be passed the
755      current header as argument.  The function should return a string, which
756      will be inserted into the summary just like information from any other
757      summary specifier.
758
759 Text between %( and %) will be highlighted with `gnus-mouse-face'
760 when the mouse point is placed inside the area.  There can only be one
761 such area.
762
763 The %U (status), %R (replied) and %z (zcore) specs have to be handled
764 with care.  For reasons of efficiency, Gnus will compute what column
765 these characters will end up in, and \"hard-code\" that.  This means that
766 it is illegal to have these specs after a variable-length spec.  Well,
767 you might not be arrested, but your summary buffer will look strange,
768 which is bad enough.
769
770 The smart choice is to have these specs as for to the left as
771 possible.
772
773 This restriction may disappear in later versions of Gnus.")
774
775 ;;;
776 ;;; Skeleton keymaps
777 ;;;
778
779 (defun gnus-suppress-keymap (keymap)
780   (suppress-keymap keymap)
781   (let ((keys `([delete] "\177" "\M-u"))) ;gnus-mouse-2 
782     (while keys
783       (define-key keymap (pop keys) 'undefined))))
784
785 (defvar gnus-article-mode-map (make-keymap))
786 (gnus-suppress-keymap gnus-article-mode-map)
787 (defvar gnus-summary-mode-map (make-keymap))
788 (gnus-suppress-keymap gnus-summary-mode-map)
789 (defvar gnus-group-mode-map (make-keymap))
790 (gnus-suppress-keymap gnus-group-mode-map)
791
792 ;;; Function aliases later to be redefined for XEmacs usage.
793
794 (defalias 'gnus-make-overlay 'make-overlay)
795 (defalias 'gnus-overlay-put 'overlay-put)
796 (defalias 'gnus-move-overlay 'move-overlay)
797 (defalias 'gnus-overlay-end 'overlay-end)
798 (defalias 'gnus-extent-detached-p 'ignore)
799 (defalias 'gnus-extent-start-open 'ignore)
800 (defalias 'gnus-set-text-properties 'set-text-properties)
801 (defalias 'gnus-group-remove-excess-properties 'ignore)
802 (defalias 'gnus-topic-remove-excess-properties 'ignore)
803 (defalias 'gnus-appt-select-lowest-window 'appt-select-lowest-window)
804 (defalias 'gnus-mail-strip-quoted-names 'mail-strip-quoted-names)
805 (defalias 'gnus-make-local-hook 'make-local-hook)
806 (defalias 'gnus-add-hook 'add-hook)
807 (defalias 'gnus-character-to-event 'identity)
808 (defalias 'gnus-add-text-properties 'add-text-properties)
809 (defalias 'gnus-put-text-property 'put-text-property)
810 (defalias 'gnus-mode-line-buffer-identification 'identity)
811
812 (provide 'gnus-load)
813
814 ;;; gnus-load.el ends here