]> code.delx.au - gnu-emacs/blob - lisp/gnus/gnus-ml.el
Add 2012 to FSF copyright years for Emacs files (do not merge to trunk)
[gnu-emacs] / lisp / gnus / gnus-ml.el
1 ;;; gnus-ml.el --- Mailing list minor mode for Gnus
2
3 ;; Copyright (C) 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
5
6 ;; Author: Julien Gilles <jgilles@free.fr>
7 ;; Keywords: news, mail
8
9 ;; This file is part of GNU Emacs.
10
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
15
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
20
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
23
24 ;;; Commentary:
25
26 ;; implement (small subset of) RFC 2369
27
28 ;;; Code:
29
30 (require 'gnus)
31 (require 'gnus-msg)
32 (eval-when-compile (require 'cl))
33
34 ;;; Mailing list minor mode
35
36 (defvar gnus-mailing-list-mode nil
37 "Minor mode for providing mailing-list commands.")
38
39 (defvar gnus-mailing-list-mode-map nil)
40
41 (defvar gnus-mailing-list-menu)
42
43 (unless gnus-mailing-list-mode-map
44 (setq gnus-mailing-list-mode-map (make-sparse-keymap))
45
46 (gnus-define-keys gnus-mailing-list-mode-map
47 "\C-c\C-nh" gnus-mailing-list-help
48 "\C-c\C-ns" gnus-mailing-list-subscribe
49 "\C-c\C-nu" gnus-mailing-list-unsubscribe
50 "\C-c\C-np" gnus-mailing-list-post
51 "\C-c\C-no" gnus-mailing-list-owner
52 "\C-c\C-na" gnus-mailing-list-archive))
53
54 (defun gnus-mailing-list-make-menu-bar ()
55 (unless (boundp 'gnus-mailing-list-menu)
56 (easy-menu-define
57 gnus-mailing-list-menu gnus-mailing-list-mode-map ""
58 '("Mailing-Lists"
59 ["Get help" gnus-mailing-list-help t]
60 ["Subscribe" gnus-mailing-list-subscribe t]
61 ["Unsubscribe" gnus-mailing-list-unsubscribe t]
62 ["Post a message" gnus-mailing-list-post t]
63 ["Mail to owner" gnus-mailing-list-owner t]
64 ["Browse archive" gnus-mailing-list-archive t]))))
65
66 ;;;###autoload
67 (defun turn-on-gnus-mailing-list-mode ()
68 (when (gnus-group-find-parameter gnus-newsgroup-name 'to-list)
69 (gnus-mailing-list-mode 1)))
70
71 ;;;###autoload
72 (defun gnus-mailing-list-insinuate (&optional force)
73 "Setup group parameters from List-Post header.
74 If FORCE is non-nil, replace the old ones."
75 (interactive "P")
76 (let ((list-post
77 (with-current-buffer gnus-original-article-buffer
78 (gnus-fetch-field "list-post"))))
79 (if list-post
80 (if (and (not force)
81 (gnus-group-get-parameter gnus-newsgroup-name 'to-list))
82 (gnus-message 1 "to-list is non-nil.")
83 (if (string-match "<mailto:\\([^>]*\\)>" list-post)
84 (setq list-post (match-string 1 list-post)))
85 (gnus-group-add-parameter gnus-newsgroup-name
86 (cons 'to-list list-post))
87 (gnus-mailing-list-mode 1))
88 (gnus-message 1 "no list-post in this message."))))
89
90 ;;;###autoload
91 (defun gnus-mailing-list-mode (&optional arg)
92 "Minor mode for providing mailing-list commands.
93
94 \\{gnus-mailing-list-mode-map}"
95 (interactive "P")
96 (when (eq major-mode 'gnus-summary-mode)
97 (when (set (make-local-variable 'gnus-mailing-list-mode)
98 (if (null arg) (not gnus-mailing-list-mode)
99 (> (prefix-numeric-value arg) 0)))
100 ;; Set up the menu.
101 (when (gnus-visual-p 'mailing-list-menu 'menu)
102 (gnus-mailing-list-make-menu-bar))
103 (add-minor-mode 'gnus-mailing-list-mode " Mailing-List"
104 gnus-mailing-list-mode-map)
105 (gnus-run-hooks 'gnus-mailing-list-mode-hook))))
106
107 ;;; Commands
108
109 (defun gnus-mailing-list-help ()
110 "Get help from mailing list server."
111 (interactive)
112 (let ((list-help
113 (with-current-buffer gnus-original-article-buffer
114 (gnus-fetch-field "list-help"))))
115 (cond (list-help (gnus-mailing-list-message list-help))
116 (t (gnus-message 1 "no list-help in this group")))))
117
118 (defun gnus-mailing-list-subscribe ()
119 "Subscribe to mailing list."
120 (interactive)
121 (let ((list-subscribe
122 (with-current-buffer gnus-original-article-buffer
123 (gnus-fetch-field "list-subscribe"))))
124 (cond (list-subscribe (gnus-mailing-list-message list-subscribe))
125 (t (gnus-message 1 "no list-subscribe in this group")))))
126
127 (defun gnus-mailing-list-unsubscribe ()
128 "Unsubscribe from mailing list."
129 (interactive)
130 (let ((list-unsubscribe
131 (with-current-buffer gnus-original-article-buffer
132 (gnus-fetch-field "list-unsubscribe"))))
133 (cond (list-unsubscribe (gnus-mailing-list-message list-unsubscribe))
134 (t (gnus-message 1 "no list-unsubscribe in this group")))))
135
136 (defun gnus-mailing-list-post ()
137 "Post message (really useful ?)"
138 (interactive)
139 (let ((list-post
140 (with-current-buffer gnus-original-article-buffer
141 (gnus-fetch-field "list-post"))))
142 (cond (list-post (gnus-mailing-list-message list-post))
143 (t (gnus-message 1 "no list-post in this group")))))
144
145 (defun gnus-mailing-list-owner ()
146 "Mail to the mailing list owner."
147 (interactive)
148 (let ((list-owner
149 (with-current-buffer gnus-original-article-buffer
150 (gnus-fetch-field "list-owner"))))
151 (cond (list-owner (gnus-mailing-list-message list-owner))
152 (t (gnus-message 1 "no list-owner in this group")))))
153
154 (defun gnus-mailing-list-archive ()
155 "Browse archive."
156 (interactive)
157 (require 'browse-url)
158 (let ((list-archive
159 (with-current-buffer gnus-original-article-buffer
160 (gnus-fetch-field "list-archive"))))
161 (cond (list-archive
162 (if (string-match "<\\(http:[^>]*\\)>" list-archive)
163 (browse-url (match-string 1 list-archive))
164 (browse-url list-archive)))
165 (t (gnus-message 1 "no list-archive in this group")))))
166
167 ;;; Utility functions
168
169 (defun gnus-mailing-list-message (address)
170 "Send message to ADDRESS.
171 ADDRESS is specified by a \"mailto:\" URL."
172 (cond
173 ((string-match "<\\(mailto:[^>]*\\)>" address)
174 (require 'gnus-art)
175 (gnus-url-mailto (match-string 1 address)))
176 ;; other case <http://...> to be done.
177 (t nil)))
178
179 (provide 'gnus-ml)
180
181 ;; arch-tag: 936c0fe6-acce-4c16-87d0-eded88078896
182 ;;; gnus-ml.el ends here