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