X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/a0a7e8c6de361d15703e78a1e934d0347475dcb8..68b962d42a9cc126759448484d23e10e2102d622:/lisp/midnight.el diff --git a/lisp/midnight.el b/lisp/midnight.el index a81ce37856..a3546fe7ad 100644 --- a/lisp/midnight.el +++ b/lisp/midnight.el @@ -1,6 +1,7 @@ ;;; midnight.el --- run something every midnight, e.g., kill old buffers -;;; Copyright (C) 1998, 2004, 2005 Free Software Foundation, Inc. +;; Copyright (C) 1998, 2001, 2002, 2003, 2004, 2005, +;; 2006, 2007, 2008, 2009 Free Software Foundation, Inc. ;; Author: Sam Steingold ;; Maintainer: Sam Steingold @@ -9,10 +10,10 @@ ;; This file is part of GNU Emacs. -;; GNU Emacs is free software; you can redistribute it and/or modify +;; GNU Emacs is free software: you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by -;; the Free Software Foundation; either version 2, or (at your option) -;; any later version. +;; the Free Software Foundation, either version 3 of the License, or +;; (at your option) any later version. ;; GNU Emacs is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -20,9 +21,7 @@ ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License -;; along with GNU Emacs; see the file COPYING. If not, write to the -;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, -;; Boston, MA 02111-1307, USA. +;; along with GNU Emacs. If not, see . ;;; Commentary: @@ -48,8 +47,13 @@ :group 'calendar :version "20.3") +(defvar midnight-timer nil + "Timer running the `midnight-hook' `midnight-delay' seconds after midnight. +Use `cancel-timer' to stop it and `midnight-delay-set' to change +the time when it is run.") + (defcustom midnight-mode nil - "*Non-nil means run `midnight-hook' at midnight. + "Non-nil means run `midnight-hook' at midnight. Setting this variable outside customize has no effect; call `cancel-timer' or `timer-activate' on `midnight-timer' instead." :type 'boolean @@ -69,15 +73,15 @@ call `cancel-timer' or `timer-activate' on `midnight-timer' instead." (list 1st (floor (- num (* (float div) 1st))) (round (* 10000000 (mod num 1)))))) -(defun midnight-buffer-display-time (&optional buf) - "Return the time-stamp of the given buffer, or current buffer, as float." - (with-current-buffer (or buf (current-buffer)) +(defun midnight-buffer-display-time (&optional buffer) + "Return the time-stamp of BUFFER, or current buffer, as float." + (with-current-buffer (or buffer (current-buffer)) (when buffer-display-time (float-time buffer-display-time)))) ;;; clean-buffer-list stuff (defcustom clean-buffer-list-delay-general 3 - "*The number of days before any buffer becomes eligible for autokilling. + "The number of days before any buffer becomes eligible for autokilling. The autokilling is done by `clean-buffer-list' when is it in `midnight-hook'. Currently displayed and/or modified (unsaved) buffers, as well as buffers matching `clean-buffer-list-kill-never-buffer-names' and @@ -86,7 +90,7 @@ matching `clean-buffer-list-kill-never-buffer-names' and :group 'midnight) (defcustom clean-buffer-list-delay-special 3600 - "*The number of seconds before some buffers become eligible for autokilling. + "The number of seconds before some buffers become eligible for autokilling. Buffers matched by `clean-buffer-list-kill-regexps' and `clean-buffer-list-kill-buffer-names' are killed if they were last displayed more than this many seconds ago." @@ -94,7 +98,7 @@ displayed more than this many seconds ago." :group 'midnight) (defcustom clean-buffer-list-kill-regexps nil - "*List of regexps saying which buffers will be killed at midnight. + "List of regexps saying which buffers will be killed at midnight. If buffer name matches a regexp in the list and the buffer was not displayed in the last `clean-buffer-list-delay-special' seconds, it is killed by `clean-buffer-list' when is it in `midnight-hook'. @@ -109,7 +113,7 @@ See also `clean-buffer-list-kill-buffer-names', (defcustom clean-buffer-list-kill-buffer-names '("*Help*" "*Apropos*" "*Man " "*Buffer List*" "*Compile-Log*" "*info*" "*vc*" "*vc-diff*" "*diff*") - "*List of strings saying which buffers will be killed at midnight. + "List of strings saying which buffers will be killed at midnight. Buffers with names in this list, which were not displayed in the last `clean-buffer-list-delay-special' seconds, are killed by `clean-buffer-list' when is it in `midnight-hook'. @@ -122,8 +126,8 @@ See also `clean-buffer-list-kill-regexps', :group 'midnight) (defcustom clean-buffer-list-kill-never-buffer-names - '("*scratch*" "*Messages*") - "*List of buffer names which will never be killed by `clean-buffer-list'. + '("*scratch*" "*Messages*" "*server*") + "List of buffer names which will never be killed by `clean-buffer-list'. See also `clean-buffer-list-kill-never-regexps'. Note that this does override `clean-buffer-list-kill-regexps' and `clean-buffer-list-kill-buffer-names' so a buffer matching any of these @@ -131,9 +135,8 @@ two lists will NOT be killed if it is also present in this list." :type '(repeat (string :tag "Buffer Name")) :group 'midnight) - (defcustom clean-buffer-list-kill-never-regexps '("^ \\*Minibuf-.*\\*$") - "*List of regexp saying which buffers will never be killed at midnight. + "List of regexp saying which buffers will never be killed at midnight. See also `clean-buffer-list-kill-never-buffer-names'. Killing is done by `clean-buffer-list'. Note that this does override `clean-buffer-list-kill-regexps' and @@ -173,20 +176,21 @@ displayed (can be nil if the buffer was never displayed) and its lifetime, i.e., its \"age\" when it will be purged." (interactive) (let ((tm (float-time)) bts (ts (format-time-string "%Y-%m-%d %T")) - (bufs (buffer-list)) buf delay cbld bn) - (while (setq buf (pop bufs)) - (setq bts (midnight-buffer-display-time buf) bn (buffer-name buf) - delay (if bts (- tm bts) 0) cbld (clean-buffer-list-delay bn)) - (message "[%s] `%s' [%s %d]" ts bn (if bts (round delay)) cbld) - (unless (or (midnight-find bn clean-buffer-list-kill-never-regexps - 'string-match) - (midnight-find bn clean-buffer-list-kill-never-buffer-names - 'string-equal) - (get-buffer-process buf) - (and (buffer-file-name buf) (buffer-modified-p buf)) - (get-buffer-window buf 'visible) (< delay cbld)) - (message "[%s] killing `%s'" ts bn) - (kill-buffer buf))))) + delay cbld bn) + (dolist (buf (buffer-list)) + (when (buffer-live-p buf) + (setq bts (midnight-buffer-display-time buf) bn (buffer-name buf) + delay (if bts (- tm bts) 0) cbld (clean-buffer-list-delay bn)) + (message "[%s] `%s' [%s %d]" ts bn (if bts (round delay)) cbld) + (unless (or (midnight-find bn clean-buffer-list-kill-never-regexps + 'string-match) + (midnight-find bn clean-buffer-list-kill-never-buffer-names + 'string-equal) + (get-buffer-process buf) + (and (buffer-file-name buf) (buffer-modified-p buf)) + (get-buffer-window buf 'visible) (< delay cbld)) + (message "[%s] killing `%s'" ts bn) + (kill-buffer buf)))))) ;;; midnight hook @@ -201,14 +205,10 @@ The default value is `clean-buffer-list'." (defun midnight-next () "Return the number of seconds till the next midnight." - (multiple-value-bind (sec min hrs) (decode-time) + (multiple-value-bind (sec min hrs) + (values-list (decode-time)) (- (* 24 60 60) (* 60 60 hrs) (* 60 min) sec))) -(defvar midnight-timer nil - "Timer running the `midnight-hook' `midnight-delay' seconds after midnight. -Use `cancel-timer' to stop it and `midnight-delay-set' to change -the time when it is run.") - ;;;###autoload (defun midnight-delay-set (symb tm) "Modify `midnight-timer' according to `midnight-delay'. @@ -223,7 +223,7 @@ to its second argument TM." midnight-period 'run-hooks 'midnight-hook))) (defcustom midnight-delay 3600 - "*The number of seconds after the midnight when the `midnight-timer' is run. + "The number of seconds after the midnight when the `midnight-timer' is run. You should set this variable before loading midnight.el, or set it by calling `midnight-delay-set', or use `custom'. If you wish, you can use a string instead, it will be passed as the @@ -234,5 +234,5 @@ first argument to `run-at-time'." (provide 'midnight) -;;; arch-tag: a5979be9-2890-46a3-ba84-791f0a4a6e80 +;; arch-tag: a5979be9-2890-46a3-ba84-791f0a4a6e80 ;;; midnight.el ends here