X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/e516799970be4553edae8ca46d5f64852befec77..ca2ebe63eba27e234394e9c5c20229dcdce87b33:/lisp/map-ynp.el diff --git a/lisp/map-ynp.el b/lisp/map-ynp.el index 16b3424679..ce50e98c6c 100644 --- a/lisp/map-ynp.el +++ b/lisp/map-ynp.el @@ -1,49 +1,44 @@ ;;; map-ynp.el --- General-purpose boolean question-asker. +;; Copyright (C) 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. + ;; Author: Roland McGrath -;; Last-Modified: 14 Mar 1992 - -;;; Copyright (C) 1991, 1992 Free Software Foundation, Inc. -;;; -;;; This program 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. -;;; -;;; This program 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. -;;; -;;; A copy of the GNU General Public License can be obtained from this -;;; program's author (send electronic mail to roland@ai.mit.edu) or from -;;; the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA -;;; 02139, USA. +;; Maintainer: FSF +;; Keywords: lisp, extensions + +;; 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: -;;; map-y-or-n-p is a general-purpose question-asking function. -;;; It asks a series of y/n questions (a la y-or-n-p), and decides to -;;; applies an action to each element of a list based on the answer. -;;; The nice thing is that you also get some other possible answers -;;; to use, reminiscent of query-replace: ! to answer y to all remaining -;;; questions; ESC or q to answer n to all remaining questions; . to answer -;;; y once and then n for the remainder; and you can get help with C-h. +;; map-y-or-n-p is a general-purpose question-asking function. +;; It asks a series of y/n questions (a la y-or-n-p), and decides to +;; apply an action to each element of a list based on the answer. +;; The nice thing is that you also get some other possible answers +;; to use, reminiscent of query-replace: ! to answer y to all remaining +;; questions; ESC or q to answer n to all remaining questions; . to answer +;; y once and then n for the remainder; and you can get help with C-h. ;;; Code: -(defun map-y-or-n-p-help (object objects action) - (format "Type SPC or `y' to %s the current %s; -DEL or `n' to skip the current %s; -! to %s all remaining %s; -ESC or `q' to exit; -or . (period) to %s the current %s and exit." - action object object action objects action object)) - -;;;###autoload -(defun map-y-or-n-p (prompter actor list &optional help) +(defun map-y-or-n-p (prompter actor list &optional help action-alist + no-cursor-in-echo-area) "Ask a series of boolean questions. -Takes args PROMPTER ACTOR LIST, and optional arg HELP. +Takes args PROMPTER ACTOR LIST, and optional args HELP and ACTION-ALIST. LIST is a list of objects, or a function of no arguments to return the next object or nil. @@ -51,10 +46,8 @@ object or nil. If PROMPTER is a string, the prompt is \(format PROMPTER OBJECT\). If not a string, PROMPTER is a function of one arg (an object from LIST), which returns a string to be used as the prompt for that object. If the return -value is not a string, it is eval'd to get the answer; it may be nil to -ignore the object, t to act on the object without asking the user, or a -form to do a more complex prompt. - +value is not a string, it may be nil to ignore the object or non-nil to act +on the object without asking the user. ACTOR is a function of one arg (an object from LIST), which gets called with each object that the user answers `yes' for. @@ -69,17 +62,29 @@ n, N, or DEL to skip that object; ! to act on all following objects; ESC or q to exit (skip all following objects); . (period) to act on the current object and then exit; or \\[help-command] to get help. +If ACTION-ALIST is given, it is an alist (KEY FUNCTION HELP) of extra keys +that will be accepted. KEY is a character; FUNCTION is a function of one +arg (an object from LIST); HELP is a string. When the user hits KEY, +FUNCTION is called. If it returns non-nil, the object is considered +\"acted upon\", and the next object from LIST is processed. If it returns +nil, the prompt is repeated for the same object. + +Final optional argument NO-CURSOR-IN-ECHO-AREA non-nil says not to set +`cursor-in-echo-area' while prompting. + +This function uses `query-replace-map' to define the standard responses, +but not all of the responses which `query-replace' understands +are meaningful here. + Returns the number of actions taken." - (let* ((old-help-form help-form) - (help-form (cons 'map-y-or-n-p-help - (or help '("object" "objects" "act on")))) - (actions 0) - prompt - char - elt - (next (if (or (symbolp list) + (let* ((actions 0) + user-keys mouse-event map prompt char elt tail def + ;; Non-nil means we should use mouse menus to ask. + use-menus + delayed-switch-frame + (next (if (or (and list (symbolp list)) (subrp list) - (compiled-function-p list) + (byte-code-function-p list) (and (consp list) (eq (car list) 'lambda))) (function (lambda () @@ -91,69 +96,160 @@ Returns the number of actions taken." list (cdr list)) t) nil)))))) - (if (stringp prompter) - (setq prompter (` (lambda (object) - (format (, prompter) object))))) - (while (funcall next) - (setq prompt (funcall prompter elt)) - (if (stringp prompt) - (progn - ;; Prompt the user about this object. - (let ((cursor-in-echo-area t)) - (message "%s(y, n, ! ., q, or %s)" - prompt (key-description (char-to-string help-char))) - (setq char (read-char))) - (cond ((or (= ?q char) - (= ?\e char)) - (setq next (function (lambda () nil)))) - ((or (= ?y char) - (= ?Y char) - (= ? char)) - ;; Act on the object. - (let ((help-form old-help-form)) - (funcall actor elt)) - (setq actions (1+ actions))) - ((or (= ?n char) - (= ?N char) - (= ?\^? char)) - ;; Skip the object. - ) - ((= ?. char) - ;; Act on the object and then exit. + (if (listp last-nonmenu-event) + ;; Make a list describing a dialog box. + (let ((object (capitalize (nth 0 help))) + (objects (capitalize (nth 1 help))) + (action (capitalize (nth 2 help)))) + (setq map (` (("Yes" . act) ("No" . skip) ("Quit" . exit) + ((, (if help (concat action " " object " And Quit") + "Do it and Quit")) . act-and-exit) + ((, (if help (concat action " All " objects) + "Do All")) . automatic) + (,@ (mapcar (lambda (elt) + (cons (capitalize (nth 2 elt)) + (vector (nth 1 elt)))) + action-alist)))) + use-menus t + mouse-event last-nonmenu-event)) + (setq user-keys (if action-alist + (concat (mapconcat (function + (lambda (elt) + (key-description + (char-to-string (car elt))))) + action-alist ", ") + " ") + "") + ;; Make a map that defines each user key as a vector containing + ;; its definition. + map (cons 'keymap + (append (mapcar (lambda (elt) + (cons (car elt) (vector (nth 1 elt)))) + action-alist) + query-replace-map)))) + (unwind-protect + (progn + (if (stringp prompter) + (setq prompter (` (lambda (object) + (format (, prompter) object))))) + (while (funcall next) + (setq prompt (funcall prompter elt)) + (cond ((stringp prompt) + ;; Prompt the user about this object. + (setq quit-flag nil) + (if use-menus + (setq def (or (x-popup-dialog (or mouse-event use-menus) + (cons prompt map)) + 'quit)) + ;; Prompt in the echo area. + (let ((cursor-in-echo-area (not no-cursor-in-echo-area)) + (message-log-max nil)) + (message "%s(y, n, !, ., q, %sor %s) " + prompt user-keys + (key-description (vector help-char))) + (if minibuffer-auto-raise + (raise-frame (window-frame (minibuffer-window)))) + (setq char (read-event)) + ;; Show the answer to the question. + (message "%s(y, n, !, ., q, %sor %s) %s" + prompt user-keys + (key-description (vector help-char)) + (single-key-description char))) + (setq def (lookup-key map (vector char)))) + (cond ((eq def 'exit) + (setq next (function (lambda () nil)))) + ((eq def 'act) + ;; Act on the object. + (funcall actor elt) + (setq actions (1+ actions))) + ((eq def 'skip) + ;; Skip the object. + ) + ((eq def 'act-and-exit) + ;; Act on the object and then exit. + (funcall actor elt) + (setq actions (1+ actions) + next (function (lambda () nil)))) + ((or (eq def 'quit) (eq def 'exit-prefix)) + (setq quit-flag t) + (setq next (` (lambda () + (setq next '(, next)) + '(, elt))))) + ((eq def 'automatic) + ;; Act on this and all following objects. + (if (funcall prompter elt) + (progn + (funcall actor elt) + (setq actions (1+ actions)))) + (while (funcall next) + (if (funcall prompter elt) + (progn + (funcall actor elt) + (setq actions (1+ actions)))))) + ((eq def 'help) + (with-output-to-temp-buffer "*Help*" + (princ + (let ((object (if help (nth 0 help) "object")) + (objects (if help (nth 1 help) "objects")) + (action (if help (nth 2 help) "act on"))) + (concat + (format "Type SPC or `y' to %s the current %s; +DEL or `n' to skip the current %s; +! to %s all remaining %s; +ESC or `q' to exit;\n" + action object object action objects) + (mapconcat (function + (lambda (elt) + (format "%c to %s" + (nth 0 elt) + (nth 2 elt)))) + action-alist + ";\n") + (if action-alist ";\n") + (format "or . (period) to %s \ +the current %s and exit." + action object)))) + (save-excursion + (set-buffer standard-output) + (help-mode))) + + (setq next (` (lambda () + (setq next '(, next)) + '(, elt))))) + ((vectorp def) + ;; A user-defined key. + (if (funcall (aref def 0) elt) ;Call its function. + ;; The function has eaten this object. + (setq actions (1+ actions)) + ;; Regurgitated; try again. + (setq next (` (lambda () + (setq next '(, next)) + '(, elt)))))) + ((and (consp char) + (eq (car char) 'switch-frame)) + ;; switch-frame event. Put it off until we're done. + (setq delayed-switch-frame char) + (setq next (` (lambda () + (setq next '(, next)) + '(, elt))))) + (t + ;; Random char. + (message "Type %s for help." + (key-description (vector help-char))) + (beep) + (sit-for 1) + (setq next (` (lambda () + (setq next '(, next)) + '(, elt))))))) + (prompt (funcall actor elt) - (setq actions (1+ actions) - next (function (lambda () nil)))) - ((= ?! char) - ;; Act on this and all following objects. - (if (eval (funcall prompter elt)) - (progn - (funcall actor elt) - (setq actions (1+ actions)))) - (while (funcall next) - (if (eval (funcall prompter elt)) - (progn - (funcall actor elt) - (setq actions (1+ actions)))))) - ((= ?? char) - (setq unread-command-char help-char) - (setq next (` (lambda () - (setq next '(, next)) - '(, elt))))) - (t - ;; Random char. - (message "Type %s for help." - (key-description (char-to-string help-char))) - (beep) - (sit-for 1) - (setq next (` (lambda () - (setq next '(, next)) - '(, elt))))))) - (if (eval prompt) - (progn - (funcall actor elt) - (setq actions (1+ actions)))))) + (setq actions (1+ actions)))))) + (if delayed-switch-frame + (setq unread-command-events + (cons delayed-switch-frame unread-command-events)))) ;; Clear the last prompt from the minibuffer. - (message "") + (let ((message-log-max nil)) + (message "")) ;; Return the number of actions that were taken. actions))