1 ;;; gnus-srvr.el --- virtual server support for Gnus
3 ;; Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
4 ;; 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
6 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
28 (eval-when-compile (require 'cl
))
36 (defcustom gnus-server-mode-hook nil
37 "Hook run in `gnus-server-mode' buffers."
41 (defcustom gnus-server-exit-hook nil
42 "Hook run when exiting the server buffer."
46 (defcustom gnus-server-line-format
" {%(%h:%w%)} %s%a\n"
47 "Format of server lines.
48 It works along the same lines as a normal formatting string,
49 with some simple extensions.
51 The following specs are understood:
59 General format specifiers can also be used.
60 See Info node `(gnus)Formatting Variables'."
61 :link
'(custom-manual "(gnus)Formatting Variables")
62 :group
'gnus-server-visual
65 (defcustom gnus-server-mode-line-format
"Gnus: %%b"
66 "The format specification for the server mode line."
67 :group
'gnus-server-visual
70 (defcustom gnus-server-browse-in-group-buffer nil
71 "Whether server browsing should take place in the group buffer.
72 If nil, a faster, but more primitive, buffer is used instead."
74 :group
'gnus-server-visual
77 ;;; Internal variables.
79 (defvar gnus-inserted-opened-servers nil
)
81 (defvar gnus-server-line-format-alist
82 `((?h gnus-tmp-how ?s
)
84 (?w gnus-tmp-where ?s
)
85 (?s gnus-tmp-status ?s
)
86 (?a gnus-tmp-agent ?s
)))
88 (defvar gnus-server-mode-line-format-alist
89 `((?S gnus-tmp-news-server ?s
)
90 (?M gnus-tmp-news-method ?s
)
91 (?u gnus-tmp-user-defined ?s
)))
93 (defvar gnus-server-line-format-spec nil
)
94 (defvar gnus-server-mode-line-format-spec nil
)
95 (defvar gnus-server-killed-servers nil
)
97 (defvar gnus-server-mode-map
)
99 (defvar gnus-server-menu-hook nil
100 "*Hook run after the creation of the server mode menu.")
102 (defun gnus-server-make-menu-bar ()
103 (gnus-turn-off-edit-menu 'server
)
104 (unless (boundp 'gnus-server-server-menu
)
106 gnus-server-server-menu gnus-server-mode-map
""
108 ["Add..." gnus-server-add-server t
]
109 ["Browse" gnus-server-read-server t
]
110 ["Scan" gnus-server-scan-server t
]
111 ["List" gnus-server-list-servers t
]
112 ["Kill" gnus-server-kill-server t
]
113 ["Yank" gnus-server-yank-server t
]
114 ["Copy" gnus-server-copy-server t
]
115 ["Edit" gnus-server-edit-server t
]
116 ["Regenerate" gnus-server-regenerate-server t
]
117 ["Compact" gnus-server-compact-server t
]
118 ["Exit" gnus-server-exit t
]))
121 gnus-server-connections-menu gnus-server-mode-map
""
123 ["Open" gnus-server-open-server t
]
124 ["Close" gnus-server-close-server t
]
125 ["Offline" gnus-server-offline-server t
]
126 ["Deny" gnus-server-deny-server t
]
128 ["Open All" gnus-server-open-all-servers t
]
129 ["Close All" gnus-server-close-all-servers t
]
130 ["Reset All" gnus-server-remove-denials t
]))
132 (gnus-run-hooks 'gnus-server-menu-hook
)))
134 (defvar gnus-server-mode-map nil
)
135 (put 'gnus-server-mode
'mode-class
'special
)
137 (unless gnus-server-mode-map
138 (setq gnus-server-mode-map
(make-sparse-keymap))
139 (suppress-keymap gnus-server-mode-map
)
141 (gnus-define-keys gnus-server-mode-map
142 " " gnus-server-read-server-in-server-buffer
143 "\r" gnus-server-read-server
144 gnus-mouse-2 gnus-server-pick-server
146 "l" gnus-server-list-servers
147 "k" gnus-server-kill-server
148 "y" gnus-server-yank-server
149 "c" gnus-server-copy-server
150 "a" gnus-server-add-server
151 "e" gnus-server-edit-server
152 "s" gnus-server-scan-server
154 "O" gnus-server-open-server
155 "\M-o" gnus-server-open-all-servers
156 "C" gnus-server-close-server
157 "\M-c" gnus-server-close-all-servers
158 "D" gnus-server-deny-server
159 "L" gnus-server-offline-server
160 "R" gnus-server-remove-denials
165 "g" gnus-server-regenerate-server
167 "z" gnus-server-compact-server
169 "\C-c\C-i" gnus-info-find-node
170 "\C-c\C-b" gnus-bug
))
172 (defface gnus-server-agent
173 '((((class color
) (background light
)) (:foreground
"PaleTurquoise" :bold t
))
174 (((class color
) (background dark
)) (:foreground
"PaleTurquoise" :bold t
))
176 "Face used for displaying AGENTIZED servers"
177 :group
'gnus-server-visual
)
178 ;; backward-compatibility alias
179 (put 'gnus-server-agent-face
'face-alias
'gnus-server-agent
)
181 (defface gnus-server-opened
182 '((((class color
) (background light
)) (:foreground
"Green3" :bold t
))
183 (((class color
) (background dark
)) (:foreground
"Green1" :bold t
))
185 "Face used for displaying OPENED servers"
186 :group
'gnus-server-visual
)
187 ;; backward-compatibility alias
188 (put 'gnus-server-opened-face
'face-alias
'gnus-server-opened
)
190 (defface gnus-server-closed
191 '((((class color
) (background light
)) (:foreground
"Steel Blue" :italic t
))
192 (((class color
) (background dark
))
193 (:foreground
"LightBlue" :italic t
))
195 "Face used for displaying CLOSED servers"
196 :group
'gnus-server-visual
)
197 ;; backward-compatibility alias
198 (put 'gnus-server-closed-face
'face-alias
'gnus-server-closed
)
200 (defface gnus-server-denied
201 '((((class color
) (background light
)) (:foreground
"Red" :bold t
))
202 (((class color
) (background dark
)) (:foreground
"Pink" :bold t
))
203 (t (:inverse-video t
:bold t
)))
204 "Face used for displaying DENIED servers"
205 :group
'gnus-server-visual
)
206 ;; backward-compatibility alias
207 (put 'gnus-server-denied-face
'face-alias
'gnus-server-denied
)
209 (defface gnus-server-offline
210 '((((class color
) (background light
)) (:foreground
"Orange" :bold t
))
211 (((class color
) (background dark
)) (:foreground
"Yellow" :bold t
))
212 (t (:inverse-video t
:bold t
)))
213 "Face used for displaying OFFLINE servers"
214 :group
'gnus-server-visual
)
215 ;; backward-compatibility alias
216 (put 'gnus-server-offline-face
'face-alias
'gnus-server-offline
)
218 (defvar gnus-server-font-lock-keywords
219 '(("(\\(agent\\))" 1 'gnus-server-agent
)
220 ("(\\(opened\\))" 1 'gnus-server-opened
)
221 ("(\\(closed\\))" 1 'gnus-server-closed
)
222 ("(\\(offline\\))" 1 'gnus-server-offline
)
223 ("(\\(denied\\))" 1 'gnus-server-denied
)))
225 (defun gnus-server-mode ()
226 "Major mode for listing and editing servers.
228 All normal editing commands are switched off.
229 \\<gnus-server-mode-map>
230 For more in-depth information on this mode, read the manual
231 \(`\\[gnus-info-find-node]').
233 The following commands are available:
235 \\{gnus-server-mode-map}"
237 (when (gnus-visual-p 'server-menu
'menu
)
238 (gnus-server-make-menu-bar))
239 (kill-all-local-variables)
240 (gnus-simplify-mode-line)
241 (setq major-mode
'gnus-server-mode
)
242 (setq mode-name
"Server")
243 (gnus-set-default-directory)
244 (setq mode-line-process nil
)
245 (use-local-map gnus-server-mode-map
)
246 (buffer-disable-undo)
247 (setq truncate-lines t
)
248 (setq buffer-read-only t
)
249 (if (featurep 'xemacs
)
250 (put 'gnus-server-mode
'font-lock-defaults
'(gnus-server-font-lock-keywords t
))
251 (set (make-local-variable 'font-lock-defaults
)
252 '(gnus-server-font-lock-keywords t
)))
253 (gnus-run-mode-hooks 'gnus-server-mode-hook
))
255 (defun gnus-server-insert-server-line (gnus-tmp-name method
)
256 (let* ((gnus-tmp-how (car method
))
257 (gnus-tmp-where (nth 1 method
))
258 (elem (assoc method gnus-opened-servers
))
261 ((eq (nth 1 elem
) 'denied
) "(denied)")
262 ((eq (nth 1 elem
) 'offline
) "(offline)")
265 (if (or (gnus-server-opened method
)
266 (eq (nth 1 elem
) 'ok
))
269 ((error) "(error)")))))
270 (gnus-tmp-agent (if (and gnus-agent
271 (gnus-agent-method-p method
))
275 (gnus-add-text-properties
279 (eval gnus-server-line-format-spec
))
280 (list 'gnus-server
(intern gnus-tmp-name
)
281 'gnus-named-server
(intern (gnus-method-to-server method t
))))))
283 (defun gnus-enter-server-buffer ()
284 "Set up the server buffer."
285 (gnus-server-setup-buffer)
286 (gnus-configure-windows 'server
)
287 ;; Usually `gnus-configure-windows' will finish with the
288 ;; `gnus-server-buffer' selected as the current buffer, but not always (I
289 ;; bumped into it when starting from a dedicated *Group* frame, and
290 ;; gnus-configure-windows opened *Server* into its own dedicated frame).
291 (with-current-buffer (get-buffer gnus-server-buffer
)
292 (gnus-server-prepare)))
294 (defun gnus-server-setup-buffer ()
295 "Initialize the server buffer."
296 (unless (get-buffer gnus-server-buffer
)
297 (with-current-buffer (gnus-get-buffer-create gnus-server-buffer
)
300 (gnus-carpal-setup-buffer 'server
)))))
302 (defun gnus-server-prepare ()
303 (gnus-set-format 'server-mode
)
304 (gnus-set-format 'server t
)
305 (let ((alist gnus-server-alist
)
306 (buffer-read-only nil
)
309 (setq gnus-inserted-opened-servers nil
)
310 ;; First we do the real list of servers.
312 (unless (member (cdar alist
) done
)
313 (push (cdar alist
) done
)
314 (setq server
(pop alist
))
315 (when (and server
(car server
) (cdr server
))
316 (gnus-server-insert-server-line (car server
) (cdr server
))))
317 (when (member (cdar alist
) done
)
319 ;; Then we insert the list of servers that have been opened in
321 (dolist (open gnus-opened-servers
)
322 (when (and (not (member (car open
) done
))
323 ;; Just ignore ephemeral servers.
324 (not (member (car open
) gnus-ephemeral-servers
)))
325 (push (car open
) done
)
326 (gnus-server-insert-server-line
327 (setq op-ser
(format "%s:%s" (caar open
) (nth 1 (car open
))))
329 (push (list op-ser
(car open
)) gnus-inserted-opened-servers
))))
330 (goto-char (point-min))
331 (gnus-server-position-point))
333 (defun gnus-server-server-name ()
334 (let ((server (get-text-property (point-at-bol) 'gnus-server
)))
335 (and server
(symbol-name server
))))
337 (defun gnus-server-named-server ()
338 "Return a server name that matches one of the names returned by
339 `gnus-method-to-server'."
340 (let ((server (get-text-property (point-at-bol) 'gnus-named-server
)))
341 (and server
(symbol-name server
))))
343 (defalias 'gnus-server-position-point
'gnus-goto-colon
)
345 (defconst gnus-server-edit-buffer
"*Gnus edit server*")
347 (defun gnus-server-update-server (server)
348 (with-current-buffer gnus-server-buffer
349 (let* ((buffer-read-only nil
)
350 (entry (assoc server gnus-server-alist
))
351 (oentry (assoc (gnus-server-to-method server
)
352 gnus-opened-servers
)))
355 (concat "(gnus-server-set-info \"" server
"\" '"
356 (gnus-prin1-to-string (cdr entry
)) ")\n")))
357 (when (or entry oentry
)
358 ;; Buffer may be narrowed.
361 (when (gnus-server-goto-server server
)
364 (gnus-server-insert-server-line (car entry
) (cdr entry
))
365 (gnus-server-insert-server-line
366 (format "%s:%s" (caar oentry
) (nth 1 (car oentry
)))
368 (gnus-server-position-point))))))
370 (defun gnus-server-set-info (server info
)
371 ;; Enter a select method into the virtual server alist.
372 (when (and server info
)
374 (concat "(gnus-server-set-info \"" server
"\" '"
375 (gnus-prin1-to-string info
) ")"))
376 (let* ((server (nth 1 info
))
377 (entry (assoc server gnus-server-alist
))
378 (cached (assoc server gnus-server-method-cache
)))
380 (setq gnus-server-method-cache
381 (delq cached gnus-server-method-cache
)))
384 ;; Remove the server from `gnus-opened-servers' since
385 ;; it has never been opened with the new `info' yet.
386 (gnus-opened-servers-remove (cdr entry
))
387 ;; Don't make a new Lisp object.
388 (setcar (cdr entry
) (car info
))
389 (setcdr (cdr entry
) (cdr info
)))
390 (setq gnus-server-alist
391 (nconc gnus-server-alist
(list (cons server info
))))))))
393 ;;; Interactive server functions.
395 (defun gnus-server-kill-server (server)
396 "Kill the server on the current line."
397 (interactive (list (gnus-server-server-name)))
398 (unless (gnus-server-goto-server server
)
399 (if server
(error "No such server: %s" server
)
400 (error "No server on the current line")))
401 (unless (assoc server gnus-server-alist
)
402 (error "Read-only server %s" server
))
404 (let ((buffer-read-only nil
))
406 (push (assoc server gnus-server-alist
) gnus-server-killed-servers
)
407 (setq gnus-server-alist
(delq (car gnus-server-killed-servers
)
409 (let ((groups (gnus-groups-from-server server
)))
412 (format "Kill all %s groups from this server? "
414 (dolist (group groups
)
415 (setq gnus-newsrc-alist
416 (delq (assoc group gnus-newsrc-alist
)
418 (when gnus-group-change-level-function
419 (funcall gnus-group-change-level-function
420 group gnus-level-killed
3)))))
421 (gnus-server-position-point))
423 (defun gnus-server-yank-server ()
424 "Yank the previously killed server."
426 (unless gnus-server-killed-servers
427 (error "No killed servers to be yanked"))
428 (let ((alist gnus-server-alist
)
429 (server (gnus-server-server-name))
430 (killed (car gnus-server-killed-servers
)))
432 (setq gnus-server-alist
(nconc gnus-server-alist
(list killed
)))
433 (if (string= server
(caar gnus-server-alist
))
434 (push killed gnus-server-alist
)
435 (while (and (cdr alist
)
436 (not (string= server
(caadr alist
))))
437 (setq alist
(cdr alist
)))
439 (setcdr alist
(cons killed
(cdr alist
)))
440 (setq gnus-server-alist
(list killed
)))))
441 (gnus-server-update-server (car killed
))
442 (setq gnus-server-killed-servers
(cdr gnus-server-killed-servers
))
443 (gnus-server-position-point)))
445 (defun gnus-server-exit ()
446 "Return to the group buffer."
448 (gnus-run-hooks 'gnus-server-exit-hook
)
449 (gnus-kill-buffer (current-buffer))
450 (gnus-configure-windows 'group t
))
452 (defun gnus-server-list-servers ()
453 "List all available servers."
455 (let ((cur (gnus-server-server-name)))
456 (gnus-server-prepare)
457 (if cur
(gnus-server-goto-server cur
)
458 (goto-char (point-max))
460 (gnus-server-position-point)))
462 (defun gnus-server-set-status (method status
)
463 "Make METHOD have STATUS."
464 (let ((entry (assoc method gnus-opened-servers
)))
466 (setcar (cdr entry
) status
)
467 (push (list method status
) gnus-opened-servers
))))
469 (defun gnus-opened-servers-remove (method)
470 "Remove METHOD from the list of opened servers."
471 (setq gnus-opened-servers
(delq (assoc method gnus-opened-servers
)
472 gnus-opened-servers
)))
474 (defun gnus-server-open-server (server)
475 "Force an open of SERVER."
476 (interactive (list (gnus-server-server-name)))
477 (let ((method (gnus-server-to-method server
)))
479 (error "No such server: %s" server
))
480 (gnus-server-set-status method
'ok
)
482 (or (gnus-open-server method
)
483 (progn (message "Couldn't open %s" server
) nil
))
484 (gnus-server-update-server server
)
485 (gnus-server-position-point))))
487 (defun gnus-server-open-all-servers ()
490 (dolist (server gnus-inserted-opened-servers
)
491 (gnus-server-open-server (car server
))))
493 (defun gnus-server-close-server (server)
495 (interactive (list (gnus-server-server-name)))
496 (let ((method (gnus-server-to-method server
)))
498 (error "No such server: %s" server
))
499 (gnus-server-set-status method
'closed
)
501 (gnus-close-server method
)
502 (gnus-server-update-server server
)
503 (gnus-server-position-point))))
505 (defun gnus-server-offline-server (server)
506 "Set SERVER to offline."
507 (interactive (list (gnus-server-server-name)))
508 (let ((method (gnus-server-to-method server
)))
510 (error "No such server: %s" server
))
512 (gnus-close-server method
)
513 (gnus-server-set-status method
'offline
)
514 (gnus-server-update-server server
)
515 (gnus-server-position-point))))
517 (defun gnus-server-close-all-servers ()
520 (dolist (server gnus-inserted-opened-servers
)
521 (gnus-server-close-server (car server
)))
522 (dolist (server gnus-server-alist
)
523 (gnus-server-close-server (car server
))))
525 (defun gnus-server-deny-server (server)
526 "Make sure SERVER will never be attempted opened."
527 (interactive (list (gnus-server-server-name)))
528 (let ((method (gnus-server-to-method server
)))
530 (error "No such server: %s" server
))
531 (gnus-server-set-status method
'denied
))
532 (gnus-server-update-server server
)
533 (gnus-server-position-point)
536 (defun gnus-server-remove-denials ()
537 "Make all denied servers into closed servers."
539 (dolist (server gnus-opened-servers
)
540 (when (eq (nth 1 server
) 'denied
)
541 (setcar (nthcdr 1 server
) 'closed
)))
542 (gnus-server-list-servers))
544 (defun gnus-server-copy-server (from to
)
547 (or (gnus-server-server-name)
548 (error "No server on the current line"))
549 (read-string "Copy to: ")))
551 (error "No server on current line"))
552 (unless (and to
(not (string= to
"")))
553 (error "No name to copy to"))
554 (when (assoc to gnus-server-alist
)
555 (error "%s already exists" to
))
556 (unless (gnus-server-to-method from
)
557 (error "%s: no such server" from
))
558 (let ((to-entry (cons from
(gnus-copy-sequence
559 (gnus-server-to-method from
)))))
561 (setcar (nthcdr 2 to-entry
) to
)
562 (push to-entry gnus-server-killed-servers
)
563 (gnus-server-yank-server)))
565 (defun gnus-server-add-server (how where
)
567 (list (intern (completing-read "Server method: "
568 gnus-valid-select-methods nil t
))
569 (read-string "Server name: ")))
570 (when (assq where gnus-server-alist
)
571 (error "Server with that name already defined"))
572 (push (list where how where
) gnus-server-killed-servers
)
573 (gnus-server-yank-server))
575 (defun gnus-server-goto-server (server)
576 "Jump to a server line."
578 (list (completing-read "Goto server: " gnus-server-alist nil t
)))
579 (let ((to (text-property-any (point-min) (point-max)
580 'gnus-server
(intern server
))))
583 (gnus-server-position-point))))
585 (defun gnus-server-edit-server (server)
586 "Edit the server on the current line."
587 (interactive (list (gnus-server-server-name)))
589 (error "No server on current line"))
590 (unless (assoc server gnus-server-alist
)
591 (error "This server can't be edited"))
592 (let ((info (cdr (assoc server gnus-server-alist
))))
593 (gnus-close-server info
)
595 info
"Editing the server."
597 (gnus-server-set-info ,server form
)
598 (gnus-server-list-servers)
599 (gnus-server-position-point))
602 (defun gnus-server-scan-server (server)
603 "Request a scan from the current server."
604 (interactive (list (gnus-server-server-name)))
605 (let ((method (gnus-server-to-method server
)))
606 (if (not (gnus-get-function method
'request-scan
))
607 (error "Server %s can't scan" (car method
))
608 (gnus-message 3 "Scanning %s..." server
)
609 (gnus-request-scan nil method
)
610 (gnus-message 3 "Scanning %s...done" server
))))
612 (defun gnus-server-read-server-in-server-buffer (server)
613 "Browse a server in server buffer."
614 (interactive (list (gnus-server-server-name)))
615 (let (gnus-server-browse-in-group-buffer)
616 (gnus-server-read-server server
)))
618 (defun gnus-server-read-server (server)
620 (interactive (list (gnus-server-server-name)))
621 (let ((buf (current-buffer)))
623 (gnus-browse-foreign-server server buf
)
624 (with-current-buffer buf
625 (gnus-server-update-server (gnus-server-server-name))
626 (gnus-server-position-point)))))
628 (defun gnus-server-pick-server (e)
631 (gnus-server-read-server (gnus-server-server-name)))
635 ;;; Browse Server Mode
638 (defvar gnus-browse-menu-hook nil
639 "*Hook run after the creation of the browse mode menu.")
641 (defvar gnus-browse-mode-hook nil
)
642 (defvar gnus-browse-mode-map nil
)
643 (put 'gnus-browse-mode
'mode-class
'special
)
645 (unless gnus-browse-mode-map
646 (setq gnus-browse-mode-map
(make-keymap))
647 (suppress-keymap gnus-browse-mode-map
)
651 " " gnus-browse-read-group
652 "=" gnus-browse-select-group
653 "n" gnus-browse-next-group
654 "p" gnus-browse-prev-group
655 "\177" gnus-browse-prev-group
656 [delete] gnus-browse-prev-group
657 "N" gnus-browse-next-group
658 "P" gnus-browse-prev-group
659 "\M-n" gnus-browse-next-group
660 "\M-p" gnus-browse-prev-group
661 "\r" gnus-browse-select-group
662 "u" gnus-browse-unsubscribe-current-group
667 "d" gnus-browse-describe-group
668 "\C-c\C-c" gnus-browse-exit
669 "?" gnus-browse-describe-briefly
671 "\C-c\C-i" gnus-info-find-node
672 "\C-c\C-b" gnus-bug))
674 (defun gnus-browse-make-menu-bar ()
675 (gnus-turn-off-edit-menu 'browse)
676 (unless (boundp 'gnus-browse-menu)
678 gnus-browse-menu gnus-browse-mode-map ""
680 ["Subscribe" gnus-browse-unsubscribe-current-group t]
681 ["Read" gnus-browse-read-group t]
682 ["Select" gnus-browse-select-group t]
683 ["Describe" gnus-browse-describe-group t]
684 ["Next" gnus-browse-next-group t]
685 ["Prev" gnus-browse-prev-group t]
686 ["Exit" gnus-browse-exit t]))
687 (gnus-run-hooks 'gnus-browse-menu-hook)))
689 (defvar gnus-browse-current-method nil)
690 (defvar gnus-browse-return-buffer nil)
692 (defvar gnus-browse-buffer "*Gnus Browse Server*")
694 (defun gnus-browse-foreign-server (server &optional return-buffer)
695 "Browse the server SERVER."
696 (setq gnus-browse-current-method (gnus-server-to-method server))
697 (setq gnus-browse-return-buffer return-buffer)
698 (let* ((method gnus-browse-current-method)
699 (orig-select-method gnus-select-method)
700 (gnus-select-method method)
702 (gnus-message 5 "Connecting to %s..." (nth 1 method))
704 ((not (gnus-check-server method))
706 1 "Unable to contact server %s: %s" (nth 1 method)
707 (gnus-status-message method))
711 (gnus-message 6 "Reading active file...")
712 (gnus-request-list method)
713 (gnus-message 6 "Reading active file...done")))
715 1 "Couldn't request list: %s" (gnus-status-message method))
718 (with-current-buffer nntp-server-buffer
719 (let ((cur (current-buffer)))
720 (goto-char (point-min))
721 (unless (string= gnus-ignored-newsgroups "")
722 (delete-matching-lines gnus-ignored-newsgroups))
723 ;; We treat NNTP as a special case to avoid problems with
724 ;; garbage group names like `"foo' that appear in some badly
725 ;; managed active files. -jh.
726 (if (eq (car method) 'nntp)
730 (mm-string-as-unibyte
734 (skip-chars-forward "^ \t")
736 (let ((last (read cur)))
737 (cons (read cur) last)))
743 (mm-string-as-unibyte
744 (if (eq (char-after) ?\")
746 (let ((p (point)) (name ""))
747 (skip-chars-forward "^ \t\\\\")
748 (setq name (buffer-substring p (point)))
749 (while (eq (char-after) ?\\)
750 (setq p (1+ (point)))
752 (skip-chars-forward "^ \t\\\\")
753 (setq name (concat name (buffer-substring
756 (let ((last (read cur)))
757 (cons (read cur) last)))
760 (setq groups (sort groups
762 (string< (car l1) (car l2)))))
763 (if gnus-server-browse-in-group-buffer
764 (let* ((gnus-select-method orig-select-method)
765 (gnus-group-listed-groups
766 (mapcar (lambda (group)
768 (gnus-group-prefixed-name
769 (car group) method)))
770 (gnus-set-active name (cdr group))
773 (gnus-configure-windows 'group)
774 (funcall gnus-group-prepare-function
775 gnus-level-killed 'ignore 1 'ignore))
776 (gnus-get-buffer-create gnus-browse-buffer)
778 (gnus-carpal-setup-buffer 'browse))
779 (gnus-configure-windows 'browse)
780 (buffer-disable-undo)
781 (let ((buffer-read-only nil))
784 (setq mode-line-buffer-identification
787 "Gnus: %%b {%s:%s}" (car method) (cadr method))))
788 (let ((buffer-read-only nil)
790 (prefix (let ((gnus-select-method orig-select-method))
791 (gnus-group-prefixed-name "" method))))
792 (while (setq group (pop groups))
793 (gnus-add-text-properties
797 (format "%c%7d: %s\n"
799 (if (string= prefix "")
800 (gnus-group-level (setq name (car group)))
802 (concat prefix (setq name (car group)))))))
804 ((<= level gnus-level-subscribed) ? )
805 ((<= level gnus-level-unsubscribed) ?U)
806 ((= level gnus-level-zombie) ?Z)
808 (max 0 (- (1+ (cddr group)) (cadr group)))
809 ;; Don't decode if name is ASCII
810 (if (and (fboundp 'detect-coding-string)
811 (eq (detect-coding-string name t) 'undecided))
813 (mm-decode-coding-string
815 (inline (gnus-group-name-charset method name)))))))
816 (list 'gnus-group name)
818 (switch-to-buffer (current-buffer)))
819 (goto-char (point-min))
820 (gnus-group-position-point)
821 (gnus-message 5 "Connecting to %s...done" (nth 1 method))
824 (defun gnus-browse-mode ()
825 "Major mode for browsing a foreign server.
827 All normal editing commands are switched off.
829 \\<gnus-browse-mode-map>
830 The only things you can do in this buffer is
832 1) `\\[gnus-browse-unsubscribe-current-group]' to subscribe to a group.
833 The group will be inserted into the group buffer upon exit from this
836 2) `\\[gnus-browse-read-group]' to read a group ephemerally.
838 3) `\\[gnus-browse-exit]' to return to the group buffer."
840 (kill-all-local-variables)
841 (when (gnus-visual-p 'browse-menu 'menu)
842 (gnus-browse-make-menu-bar))
843 (gnus-simplify-mode-line)
844 (setq major-mode 'gnus-browse-mode)
845 (setq mode-name "Browse Server")
846 (setq mode-line-process nil)
847 (use-local-map gnus-browse-mode-map)
848 (buffer-disable-undo)
849 (setq truncate-lines t)
850 (gnus-set-default-directory)
851 (setq buffer-read-only t)
852 (gnus-run-mode-hooks 'gnus-browse-mode-hook))
854 (defun gnus-browse-read-group (&optional no-article number)
855 "Enter the group at the current line.
856 If NUMBER, fetch this number of articles."
858 (let ((group (gnus-browse-group-name)))
859 (if (or (not (gnus-get-info group))
860 (gnus-ephemeral-group-p group))
861 (unless (gnus-group-read-ephemeral-group
862 group gnus-browse-current-method nil
863 (cons (current-buffer) 'browse)
865 (error "Couldn't enter %s" group))
866 (unless (gnus-group-read-group nil no-article group)
867 (error "Couldn't enter %s" group)))))
869 (defun gnus-browse-select-group (&optional number)
870 "Select the current group.
871 If NUMBER, fetch this number of articles."
873 (gnus-browse-read-group 'no number))
875 (defun gnus-browse-next-group (n)
876 "Go to the next group."
880 (gnus-group-position-point)))
882 (defun gnus-browse-prev-group (n)
883 "Go to the next group."
885 (gnus-browse-next-group (- n)))
887 (defun gnus-browse-unsubscribe-current-group (arg)
888 "(Un)subscribe to the next ARG groups."
891 (error "No group at current line"))
892 (let ((ward (if (< arg 0) -1 1))
894 (while (and (> arg 0)
896 (gnus-browse-unsubscribe-group)
897 (zerop (gnus-browse-next-group ward)))
899 (gnus-group-position-point)
901 (gnus-message 7 "No more newsgroups"))
904 (defun gnus-browse-group-name ()
907 (let ((name (get-text-property (point) 'gnus-group)))
908 (when (re-search-forward ": \\(.*\\)$" (point-at-eol) t)
909 (concat (gnus-method-to-server-name gnus-browse-current-method) ":"
911 (match-string-no-properties 1)))))))
913 (defun gnus-browse-describe-group (group)
914 "Describe the current group."
915 (interactive (list (gnus-browse-group-name)))
916 (gnus-group-describe-group nil group))
918 (defun gnus-browse-unsubscribe-group ()
919 "Toggle subscription of the current group in the browse buffer."
921 (buffer-read-only nil)
925 ;; If this group it killed, then we want to subscribe it.
926 (unless (eq (char-after) ? )
928 (setq group (gnus-browse-group-name))
929 (when (gnus-server-equal gnus-browse-current-method "native")
930 (setq group (gnus-group-real-name group)))
933 ;; Make sure the group has been properly removed before we
935 (if (gnus-ephemeral-group-p group)
936 (gnus-kill-ephemeral-group group))
937 ;; We need to discern between killed/zombie groups and
938 ;; just unsubscribed ones.
939 (gnus-group-change-level
940 (or (gnus-group-entry group)
941 (list t group gnus-level-default-subscribed
942 nil nil (if (gnus-server-equal
943 gnus-browse-current-method "native")
945 (gnus-method-simplify
946 gnus-browse-current-method))))
947 gnus-level-default-subscribed (gnus-group-level group)
948 (and (car (nth 1 gnus-newsrc-alist))
949 (gnus-group-entry (car (nth 1 gnus-newsrc-alist))))
950 (null (gnus-group-entry group)))
953 (gnus-group-change-level
954 group gnus-level-unsubscribed gnus-level-default-subscribed)
959 (defun gnus-browse-exit ()
960 "Quit browsing and return to the group buffer."
962 (when (eq major-mode 'gnus-browse-mode)
963 (gnus-kill-buffer (current-buffer)))
964 ;; Insert the newly subscribed groups in the group buffer.
965 (with-current-buffer gnus-group-buffer
966 (gnus-group-list-groups nil))
967 (if gnus-browse-return-buffer
968 (gnus-configure-windows 'server 'force)
969 (gnus-configure-windows 'group 'force)))
971 (defun gnus-browse-describe-briefly ()
972 "Give a one line description of the group mode commands."
975 (substitute-command-keys "\\<gnus-browse-mode-map>\\[gnus-group-next-group]:Forward \\[gnus-group-prev-group]:Backward \\[gnus-browse-exit]:Exit \\[gnus-info-find-node]:Run Info \\[gnus-browse-describe-briefly]:This help")))
977 (defun gnus-server-regenerate-server ()
978 "Issue a command to the server to regenerate all its data structures."
980 (let ((server (gnus-server-server-name)))
982 (error "No server on the current line"))
984 (gnus-get-function (gnus-server-to-method server)
987 (error "This back end doesn't support regeneration")))
988 (gnus-message 5 "Requesting regeneration of %s..." server)
989 (unless (gnus-open-server server)
990 (error "Couldn't open server"))
991 (if (gnus-request-regenerate server)
992 (gnus-message 5 "Requesting regeneration of %s...done" server)
993 (gnus-message 5 "Couldn't regenerate %s" server))))
997 ;;; Server compaction. -- dvl
1000 ;; #### FIXME: this function currently fails to update the Group buffer's
1002 (defun gnus-server-compact-server ()
1003 "Issue a command to the server to compact all its groups.
1005 Note: currently only implemented in nnml."
1007 (let ((server (gnus-server-server-name)))
1009 (error "No server on the current line"))
1011 (gnus-get-function (gnus-server-to-method server)
1014 (error "This back end doesn't support compaction")))
1016 Requesting compaction of %s... (this may take a long time)"
1018 (unless (gnus-open-server server)
1019 (error "Couldn't open server"))
1020 (if (not (gnus-request-compact server))
1021 (gnus-message 5 "Couldn't compact %s" server)
1022 (gnus-message 5 "Requesting compaction of %s...done" server)
1023 ;; Invalidate the original article buffer which might be out of date.
1024 ;; #### NOTE: Yes, this might be a bit rude, but since compaction
1025 ;; #### will not happen very often, I think this is acceptable.
1026 (let ((original (get-buffer gnus-original-article-buffer)))
1027 (and original (gnus-kill-buffer original))))))
1029 (provide 'gnus-srvr)
1031 ;; arch-tag: c0117f64-27ca-475d-9406-8da6854c7a25
1032 ;;; gnus-srvr.el ends here