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