lisp/emacs-lisp/gulp.el

   1 ;;; gulp.el --- ask for updates for Lisp packages
   2
   3 ;; Copyright (C) 1996, 2001, 2002, 2003, 2004, 2005,
   4 ;;   2006, 2007, 2008, 2009 Free Software Foundation, Inc.
   5
   6 ;; Author: Sam Shteingold <shteingd@math.ucla.edu>
   7 ;; Maintainer: FSF
   8 ;; Keywords: maintenance
   9
  10 ;; This file is part of GNU Emacs.
  11
  12 ;; GNU Emacs is free software: you can redistribute it and/or modify
  13 ;; it under the terms of the GNU General Public License as published by
  14 ;; the Free Software Foundation, either version 3 of the License, or
  15 ;; (at your option) any later version.
  16
  17 ;; GNU Emacs is distributed in the hope that it will be useful,
  18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 ;; GNU General Public License for more details.
  21
  22 ;; You should have received a copy of the GNU General Public License
  23 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  24
  25 ;;; Commentary:
  26
  27 ;; Search the emacs/{version}/lisp directory for *.el files, extract the
  28 ;; name of the author or maintainer and send him e-mail requesting
  29 ;; update.
  30
  31 ;;; Code:
  32 (defgroup gulp nil
  33   "Ask for updates for Lisp packages."
  34   :prefix "-"
  35   :group 'maint)
  36
  37 (defcustom gulp-discard "^;+ *Maintainer: *FSF *$"
  38   "The regexp matching the packages not requiring the request for updates."
  39   :type 'regexp
  40   :group 'gulp)
  41
  42 (defcustom gulp-tmp-buffer "*gulp*"
  43   "The name of the temporary buffer."
  44   :type 'string
  45   :group 'gulp)
  46
  47 (defcustom gulp-max-len 2000
  48   "Distance into a Lisp source file to scan for keywords."
  49   :type 'integer
  50   :group 'gulp)
  51
  52 (defcustom gulp-request-header
  53   (concat
  54    "This message was created automatically.
  55 I'm going to start pretesting a new version of GNU Emacs soon, so I'd
  56 like to ask if you have any updates for the Emacs packages you work on.
  57 You're listed as the maintainer of the following package(s):\n\n")
  58   "The starting text of a gulp message."
  59   :type 'string
  60   :group 'gulp)
  61
  62 (defcustom gulp-request-end
  63   (concat
  64    "\nIf you have any changes since the version in the previous release ("
  65    (format "%d.%d" emacs-major-version emacs-minor-version)
  66    "),
  67 please send them to me ASAP.
  68
  69 Please don't send the whole file.  Instead, please send a patch made with
  70 `diff -c' that shows precisely the changes you would like me to install.
  71 Also please include itemized change log entries for your changes;
  72 please use lisp/ChangeLog as a guide for the style and for what kinds
  73 of information to include.
  74
  75 Thanks.")
  76   "The closing text in a gulp message."
  77   :type 'string
  78   :group 'gulp)
  79
  80 (declare-function mail-subject "sendmail" ())
  81 (declare-function mail-send "sendmail" ())
  82
  83 (defun gulp-send-requests (dir &optional time)
  84   "Send requests for updates to the authors of Lisp packages in directory DIR.
  85 For each maintainer, the message consists of `gulp-request-header',
  86 followed by the list of packages (with modification times if the optional
  87 prefix argument TIME is non-nil), concluded with `gulp-request-end'.
  88
  89 You can't edit the messages, but you can confirm whether to send each one.
  90
  91 The list of addresses for which you decided not to send mail
  92 is left in the `*gulp*' buffer at the end."
  93   (interactive "DRequest updates for Lisp directory: \nP")
  94   (save-excursion
  95     (set-buffer (get-buffer-create gulp-tmp-buffer))
  96     (let ((m-p-alist (gulp-create-m-p-alist
  97                       (directory-files dir nil "^[^=].*\\.el$" t)
  98                       dir))
  99           ;; Temporarily inhibit undo in the *gulp* buffer.
 100           (buffer-undo-list t)
 101           mail-setup-hook msg node)
 102       (setq m-p-alist
 103             (sort m-p-alist
 104                   (function (lambda (a b)
 105                               (string< (car a) (car b))))))
 106       (while (setq node (car m-p-alist))
 107         (setq msg (gulp-create-message (cdr node) time))
 108         (setq mail-setup-hook
 109               (lambda ()
 110                 (mail-subject)
 111                 (insert "It's time for Emacs updates again")
 112                 (goto-char (point-max))
 113                 (insert msg)))
 114         (mail nil (car node))
 115         (goto-char (point-min))
 116         (if (y-or-n-p "Send? ") (mail-send)
 117           (kill-this-buffer)
 118           (set-buffer gulp-tmp-buffer)
 119           (insert (format "%s\n\n" node)))
 120         (setq m-p-alist (cdr m-p-alist))))
 121     (set-buffer gulp-tmp-buffer)
 122     (setq buffer-undo-list nil)))
 123
 124
 125 (defun gulp-create-message (rec time)
 126   "Return the message string for REC, which is a list like (FILE TIME)."
 127   (let (node (str gulp-request-header))
 128     (while (setq node (car rec))
 129       (setq str (concat str "\t" (car node)
 130                         (if time (concat "\tLast modified:\t" (cdr node)))
 131                         "\n"))
 132       (setq rec (cdr rec)))
 133     (concat str gulp-request-end)))
 134
 135
 136 (defun gulp-create-m-p-alist (flist dir)
 137   "Create the maintainer/package alist for files in FLIST in DIR.
 138 That is a list of elements, each of the form (MAINTAINER PACKAGES...)."
 139   (save-excursion
 140     (let (mplist filen node mnt-tm mnt tm fl-tm)
 141       (get-buffer-create gulp-tmp-buffer)
 142       (set-buffer gulp-tmp-buffer)
 143       (setq buffer-undo-list t)
 144       (while flist
 145         (setq fl-tm (gulp-maintainer (setq filen (car flist)) dir))
 146         (if (setq tm (cdr fl-tm) mnt (car fl-tm));; there is a definite maintainer
 147             (if (setq node (assoc mnt mplist));; this is not a new maintainer
 148                 (setq mplist (cons (cons mnt (cons (cons filen tm) (cdr node)))
 149                                    (delete node mplist)))
 150               (setq mplist (cons (list mnt (cons filen (cdr fl-tm))) mplist))))
 151         (setq flist (cdr flist)))
 152       (erase-buffer)
 153       mplist)))
 154
 155 (defun gulp-maintainer (filenm dir)
 156   "Return a list (MAINTAINER TIMESTAMP) for the package FILENM in directory DIR."
 157   (save-excursion
 158     (let* ((fl (expand-file-name filenm dir)) mnt
 159            (timest (format-time-string "%Y-%m-%d %a %T %Z"
 160                                        (elt (file-attributes fl) 5))))
 161       (set-buffer gulp-tmp-buffer)
 162       (erase-buffer)
 163       (insert-file-contents fl nil 0 gulp-max-len)
 164       (goto-char 1)
 165       (if (re-search-forward gulp-discard nil t)
 166           (setq mnt nil) ;; do nothing, return nil
 167         (goto-char 1)
 168         (if (and (re-search-forward "^;+ *Maintainer: \\(.*\\)$" nil t)
 169                  (> (length (setq mnt (match-string 1))) 0))
 170             () ;; found!
 171           (goto-char 1)
 172           (if (re-search-forward "^;+ *Author: \\(.*\\)$" nil t)
 173               (setq mnt (match-string 1))))
 174         (if (= (length mnt) 0) (setq mnt nil))) ;; "^;; Author: $" --> nil
 175       (cons mnt timest))))
 176
 177 (provide 'gulp)
 178
 179 ;; arch-tag: 42750a11-460a-4efc-829f-342d075530e5
 180 ;;; gulp.el ends here