[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lisp/type-break.el [lexbind]
From: |
Miles Bader |
Subject: |
[Emacs-diffs] Changes to emacs/lisp/type-break.el [lexbind] |
Date: |
Tue, 14 Oct 2003 19:52:31 -0400 |
Index: emacs/lisp/type-break.el
diff -c /dev/null emacs/lisp/type-break.el:1.25.18.1
*** /dev/null Tue Oct 14 19:52:31 2003
--- emacs/lisp/type-break.el Tue Oct 14 19:51:26 2003
***************
*** 0 ****
--- 1,1094 ----
+ ;;; type-break.el --- encourage rests from typing at appropriate intervals
+
+ ;; Copyright (C) 1994, 95, 97, 2000 Free Software Foundation, Inc.
+
+ ;; Author: Noah Friedman
+ ;; Maintainer: Noah Friedman <address@hidden>
+ ;; Keywords: extensions, timers
+ ;; Status: Works in GNU Emacs 19.25 or later, some versions of XEmacs
+ ;; Created: 1994-07-13
+
+ ;; $Id: type-break.el,v 1.25.18.1 2003/10/14 23:51:26 miles Exp $
+
+ ;; This file is part of GNU Emacs.
+
+ ;; 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.
+
+ ;; GNU Emacs is distributed in the hope that it will be useful,
+ ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+ ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ ;; 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.
+
+ ;;; Commentary:
+
+ ;; The docstring for the function `type-break-mode' summarizes most of the
+ ;; details of the interface.
+
+ ;; This package relies on the assumption that you live entirely in emacs,
+ ;; as the author does. If that's not the case for you (e.g. you often
+ ;; suspend emacs or work in other windows) then this won't help very much;
+ ;; it will depend on just how often you switch back to emacs. At the very
+ ;; least, you will want to turn off the keystroke thresholds and rest
+ ;; interval tracking.
+
+ ;; If you prefer not to be queried about taking breaks, but instead just
+ ;; want to be reminded, do the following:
+ ;;
+ ;; (setq type-break-query-mode nil)
+ ;;
+ ;; Or call the command `type-break-query-mode' with a negative prefix
+ ;; argument.
+
+ ;; If you find echo area messages annoying and would prefer to see messages
+ ;; in the mode line instead, do M-x type-break-mode-line-message-mode
+ ;; or set the variable of the same name to `t'.
+
+ ;; This program can truly cons up a storm because of all the calls to
+ ;; `current-time' (which always returns 3 fresh conses). I'm dismayed by
+ ;; this, but I think the health of my hands is far more important than a
+ ;; few pages of virtual memory.
+
+ ;; This program has no hope of working in Emacs 18.
+
+ ;; This package was inspired by Roland McGrath's hanoi-break.el.
+ ;; Several people contributed feedback and ideas, including
+ ;; Roland McGrath <address@hidden>
+ ;; Kleanthes Koniaris <address@hidden>
+ ;; Mark Ashton <address@hidden>
+ ;; Matt Wilding <address@hidden>
+ ;; Robert S. Boyer <address@hidden>
+
+ ;;; Code:
+
+
+ (defgroup type-break nil
+ "Encourage the user to take a rest from typing at suitable intervals."
+ :prefix "type-break"
+ :group 'keyboard)
+
+ ;;;###autoload
+ (defcustom type-break-mode nil
+ "Toggle typing break mode.
+ See the docstring for the `type-break-mode' command for more information.
+ Setting this variable directly does not take effect;
+ use either \\[customize] or the function `type-break-mode'."
+ :set (lambda (symbol value)
+ (type-break-mode (if value 1 -1)))
+ :initialize 'custom-initialize-default
+ :type 'boolean
+ :group 'type-break
+ :require 'type-break)
+
+ ;;;###autoload
+ (defcustom type-break-interval (* 60 60)
+ "*Number of seconds between scheduled typing breaks."
+ :type 'integer
+ :group 'type-break)
+
+ ;;;###autoload
+ (defcustom type-break-good-rest-interval (/ type-break-interval 6)
+ "*Number of seconds of idle time considered to be an adequate typing rest.
+
+ When this variable is non-nil, emacs checks the idle time between
+ keystrokes. If this idle time is long enough to be considered a \"good\"
+ rest from typing, then the next typing break is simply rescheduled for later.
+
+ If a break is interrupted before this much time elapses, the user will be
+ asked whether or not really to interrupt the break."
+ :type 'integer
+ :group 'type-break)
+
+ ;;;###autoload
+ (defcustom type-break-keystroke-threshold
+ ;; Assuming typing speed is 35wpm (on the average, do you really
+ ;; type more than that in a minute? I spend a lot of time reading mail
+ ;; and simply studying code in buffers) and average word length is
+ ;; about 5 letters, default upper threshold to the average number of
+ ;; keystrokes one is likely to type in a break interval. That way if the
+ ;; user goes through a furious burst of typing activity, cause a typing
+ ;; break to be required sooner than originally scheduled.
+ ;; Conversely, the minimum threshold should be about a fifth of this.
+ (let* ((wpm 35)
+ (avg-word-length 5)
+ (upper (* wpm avg-word-length (/ type-break-interval 60)))
+ (lower (/ upper 5)))
+ (cons lower upper))
+ "*Upper and lower bound on number of keystrokes for considering typing
break.
+ This structure is a pair of numbers (MIN . MAX).
+
+ The first number is the minimum number of keystrokes that must have been
+ entered since the last typing break before considering another one, even if
+ the scheduled time has elapsed; the break is simply rescheduled until later
+ if the minimum threshold hasn't been reached. If this first value is nil,
+ then there is no minimum threshold; as soon as the scheduled time has
+ elapsed, the user will always be queried.
+
+ The second number is the maximum number of keystrokes that can be entered
+ before a typing break is requested immediately, pre-empting the originally
+ scheduled break. If this second value is nil, then no pre-emptive breaks
+ will occur; only scheduled ones will.
+
+ Keys with bucky bits (shift, control, meta, etc) are counted as only one
+ keystroke even though they really require multiple keys to generate them.
+
+ The command `type-break-guesstimate-keystroke-threshold' can be used to
+ guess a reasonably good pair of values for this variable."
+ :type 'sexp
+ :group 'type-break)
+
+ (defcustom type-break-query-mode t
+ "*Non-nil means ask whether or not to prompt user for breaks.
+ If so, call the function specified in the value of the variable
+ `type-break-query-function' to do the asking."
+ :type 'boolean
+ :group 'type-break)
+
+ (defcustom type-break-query-function 'yes-or-no-p
+ "*Function to use for making query for a typing break.
+ It should take a string as an argument, the prompt.
+ Usually this should be set to `yes-or-no-p' or `y-or-n-p'.
+
+ To avoid being queried at all, set `type-break-query-mode' to nil."
+ :type '(radio function
+ (function-item yes-or-no-p)
+ (function-item y-or-n-p))
+ :group 'type-break)
+
+ (defcustom type-break-query-interval 60
+ "*Number of seconds between queries to take a break, if put off.
+ The user will continue to be prompted at this interval until he or she
+ finally submits to taking a typing break."
+ :type 'integer
+ :group 'type-break)
+
+ (defcustom type-break-time-warning-intervals '(300 120 60 30)
+ "*List of time intervals for warnings about upcoming typing break.
+ At each of the intervals (specified in seconds) away from a scheduled
+ typing break, print a warning in the echo area."
+ :type '(repeat integer)
+ :group 'type-break)
+
+ (defcustom type-break-keystroke-warning-intervals '(300 200 100 50)
+ "*List of keystroke measurements for warnings about upcoming typing break.
+ At each of the intervals (specified in keystrokes) away from the upper
+ keystroke threshold, print a warning in the echo area.
+ If either this variable or the upper threshold is set, then no warnings
+ will occur."
+ :type '(repeat integer)
+ :group 'type-break)
+
+ (defcustom type-break-warning-repeat 40
+ "*Number of keystrokes for which warnings should be repeated.
+ That is, for each of this many keystrokes the warning is redisplayed
+ in the echo area to make sure it's really seen."
+ :type 'integer
+ :group 'type-break)
+
+ (defcustom type-break-time-stamp-format "[%H:%M] "
+ "*Timestamp format used to prefix messages.
+ Format specifiers are as used by `format-time-string'."
+ :type 'string
+ :group 'type-break)
+
+ (defcustom type-break-demo-functions
+ '(type-break-demo-boring type-break-demo-life type-break-demo-hanoi)
+ "*List of functions to consider running as demos during typing breaks.
+ When a typing break begins, one of these functions is selected randomly
+ to have emacs do something interesting.
+
+ Any function in this list should start a demo which ceases as soon as a
+ key is pressed."
+ :type '(repeat function)
+ :group 'type-break)
+
+ (defvar type-break-post-command-hook '(type-break-check)
+ "Hook run indirectly by post-command-hook for typing break functions.
+ This is not really intended to be set by the user, but it's probably
+ harmless to do so. Mainly it is used by various parts of the typing break
+ program to delay actions until after the user has completed some command.
+ It exists because `post-command-hook' itself is inaccessible while its
+ functions are being run, and some type-break--related functions want to
+ remove themselves after running.")
+
+
+ ;; Mode line frobs
+
+ (defcustom type-break-mode-line-message-mode nil
+ "*Non-nil means put type-break related messages in the mode line.
+ Otherwise, messages typically go in the echo area.
+
+ See also `type-break-mode-line-format' and its members."
+ :type 'boolean
+ :group 'type-break)
+
+ (defvar type-break-mode-line-format
+ '(type-break-mode-line-message-mode
+ (""
+ type-break-mode-line-break-message
+ type-break-mode-line-warning))
+ "*Format of messages in the mode line concerning typing breaks.")
+
+ (defvar type-break-mode-line-break-message
+ '(type-break-mode-line-break-message-p
+ type-break-mode-line-break-string))
+
+ (defvar type-break-mode-line-break-message-p nil)
+ (defvar type-break-mode-line-break-string " *** TAKE A TYPING BREAK NOW ***")
+
+ (defvar type-break-mode-line-warning
+ '(type-break-mode-line-break-message-p
+ ("")
+ (type-break-warning-countdown-string
+ (" *** "
+ "Break in "
+ type-break-warning-countdown-string
+ " "
+ type-break-warning-countdown-string-type
+ "***"))))
+
+ (defvar type-break-warning-countdown-string nil
+ "If non-nil, this is a countdown for the next typing break.
+
+ This variable, in conjunction with `type-break-warning-countdown-string-type'
+ \(which indicates whether this value is a number of keystrokes or seconds)
+ is installed in mode-line-format to notify of imminent typing breaks.")
+
+ (defvar type-break-warning-countdown-string-type nil
+ "Indicates the unit type of `type-break-warning-countdown-string'.
+ It will be either \"seconds\" or \"keystrokes\".")
+
+
+ ;; These are internal variables. Do not set them yourself.
+
+ (defvar type-break-alarm-p nil)
+ (defvar type-break-keystroke-count 0)
+ (defvar type-break-time-last-break nil)
+ (defvar type-break-time-next-break nil)
+ (defvar type-break-time-last-command (current-time))
+ (defvar type-break-current-time-warning-interval nil)
+ (defvar type-break-current-keystroke-warning-interval nil)
+ (defvar type-break-time-warning-count 0)
+ (defvar type-break-keystroke-warning-count 0)
+
+ ;; Constant indicating emacs variant.
+ ;; This can be one of `xemacs', `lucid', `epoch', `mule', etc.
+ (defconst type-break-emacs-variant
+ (let ((data (match-data))
+ (version (cond
+ ((fboundp 'nemacs-version)
+ (nemacs-version))
+ (t
+ (emacs-version))))
+ (alist '(("\\bXEmacs\\b" . xemacs)
+ ("\\bLucid\\b" . lucid)
+ ("^Nemacs\\b" . nemacs)
+ ("^GNU Emacs 19" . standard19)
+ ("^GNU Emacs 20" . standard19)
+ ("^GNU Emacs 18" . emacs18)))
+ result)
+ (while alist
+ (cond
+ ((string-match (car (car alist)) version)
+ (setq result (cdr (car alist)))
+ (setq alist nil))
+ (t
+ (setq alist (cdr alist)))))
+ (set-match-data data)
+ (cond ((eq result 'lucid)
+ (and (string= emacs-version "19.8 Lucid")
+ (setq result 'lucid-19-8)))
+ ((memq result '(nemacs emacs18))
+ (signal 'error
+ "type-break not supported in this version of emacs.")))
+ result))
+
+
+ ;;;###autoload
+ (defun type-break-mode (&optional prefix)
+ "Enable or disable typing-break mode.
+ This is a minor mode, but it is global to all buffers by default.
+
+ When this mode is enabled, the user is encouraged to take typing breaks at
+ appropriate intervals; either after a specified amount of time or when the
+ user has exceeded a keystroke threshold. When the time arrives, the user
+ is asked to take a break. If the user refuses at that time, emacs will ask
+ again in a short period of time. The idea is to give the user enough time
+ to find a good breaking point in his or her work, but be sufficiently
+ annoying to discourage putting typing breaks off indefinitely.
+
+ A negative prefix argument disables this mode.
+ No argument or any non-negative argument enables it.
+
+ The user may enable or disable this mode by setting the variable of the
+ same name, though setting it in that way doesn't reschedule a break or
+ reset the keystroke counter.
+
+ If the mode was previously disabled and is enabled as a consequence of
+ calling this function, it schedules a break with `type-break-schedule' to
+ make sure one occurs (the user can call that command to reschedule the
+ break at any time). It also initializes the keystroke counter.
+
+ The variable `type-break-interval' specifies the number of seconds to
+ schedule between regular typing breaks. This variable doesn't directly
+ affect the time schedule; it simply provides a default for the
+ `type-break-schedule' command.
+
+ If set, the variable `type-break-good-rest-interval' specifies the minimum
+ amount of time which is considered a reasonable typing break. Whenever
+ that time has elapsed, typing breaks are automatically rescheduled for
+ later even if emacs didn't prompt you to take one first. Also, if a break
+ is ended before this much time has elapsed, the user will be asked whether
+ or not to continue.
+
+ The variable `type-break-keystroke-threshold' is used to determine the
+ thresholds at which typing breaks should be considered. You can use
+ the command `type-break-guesstimate-keystroke-threshold' to try to
+ approximate good values for this.
+
+ There are several variables that affect how or when warning messages about
+ imminent typing breaks are displayed. They include:
+
+ `type-break-mode-line-message-mode'
+ `type-break-time-warning-intervals'
+ `type-break-keystroke-warning-intervals'
+ `type-break-warning-repeat'
+ `type-break-warning-countdown-string'
+ `type-break-warning-countdown-string-type'
+
+ There are several variables that affect if, how, and when queries to begin
+ a typing break occur. They include:
+
+ `type-break-query-mode'
+ `type-break-query-function'
+ `type-break-query-interval'
+
+ Finally, the command `type-break-statistics' prints interesting things."
+ (interactive "P")
+ (type-break-check-post-command-hook)
+
+ (let ((already-enabled type-break-mode))
+ (setq type-break-mode (>= (prefix-numeric-value prefix) 0))
+
+ (cond
+ ((and already-enabled type-break-mode)
+ (and (interactive-p)
+ (message "Type Break mode is already enabled")))
+ (type-break-mode
+ (or global-mode-string
+ (setq global-mode-string '("")))
+ (or (assq 'type-break-mode-line-message-mode
+ minor-mode-alist)
+ (setq minor-mode-alist
+ (cons type-break-mode-line-format
+ minor-mode-alist)))
+ (type-break-keystroke-reset)
+ (type-break-mode-line-countdown-or-break nil)
+ (type-break-schedule)
+ (and (interactive-p)
+ (message "Type Break mode is enabled and reset")))
+ (t
+ (type-break-keystroke-reset)
+ (type-break-mode-line-countdown-or-break nil)
+ (type-break-cancel-schedule)
+ (and (interactive-p)
+ (message "Type Break mode is disabled")))))
+ type-break-mode)
+
+ (defun type-break-mode-line-message-mode (&optional prefix)
+ "Enable or disable warnings in the mode line about typing breaks.
+
+ A negative prefix argument disables this mode.
+ No argument or any non-negative argument enables it.
+
+ The user may also enable or disable this mode simply by setting the
+ variable of the same name.
+
+ Variables controlling the display of messages in the mode line include:
+
+ `mode-line-format'
+ `global-mode-string'
+ `type-break-mode-line-break-message'
+ `type-break-mode-line-warning'"
+ (interactive "P")
+ (setq type-break-mode-line-message-mode
+ (>= (prefix-numeric-value prefix) 0))
+ (and (interactive-p)
+ (if type-break-mode-line-message-mode
+ (message "type-break-mode-line-message-mode is enabled")
+ (message "type-break-mode-line-message-mode is disabled")))
+ type-break-mode-line-message-mode)
+
+ (defun type-break-query-mode (&optional prefix)
+ "Enable or disable warnings in the mode line about typing breaks.
+
+ When enabled, the user is periodically queried about whether to take a
+ typing break at that moment. The function which does this query is
+ specified by the variable `type-break-query-function'.
+
+ A negative prefix argument disables this mode.
+ No argument or any non-negative argument enables it.
+
+ The user may also enable or disable this mode simply by setting the
+ variable of the same name."
+ (interactive "P")
+ (setq type-break-query-mode
+ (>= (prefix-numeric-value prefix) 0))
+ (and (interactive-p)
+ (if type-break-query-mode
+ (message "type-break-query-mode is enabled")
+ (message "type-break-query-mode is disabled")))
+ type-break-query-mode)
+
+
+ ;;;###autoload
+ (defun type-break ()
+ "Take a typing break.
+
+ During the break, a demo selected from the functions listed in
+ `type-break-demo-functions' is run.
+
+ After the typing break is finished, the next break is scheduled
+ as per the function `type-break-schedule'."
+ (interactive)
+ (do-auto-save)
+ (type-break-cancel-schedule)
+ (let ((continue t)
+ (start-time (current-time)))
+ (setq type-break-time-last-break start-time)
+ (while continue
+ (save-window-excursion
+ ;; Eat the screen.
+ (and (eq (selected-window) (minibuffer-window))
+ (other-window 1))
+ (delete-other-windows)
+ (scroll-right (window-width))
+ (message "Press any key to resume from typing break.")
+
+ (random t)
+ (let* ((len (length type-break-demo-functions))
+ (idx (random len))
+ (fn (nth idx type-break-demo-functions)))
+ (condition-case ()
+ (funcall fn)
+ (error nil))))
+
+ (cond
+ (type-break-good-rest-interval
+ (let ((break-secs (type-break-time-difference
+ start-time (current-time))))
+ (cond
+ ((>= break-secs type-break-good-rest-interval)
+ (setq continue nil))
+ ;; 60 seconds may be too much leeway if the break is only 3
+ ;; minutes to begin with. You can just say "no" to the query
+ ;; below if you're in that much of a hurry.
+ ;((> 60 (abs (- break-secs type-break-good-rest-interval)))
+ ; (setq continue nil))
+ ((funcall
+ type-break-query-function
+ (format "%sYou really ought to rest %s more. Continue break? "
+ (type-break-time-stamp)
+ (type-break-format-time (- type-break-good-rest-interval
+ break-secs)))))
+ (t
+ (setq continue nil)))))
+ (t (setq continue nil)))))
+
+ (type-break-keystroke-reset)
+ (type-break-mode-line-countdown-or-break nil)
+ (type-break-schedule))
+
+
+ (defun type-break-schedule (&optional time)
+ "Schedule a typing break for TIME seconds from now.
+ If time is not specified, default to `type-break-interval'."
+ (interactive (list (and current-prefix-arg
+ (prefix-numeric-value current-prefix-arg))))
+ (or time (setq time type-break-interval))
+ (type-break-check-post-command-hook)
+ (type-break-cancel-schedule)
+ (type-break-time-warning-schedule time 'reset)
+ (type-break-run-at-time (max 1 time) nil 'type-break-alarm)
+ (setq type-break-time-next-break
+ (type-break-time-sum (current-time) time)))
+
+ (defun type-break-cancel-schedule ()
+ (type-break-cancel-time-warning-schedule)
+ (type-break-cancel-function-timers 'type-break-alarm)
+ (setq type-break-alarm-p nil)
+ (setq type-break-time-next-break nil))
+
+ (defun type-break-time-warning-schedule (&optional time resetp)
+ (let ((type-break-current-time-warning-interval nil))
+ (type-break-cancel-time-warning-schedule))
+ (add-hook 'type-break-post-command-hook 'type-break-time-warning 'append)
+ (cond
+ (type-break-time-warning-intervals
+ (and resetp
+ (setq type-break-current-time-warning-interval
+ type-break-time-warning-intervals))
+
+ (or time
+ (setq time (type-break-time-difference (current-time)
+ type-break-time-next-break)))
+
+ (while (and type-break-current-time-warning-interval
+ (> (car type-break-current-time-warning-interval) time))
+ (setq type-break-current-time-warning-interval
+ (cdr type-break-current-time-warning-interval)))
+
+ (cond
+ (type-break-current-time-warning-interval
+ (setq time (- time (car type-break-current-time-warning-interval)))
+ (setq type-break-current-time-warning-interval
+ (cdr type-break-current-time-warning-interval))
+
+ ;(let (type-break-current-time-warning-interval)
+ ; (type-break-cancel-time-warning-schedule))
+ (type-break-run-at-time (max 1 time) nil 'type-break-time-warning-alarm)
+
+ (cond
+ (resetp
+ (setq type-break-warning-countdown-string nil))
+ (t
+ (setq type-break-warning-countdown-string (number-to-string time))
+ (setq type-break-warning-countdown-string-type "seconds"))))))))
+
+ (defun type-break-cancel-time-warning-schedule ()
+ (type-break-cancel-function-timers 'type-break-time-warning-alarm)
+ (remove-hook 'type-break-post-command-hook 'type-break-time-warning)
+ (setq type-break-current-time-warning-interval
+ type-break-time-warning-intervals)
+ (setq type-break-warning-countdown-string nil))
+
+ (defun type-break-alarm ()
+ (type-break-check-post-command-hook)
+ (setq type-break-alarm-p t)
+ (type-break-mode-line-countdown-or-break 'break))
+
+ (defun type-break-time-warning-alarm ()
+ (type-break-check-post-command-hook)
+ (type-break-time-warning-schedule)
+ (setq type-break-time-warning-count type-break-warning-repeat)
+ (type-break-time-warning)
+ (type-break-mode-line-countdown-or-break 'countdown))
+
+
+ (defun type-break-run-tb-post-command-hook ()
+ (and type-break-mode
+ (run-hooks 'type-break-post-command-hook)))
+
+ (defun type-break-check ()
+ "Ask to take a typing break if appropriate.
+ This may be the case either because the scheduled time has come \(and the
+ minimum keystroke threshold has been reached\) or because the maximum
+ keystroke threshold has been exceeded."
+ (let* ((min-threshold (car type-break-keystroke-threshold))
+ (max-threshold (cdr type-break-keystroke-threshold)))
+ (and type-break-good-rest-interval
+ (progn
+ (and (> (type-break-time-difference
+ type-break-time-last-command (current-time))
+ type-break-good-rest-interval)
+ (progn
+ (type-break-keystroke-reset)
+ (type-break-mode-line-countdown-or-break nil)
+ (setq type-break-time-last-break (current-time))
+ (type-break-schedule)))
+ (setq type-break-time-last-command (current-time))))
+
+ (and type-break-keystroke-threshold
+ (let ((keys (this-command-keys)))
+ (cond
+ ;; Ignore mouse motion
+ ((and (vectorp keys)
+ (consp (aref keys 0))
+ (memq (car (aref keys 0)) '(mouse-movement))))
+ (t
+ (setq type-break-keystroke-count
+ (+ type-break-keystroke-count (length keys)))))))
+
+ (cond
+ (type-break-alarm-p
+ (cond
+ ((input-pending-p))
+ ((eq (selected-window) (minibuffer-window)))
+ ((and min-threshold
+ (< type-break-keystroke-count min-threshold))
+ (type-break-schedule))
+ (t
+ ;; If keystroke count is within min-threshold of
+ ;; max-threshold, lower it to reduce the likelihood of an
+ ;; immediate subsequent query.
+ (and max-threshold
+ min-threshold
+ (< (- max-threshold type-break-keystroke-count) min-threshold)
+ (progn
+ (type-break-keystroke-reset)
+ (setq type-break-keystroke-count min-threshold)))
+ (type-break-query))))
+ ((and type-break-keystroke-warning-intervals
+ max-threshold
+ (= type-break-keystroke-warning-count 0)
+ (type-break-check-keystroke-warning)))
+ ((and max-threshold
+ (> type-break-keystroke-count max-threshold)
+ (not (input-pending-p))
+ (not (eq (selected-window) (minibuffer-window))))
+ (type-break-keystroke-reset)
+ (setq type-break-keystroke-count (or min-threshold 0))
+ (type-break-query)))))
+
+ ;; This should return t if warnings were enabled, nil otherwise.
+ (defun type-break-check-keystroke-warning ()
+ ;; This is safe because the caller should have checked that the cdr was
+ ;; non-nil already.
+ (let ((left (- (cdr type-break-keystroke-threshold)
+ type-break-keystroke-count)))
+ (cond
+ ((null (car type-break-current-keystroke-warning-interval))
+ nil)
+ ((> left (car type-break-current-keystroke-warning-interval))
+ nil)
+ (t
+ (while (and (car type-break-current-keystroke-warning-interval)
+ (< left (car
type-break-current-keystroke-warning-interval)))
+ (setq type-break-current-keystroke-warning-interval
+ (cdr type-break-current-keystroke-warning-interval)))
+ (setq type-break-keystroke-warning-count type-break-warning-repeat)
+ (add-hook 'type-break-post-command-hook 'type-break-keystroke-warning)
+ (setq type-break-warning-countdown-string (number-to-string left))
+ (setq type-break-warning-countdown-string-type "keystrokes")
+ (type-break-mode-line-countdown-or-break 'countdown)
+ t))))
+
+ ;; Arrange for a break query to be made, when the user stops typing furiously.
+ (defun type-break-query ()
+ (add-hook 'type-break-post-command-hook 'type-break-do-query))
+
+ (defun type-break-do-query ()
+ (cond
+ ((not type-break-query-mode)
+ (type-break-noninteractive-query)
+ (type-break-schedule type-break-query-interval)
+ (remove-hook 'type-break-post-command-hook 'type-break-do-query))
+ ((sit-for 2)
+ (condition-case ()
+ (cond
+ ((let ((type-break-mode nil)
+ ;; yes-or-no-p sets this-command to exit-minibuffer,
+ ;; which hoses undo or yank-pop (if you happened to be
+ ;; yanking just when the query occurred).
+ (this-command this-command))
+ ;; Cancel schedule to prevent possibility of a second query
+ ;; from taking place before this one has even returned.
+ ;; The condition-case wrapper will reschedule on quit.
+ (type-break-cancel-schedule)
+ (funcall type-break-query-function
+ (format "%s%s"
+ (type-break-time-stamp)
+ "Take a break from typing now? ")))
+ (type-break))
+ (t
+ (type-break-schedule type-break-query-interval)))
+ (quit
+ (type-break-schedule type-break-query-interval)))
+ (remove-hook 'type-break-post-command-hook 'type-break-do-query))))
+
+ (defun type-break-noninteractive-query (&optional ignored-args)
+ "Null query function which doesn't interrupt user and assumes `no'.
+ It prints a reminder in the echo area to take a break, but doesn't enforce
+ this or ask the user to start one right now."
+ (cond
+ (type-break-mode-line-message-mode)
+ (t
+ (beep t)
+ (message "%sYou should take a typing break now. Do `M-x type-break'."
+ (type-break-time-stamp))
+ (sit-for 1)
+ (beep t)
+ ;; return nil so query caller knows to reset reminder, as if user
+ ;; said "no" in response to yes-or-no-p.
+ nil)))
+
+ (defun type-break-time-warning ()
+ (cond
+ ((and (car type-break-keystroke-threshold)
+ (< type-break-keystroke-count (car type-break-keystroke-threshold))))
+ ((> type-break-time-warning-count 0)
+ (let ((timeleft (type-break-time-difference (current-time)
+ type-break-time-next-break)))
+ (setq type-break-warning-countdown-string (number-to-string timeleft))
+ (cond
+ ((eq (selected-window) (minibuffer-window)))
+ ;; Do nothing if the command was just a prefix arg, since that will
+ ;; immediately be followed by some other interactive command.
+ ;; Otherwise, it is particularly annoying for the sit-for below to
+ ;; delay redisplay when one types sequences like `C-u -1 C-l'.
+ ((memq this-command '(digit-argument universal-argument)))
+ ((not type-break-mode-line-message-mode)
+ ;; Pause for a moment so any previous message can be seen.
+ (sit-for 2)
+ (message "%sWarning: typing break due in %s."
+ (type-break-time-stamp)
+ (type-break-format-time timeleft))
+ (setq type-break-time-warning-count
+ (1- type-break-time-warning-count))))))
+ (t
+ (remove-hook 'type-break-post-command-hook 'type-break-time-warning)
+ (setq type-break-warning-countdown-string nil))))
+
+ (defun type-break-keystroke-warning ()
+ (cond
+ ((> type-break-keystroke-warning-count 0)
+ (setq type-break-warning-countdown-string
+ (number-to-string (- (cdr type-break-keystroke-threshold)
+ type-break-keystroke-count)))
+ (cond
+ ((eq (selected-window) (minibuffer-window)))
+ ;; Do nothing if the command was just a prefix arg, since that will
+ ;; immediately be followed by some other interactive command.
+ ;; Otherwise, it is particularly annoying for the sit-for below to
+ ;; delay redisplay when one types sequences like `C-u -1 C-l'.
+ ((memq this-command '(digit-argument universal-argument)))
+ ((not type-break-mode-line-message-mode)
+ (sit-for 2)
+ (message "%sWarning: typing break due in %s keystrokes."
+ (type-break-time-stamp)
+ (- (cdr type-break-keystroke-threshold)
+ type-break-keystroke-count))
+ (setq type-break-keystroke-warning-count
+ (1- type-break-keystroke-warning-count)))))
+ (t
+ (remove-hook 'type-break-post-command-hook
+ 'type-break-keystroke-warning)
+ (setq type-break-warning-countdown-string nil))))
+
+ (defun type-break-mode-line-countdown-or-break (&optional type)
+ (cond
+ ((not type-break-mode-line-message-mode))
+ ((eq type 'countdown)
+ ;(setq type-break-mode-line-break-message-p nil)
+ (add-hook 'type-break-post-command-hook
+ 'type-break-force-mode-line-update 'append))
+ ((eq type 'break)
+ ;; Alternate
+ (setq type-break-mode-line-break-message-p
+ (not type-break-mode-line-break-message-p))
+ (remove-hook 'type-break-post-command-hook
+ 'type-break-force-mode-line-update))
+ (t
+ (setq type-break-mode-line-break-message-p nil)
+ (setq type-break-warning-countdown-string nil)
+ (remove-hook 'type-break-post-command-hook
+ 'type-break-force-mode-line-update)))
+ (type-break-force-mode-line-update))
+
+
+ ;;;###autoload
+ (defun type-break-statistics ()
+ "Print statistics about typing breaks in a temporary buffer.
+ This includes the last time a typing break was taken, when the next one is
+ scheduled, the keystroke thresholds and the current keystroke count, etc."
+ (interactive)
+ (with-output-to-temp-buffer "*Typing Break Statistics*"
+ (princ (format "Typing break statistics\n-----------------------\n
+ Typing break mode is currently %s.
+ Interactive query for breaks is %s.
+ Warnings of imminent typing breaks in mode line is %s.
+
+ Last typing break ended : %s
+ Next scheduled typing break : %s\n
+ Minimum keystroke threshold : %s
+ Maximum keystroke threshold : %s
+ Current keystroke count : %s"
+ (if type-break-mode "enabled" "disabled")
+ (if type-break-query-mode "enabled" "disabled")
+ (if type-break-mode-line-message-mode "enabled" "disabled")
+ (if type-break-time-last-break
+ (current-time-string type-break-time-last-break)
+ "never")
+ (if (and type-break-mode type-break-time-next-break)
+ (format "%s\t(%s from now)"
+ (current-time-string
type-break-time-next-break)
+ (type-break-format-time
+ (type-break-time-difference
+ (current-time)
+ type-break-time-next-break)))
+ "none scheduled")
+ (or (car type-break-keystroke-threshold) "none")
+ (or (cdr type-break-keystroke-threshold) "none")
+ type-break-keystroke-count))))
+
+ ;;;###autoload
+ (defun type-break-guesstimate-keystroke-threshold (wpm &optional wordlen frac)
+ "Guess values for the minimum/maximum keystroke threshold for typing breaks.
+
+ If called interactively, the user is prompted for their guess as to how
+ many words per minute they usually type. This value should not be your
+ maximum WPM, but your average. Of course, this is harder to gauge since it
+ can vary considerably depending on what you are doing. For example, one
+ tends to type less when debugging a program as opposed to writing
+ documentation. (Perhaps a separate program should be written to estimate
+ average typing speed.)
+
+ From that, this command sets the values in `type-break-keystroke-threshold'
+ based on a fairly simple algorithm involving assumptions about the average
+ length of words (5). For the minimum threshold, it uses about a fifth of
+ the computed maximum threshold.
+
+ When called from lisp programs, the optional args WORDLEN and FRAC can be
+ used to override the default assumption about average word length and the
+ fraction of the maximum threshold to which to set the minimum threshold.
+ FRAC should be the inverse of the fractional value; for example, a value of
+ 2 would mean to use one half, a value of 4 would mean to use one quarter,
etc."
+ (interactive "NOn average, how many words per minute do you type? ")
+ (let* ((upper (* wpm (or wordlen 5) (/ type-break-interval 60)))
+ (lower (/ upper (or frac 5))))
+ (or type-break-keystroke-threshold
+ (setq type-break-keystroke-threshold (cons nil nil)))
+ (setcar type-break-keystroke-threshold lower)
+ (setcdr type-break-keystroke-threshold upper)
+ (if (interactive-p)
+ (message "min threshold: %d\tmax threshold: %d" lower upper)
+ type-break-keystroke-threshold)))
+
+
+ ;;; misc functions
+
+ ;; Compute the difference, in seconds, between a and b, two structures
+ ;; similar to those returned by `current-time'.
+ ;; Use addition rather than logand since that is more robust; the low 16
+ ;; bits of the seconds might have been incremented, making it more than 16
+ ;; bits wide.
+ (defun type-break-time-difference (a b)
+ (+ (lsh (- (car b) (car a)) 16)
+ (- (car (cdr b)) (car (cdr a)))))
+
+ ;; Return (in a new list the same in structure to that returned by
+ ;; `current-time') the sum of the arguments. Each argument may be a time
+ ;; list or a single integer, a number of seconds.
+ ;; This function keeps the high and low 16 bits of the seconds properly
+ ;; balanced so that the lower value never exceeds 16 bits. Otherwise, when
+ ;; the result is passed to `current-time-string' it will toss some of the
+ ;; "low" bits and format the time incorrectly.
+ (defun type-break-time-sum (&rest tmlist)
+ (let ((high 0)
+ (low 0)
+ (micro 0)
+ tem)
+ (while tmlist
+ (setq tem (car tmlist))
+ (setq tmlist (cdr tmlist))
+ (cond
+ ((numberp tem)
+ (setq low (+ low tem)))
+ (t
+ (setq high (+ high (or (car tem) 0)))
+ (setq low (+ low (or (car (cdr tem)) 0)))
+ (setq micro (+ micro (or (car (cdr (cdr tem))) 0))))))
+
+ (and (>= micro 1000000)
+ (progn
+ (setq tem (/ micro 1000000))
+ (setq low (+ low tem))
+ (setq micro (- micro (* tem 1000000)))))
+
+ (setq tem (lsh low -16))
+ (and (> tem 0)
+ (progn
+ (setq low (logand low 65535))
+ (setq high (+ high tem))))
+
+ (list high low micro)))
+
+ (defun type-break-time-stamp (&optional when)
+ (if (fboundp 'format-time-string)
+ (format-time-string type-break-time-stamp-format when)
+ ;; Emacs 19.28 and prior do not have format-time-string.
+ ;; In that case, result is not customizable. Upgrade today!
+ (format "[%s] " (substring (current-time-string when) 11 16))))
+
+ (defun type-break-format-time (secs)
+ (let ((mins (/ secs 60)))
+ (cond
+ ((= mins 1) (format "%d minute" mins))
+ ((> mins 0) (format "%d minutes" mins))
+ ((= secs 1) (format "%d second" secs))
+ (t (format "%d seconds" secs)))))
+
+ (defun type-break-keystroke-reset ()
+ (setq type-break-keystroke-count 0)
+ (setq type-break-keystroke-warning-count 0)
+ (setq type-break-current-keystroke-warning-interval
+ type-break-keystroke-warning-intervals)
+ (remove-hook 'type-break-post-command-hook 'type-break-keystroke-warning))
+
+ (defun type-break-force-mode-line-update (&optional all)
+ "Force the mode-line of the current buffer to be redisplayed.
+ With optional non-nil ALL, force redisplay of all mode-lines."
+ (and all (save-excursion (set-buffer (other-buffer))))
+ (set-buffer-modified-p (buffer-modified-p)))
+
+ ;; If an exception occurs in emacs while running the post command hook, the
+ ;; value of that hook is clobbered. This is because the value of the
+ ;; variable is temporarily set to nil while it's running to prevent
+ ;; recursive application, but it also means an exception aborts the routine
+ ;; of restoring it. This function is called from the timers to restore it,
+ ;; just in case.
+ (defun type-break-check-post-command-hook ()
+ (add-hook 'post-command-hook 'type-break-run-tb-post-command-hook 'append))
+
+
+ ;;; Timer wrapper functions
+ ;;;
+ ;;; These shield type-break from variations in the interval timer packages
+ ;;; for different versions of emacs.
+
+ (defun type-break-run-at-time (time repeat function)
+ (cond ((eq type-break-emacs-variant 'standard19)
+ (require 'timer)
+ (funcall 'run-at-time time repeat function))
+ ((eq type-break-emacs-variant 'lucid-19-8)
+ (let ((name (if (symbolp function)
+ (symbol-name function)
+ "type-break")))
+ (require 'timer)
+ (funcall 'start-timer name function time repeat)))
+ ((memq type-break-emacs-variant '(xemacs lucid))
+ (let ((name (if (symbolp function)
+ (symbol-name function)
+ "type-break")))
+ (require 'itimer)
+ (funcall 'start-itimer name function time repeat)))))
+
+ (defun type-break-cancel-function-timers (function)
+ (cond ((eq type-break-emacs-variant 'standard19)
+ (let ((timer-dont-exit t))
+ (funcall 'cancel-function-timers function)))
+ ((eq type-break-emacs-variant 'lucid-19-8)
+ (let ((list timer-list))
+ (while list
+ (and (eq (funcall 'timer-function (car list)) function)
+ (funcall 'delete-timer (car list)))
+ (setq list (cdr list)))))
+ ((memq type-break-emacs-variant '(xemacs lucid))
+ (with-no-warnings
+ (let ((list itimer-list))
+ (while list
+ (and (eq (funcall 'itimer-function (car list)) function)
+ (funcall 'delete-itimer (car list)))
+ (setq list (cdr list))))))))
+
+
+ ;;; Demo wrappers
+
+ ;; This is a wrapper around hanoi that calls it with an arg large enough to
+ ;; make the largest discs possible that will fit in the window.
+ ;; Also, clean up the *Hanoi* buffer after we're done.
+ (defun type-break-demo-hanoi ()
+ "Take a hanoiing typing break."
+ (and (get-buffer "*Hanoi*")
+ (kill-buffer "*Hanoi*"))
+ (condition-case ()
+ (progn
+ (hanoi (/ (window-width) 8))
+ ;; Wait for user to come back.
+ (read-char)
+ (kill-buffer "*Hanoi*"))
+ (quit
+ ;; eat char
+ (read-char)
+ (and (get-buffer "*Hanoi*")
+ (kill-buffer "*Hanoi*")))))
+
+ ;; This is a wrapper around life that calls it with a `sleep' arg to make
+ ;; it run a little more leisurely.
+ ;; Also, clean up the *Life* buffer after we're done.
+ (defun type-break-demo-life ()
+ "Take a typing break and get a life."
+ (let ((continue t))
+ (while continue
+ (setq continue nil)
+ (and (get-buffer "*Life*")
+ (kill-buffer "*Life*"))
+ (condition-case ()
+ (progn
+ (life 3)
+ ;; wait for user to return
+ (read-char)
+ (kill-buffer "*Life*"))
+ (life-extinct
+ (message "%s" (get 'life-extinct 'error-message))
+ (sit-for 3)
+ ;; restart demo
+ (setq continue t))
+ (quit
+ (and (get-buffer "*Life*")
+ (kill-buffer "*Life*")))))))
+
+ ;; Boring demo, but doesn't use many cycles
+ (defun type-break-demo-boring ()
+ "Boring typing break demo."
+ (let ((rmsg "Press any key to resume from typing break")
+ (buffer-name "*Typing Break Buffer*")
+ line col pos
+ elapsed timeleft tmsg)
+ (condition-case ()
+ (progn
+ (switch-to-buffer (get-buffer-create buffer-name))
+ (buffer-disable-undo (current-buffer))
+ (erase-buffer)
+ (setq line (1+ (/ (window-height) 2)))
+ (setq col (/ (- (window-width) (length rmsg)) 2))
+ (insert (make-string line ?\C-j)
+ (make-string col ?\ )
+ rmsg)
+ (forward-line -1)
+ (beginning-of-line)
+ (setq pos (point))
+ (while (not (input-pending-p))
+ (delete-region pos (progn
+ (goto-char pos)
+ (end-of-line)
+ (point)))
+ (setq elapsed (type-break-time-difference
+ type-break-time-last-break
+ (current-time)))
+ (cond
+ (type-break-good-rest-interval
+ (setq timeleft (- type-break-good-rest-interval elapsed))
+ (if (> timeleft 0)
+ (setq tmsg (format "You should rest for %s more"
+ (type-break-format-time timeleft)))
+ (setq tmsg (format "Typing break has lasted %s"
+ (type-break-format-time elapsed)))))
+ (t
+ (setq tmsg (format "Typing break has lasted %s"
+ (type-break-format-time elapsed)))))
+ (setq col (/ (- (window-width) (length tmsg)) 2))
+ (insert (make-string col ?\ ) tmsg)
+ (goto-char (point-min))
+ (sit-for 60))
+ (read-char)
+ (kill-buffer buffer-name))
+ (quit
+ (and (get-buffer buffer-name)
+ (kill-buffer buffer-name))))))
+
+
+ (provide 'type-break)
+
+ (if type-break-mode
+ (type-break-mode 1))
+
+ ;;; arch-tag: 943a2eb3-07e6-420b-993f-96e4796f5fd0
+ ;;; type-break.el ends here
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/lisp/type-break.el [lexbind],
Miles Bader <=