lisp/gnus/gnus-ml.el

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