]> code.delx.au - gnu-emacs/blobdiff - lisp/subr.el
(gdb-flush-pending-output): New variable.
[gnu-emacs] / lisp / subr.el
index 3c4f870918e1f1645e0e6ab5f97db88dffb90acf..b40c64c63eb506432a36f9cabe5005059726df4c 100644 (file)
@@ -367,15 +367,6 @@ but optional second arg NODIGITS non-nil treats them like other chars."
          (define-key map (char-to-string loop) 'digit-argument)
          (setq loop (1+ loop))))))
 
-;Moved to keymap.c
-;(defun copy-keymap (keymap)
-;  "Return a copy of KEYMAP"
-;  (while (not (keymapp keymap))
-;    (setq keymap (signal 'wrong-type-argument (list 'keymapp keymap))))
-;  (if (vectorp keymap)
-;      (copy-sequence keymap)
-;      (copy-alist keymap)))
-
 (defvar key-substitution-in-progress nil
  "Used internally by substitute-key-definition.")
 
@@ -396,126 +387,54 @@ For most uses, it is simpler and safer to use command remappping like this:
   ;; original key, with PREFIX added at the front.
   (or prefix (setq prefix ""))
   (let* ((scan (or oldmap keymap))
-        (vec1 (vector nil))
-        (prefix1 (vconcat prefix vec1))
+        (prefix1 (vconcat prefix [nil]))
         (key-substitution-in-progress
          (cons scan key-substitution-in-progress)))
     ;; Scan OLDMAP, finding each char or event-symbol that
     ;; has any definition, and act on it with hack-key.
-    (while (consp scan)
-      (if (consp (car scan))
-         (let ((char (car (car scan)))
-               (defn (cdr (car scan))))
-           ;; The inside of this let duplicates exactly
-           ;; the inside of the following let that handles array elements.
-           (aset vec1 0 char)
-           (aset prefix1 (length prefix) char)
-           (let (inner-def skipped)
-             ;; Skip past menu-prompt.
-             (while (stringp (car-safe defn))
-               (setq skipped (cons (car defn) skipped))
-               (setq defn (cdr defn)))
-             ;; Skip past cached key-equivalence data for menu items.
-             (and (consp defn) (consp (car defn))
-                  (setq defn (cdr defn)))
-             (setq inner-def defn)
-             ;; Look past a symbol that names a keymap.
-             (while (and (symbolp inner-def)
-                         (fboundp inner-def))
-               (setq inner-def (symbol-function inner-def)))
-             (if (or (eq defn olddef)
-                     ;; Compare with equal if definition is a key sequence.
-                     ;; That is useful for operating on function-key-map.
-                     (and (or (stringp defn) (vectorp defn))
-                          (equal defn olddef)))
-                 (define-key keymap prefix1 (nconc (nreverse skipped) newdef))
-               (if (and (keymapp defn)
-                        ;; Avoid recursively scanning
-                        ;; where KEYMAP does not have a submap.
-                        (let ((elt (lookup-key keymap prefix1)))
-                          (or (null elt)
-                              (keymapp elt)))
-                        ;; Avoid recursively rescanning keymap being scanned.
-                        (not (memq inner-def
-                                   key-substitution-in-progress)))
-                   ;; If this one isn't being scanned already,
-                   ;; scan it now.
-                   (substitute-key-definition olddef newdef keymap
-                                              inner-def
-                                              prefix1)))))
-       (if (vectorp (car scan))
-           (let* ((array (car scan))
-                  (len (length array))
-                  (i 0))
-             (while (< i len)
-               (let ((char i) (defn (aref array i)))
-                 ;; The inside of this let duplicates exactly
-                 ;; the inside of the previous let.
-                 (aset vec1 0 char)
-                 (aset prefix1 (length prefix) char)
-                 (let (inner-def skipped)
-                   ;; Skip past menu-prompt.
-                   (while (stringp (car-safe defn))
-                     (setq skipped (cons (car defn) skipped))
-                     (setq defn (cdr defn)))
-                   (and (consp defn) (consp (car defn))
-                        (setq defn (cdr defn)))
-                   (setq inner-def defn)
-                   (while (and (symbolp inner-def)
-                               (fboundp inner-def))
-                     (setq inner-def (symbol-function inner-def)))
-                   (if (or (eq defn olddef)
-                           (and (or (stringp defn) (vectorp defn))
-                                (equal defn olddef)))
-                       (define-key keymap prefix1
-                         (nconc (nreverse skipped) newdef))
-                     (if (and (keymapp defn)
-                              (let ((elt (lookup-key keymap prefix1)))
-                                (or (null elt)
-                                    (keymapp elt)))
-                              (not (memq inner-def
-                                         key-substitution-in-progress)))
-                         (substitute-key-definition olddef newdef keymap
-                                                    inner-def
-                                                    prefix1)))))
-               (setq i (1+ i))))
-         (if (char-table-p (car scan))
-             (map-char-table
-              (function (lambda (char defn)
-                          (let ()
-                            ;; The inside of this let duplicates exactly
-                            ;; the inside of the previous let,
-                            ;; except that it uses set-char-table-range
-                            ;; instead of define-key.
-                            (aset vec1 0 char)
-                            (aset prefix1 (length prefix) char)
-                            (let (inner-def skipped)
-                              ;; Skip past menu-prompt.
-                              (while (stringp (car-safe defn))
-                                (setq skipped (cons (car defn) skipped))
-                                (setq defn (cdr defn)))
-                              (and (consp defn) (consp (car defn))
-                                   (setq defn (cdr defn)))
-                              (setq inner-def defn)
-                              (while (and (symbolp inner-def)
-                                          (fboundp inner-def))
-                                (setq inner-def (symbol-function inner-def)))
-                              (if (or (eq defn olddef)
-                                      (and (or (stringp defn) (vectorp defn))
-                                           (equal defn olddef)))
-                                  (define-key keymap prefix1
-                                    (nconc (nreverse skipped) newdef))
-                                (if (and (keymapp defn)
-                                         (let ((elt (lookup-key keymap prefix1)))
-                                           (or (null elt)
-                                               (keymapp elt)))
-                                         (not (memq inner-def
-                                                    key-substitution-in-progress)))
-                                    (substitute-key-definition olddef newdef keymap
-                                                               inner-def
-                                                               prefix1)))))))
-              (car scan)))))
-      (setq scan (cdr scan)))))
+    (map-keymap
+     (lambda (char defn)
+       (aset prefix1 (length prefix) char)
+       (substitute-key-definition-key defn olddef newdef prefix1 keymap))
+     scan)))
+
+(defun substitute-key-definition-key (defn olddef newdef prefix keymap)
+  (let (inner-def skipped menu-item)
+    ;; Find the actual command name within the binding.
+    (if (eq (car-safe defn) 'menu-item)
+       (setq menu-item defn defn (nth 2 defn))
+      ;; Skip past menu-prompt.
+      (while (stringp (car-safe defn))
+       (push (pop defn) skipped))
+      ;; Skip past cached key-equivalence data for menu items.
+      (if (consp (car-safe defn))
+         (setq defn (cdr defn))))
+    (if (or (eq defn olddef)
+           ;; Compare with equal if definition is a key sequence.
+           ;; That is useful for operating on function-key-map.
+           (and (or (stringp defn) (vectorp defn))
+                (equal defn olddef)))
+       (define-key keymap prefix
+         (if menu-item
+             (let ((copy (copy-sequence menu-item)))
+               (setcar (nthcdr 2 copy) newdef)
+               copy)
+           (nconc (nreverse skipped) newdef)))
+      ;; Look past a symbol that names a keymap.
+      (setq inner-def
+           (condition-case nil (indirect-function defn) (error defn)))
+      ;; For nested keymaps, we use `inner-def' rather than `defn' so as to
+      ;; avoid autoloading a keymap.  This is mostly done to preserve the
+      ;; original non-autoloading behavior of pre-map-keymap times.
+      (if (and (keymapp inner-def)
+              ;; Avoid recursively scanning
+              ;; where KEYMAP does not have a submap.
+              (let ((elt (lookup-key keymap prefix)))
+                (or (null elt) (natnump elt) (keymapp elt)))
+              ;; Avoid recursively rescanning keymap being scanned.
+              (not (memq inner-def key-substitution-in-progress)))
+         ;; If this one isn't being scanned already, scan it now.
+         (substitute-key-definition olddef newdef keymap inner-def prefix)))))
 
 (defun define-key-after (keymap key definition &optional after)
   "Add binding in KEYMAP for KEY => DEFINITION, right after AFTER's binding.
@@ -565,6 +484,24 @@ The order of bindings in a keymap matters when it is used as a menu."
            (setq inserted t)))
       (setq tail (cdr tail)))))
 
+(defun map-keymap-internal (function keymap &optional sort-first)
+  "Implement `map-keymap' with sorting.
+Don't call this function; it is for internal use only."
+  (if sort-first
+      (let (list)
+       (map-keymap (lambda (a b) (push (cons a b) list))
+                   keymap)
+       (setq list (sort list
+                        (lambda (a b)
+                          (setq a (car a) b (car b))
+                          (if (integerp a)
+                              (if (integerp b) (< a b)
+                                t)
+                            (if (integerp b) t
+                              (string< a b))))))
+       (dolist (p list)
+         (funcall function (car p) (cdr p))))
+    (map-keymap function keymap)))
 
 (defmacro kbd (keys)
   "Convert KEYS to the internal Emacs key representation.
@@ -661,19 +598,19 @@ even when EVENT actually has modifiers."
            (char (logand type (lognot (logior ?\M-\^@ ?\C-\^@ ?\S-\^@
                                               ?\H-\^@ ?\s-\^@ ?\A-\^@)))))
        (if (not (zerop (logand type ?\M-\^@)))
-           (setq list (cons 'meta list)))
+           (push 'meta list))
        (if (or (not (zerop (logand type ?\C-\^@)))
                (< char 32))
-           (setq list (cons 'control list)))
+           (push 'control list))
        (if (or (not (zerop (logand type ?\S-\^@)))
                (/= char (downcase char)))
-           (setq list (cons 'shift list)))
+           (push 'shift list))
        (or (zerop (logand type ?\H-\^@))
-           (setq list (cons 'hyper list)))
+           (push 'hyper list))
        (or (zerop (logand type ?\s-\^@))
-           (setq list (cons 'super list)))
+           (push 'super list))
        (or (zerop (logand type ?\A-\^@))
-           (setq list (cons 'alt list)))
+           (push 'alt list))
        list))))
 
 (defun event-basic-type (event)
@@ -691,8 +628,7 @@ in the current Emacs session, then this function may return nil."
 
 (defsubst mouse-movement-p (object)
   "Return non-nil if OBJECT is a mouse movement event."
-  (and (consp object)
-       (eq (car object) 'mouse-movement)))
+  (eq (car-safe object) 'mouse-movement))
 
 (defsubst event-start (event)
   "Return the starting position of EVENT.
@@ -899,6 +835,10 @@ is converted into a string by expressing it in decimal."
 (make-obsolete-variable 'post-command-idle-delay
   "use timers instead, with `run-with-idle-timer'." "before 19.34")
 
+(defvaralias 'x-lost-selection-hooks 'x-lost-selection-functions)
+(make-obsolete-variable 'x-lost-selection-hooks 'x-lost-selection-functions "21.4")
+(defvaralias 'x-sent-selection-hooks 'x-sent-selection-functions)
+(make-obsolete-variable 'x-sent-selection-hooks 'x-sent-selection-functions "21.4")
 \f
 ;;;; Alternate names for functions - these are not being phased out.
 
@@ -1294,51 +1234,59 @@ any other non-digit terminates the character code and is then used as input."))
     code))
 
 (defun read-passwd (prompt &optional confirm default)
-  "Read a password, prompting with PROMPT.  Echo `.' for each character typed.
-End with RET, LFD, or ESC.  DEL or C-h rubs out.  C-u kills line.
-If optional CONFIRM is non-nil, read password twice to make sure.
-Optional DEFAULT is a default password to use instead of empty input."
-  (if confirm
-      (let (success)
-       (while (not success)
-         (let ((first (read-passwd prompt nil default))
-               (second (read-passwd "Confirm password: " nil default)))
-           (if (equal first second)
-               (progn
-                 (and (arrayp second) (clear-string second))
-                 (setq success first))
-             (and (arrayp first) (clear-string first))
-             (and (arrayp second) (clear-string second))
-             (message "Password not repeated accurately; please start over")
-             (sit-for 1))))
-       success)
-    (let ((pass nil)
-         (c 0)
-         (echo-keystrokes 0)
-         (cursor-in-echo-area t))
-      (while (progn (message "%s%s"
-                            prompt
-                            (make-string (length pass) ?.))
-                   (setq c (read-char-exclusive nil t))
-                   (and (/= c ?\r) (/= c ?\n) (/= c ?\e)))
-       (clear-this-command-keys)
-       (if (= c ?\C-u)
-           (progn
-             (and (arrayp pass) (clear-string pass))
-             (setq pass ""))
-         (if (and (/= c ?\b) (/= c ?\177))
-             (let* ((new-char (char-to-string c))
-                    (new-pass (concat pass new-char)))
+  "Read a password, prompting with PROMPT, and return it.
+If optional CONFIRM is non-nil, read the password twice to make sure.
+Optional DEFAULT is a default password to use instead of empty input.
+
+This function echoes `.' for each character that the user types.
+The user ends with RET, LFD, or ESC.  DEL or C-h rubs out.  C-u kills line.
+C-g quits; if `inhibit-quit' was non-nil around this function,
+then it returns nil if the user types C-g.
+
+Once the caller uses the password, it can erase the password
+by doing (clear-string STRING)."
+  (with-local-quit
+    (if confirm
+       (let (success)
+         (while (not success)
+           (let ((first (read-passwd prompt nil default))
+                 (second (read-passwd "Confirm password: " nil default)))
+             (if (equal first second)
+                 (progn
+                   (and (arrayp second) (clear-string second))
+                   (setq success first))
+               (and (arrayp first) (clear-string first))
+               (and (arrayp second) (clear-string second))
+               (message "Password not repeated accurately; please start over")
+               (sit-for 1))))
+         success)
+      (let ((pass nil)
+           (c 0)
+           (echo-keystrokes 0)
+           (cursor-in-echo-area t))
+       (while (progn (message "%s%s"
+                              prompt
+                              (make-string (length pass) ?.))
+                     (setq c (read-char-exclusive nil t))
+                     (and (/= c ?\r) (/= c ?\n) (/= c ?\e)))
+         (clear-this-command-keys)
+         (if (= c ?\C-u)
+             (progn
                (and (arrayp pass) (clear-string pass))
-               (clear-string new-char)
-               (setq c ?\0)
-               (setq pass new-pass))
-           (if (> (length pass) 0)
-               (let ((new-pass (substring pass 0 -1)))
+               (setq pass ""))
+           (if (and (/= c ?\b) (/= c ?\177))
+               (let* ((new-char (char-to-string c))
+                      (new-pass (concat pass new-char)))
                  (and (arrayp pass) (clear-string pass))
-                 (setq pass new-pass))))))
-      (message nil)
-      (or pass default ""))))
+                 (clear-string new-char)
+                 (setq c ?\0)
+                 (setq pass new-pass))
+             (if (> (length pass) 0)
+                 (let ((new-pass (substring pass 0 -1)))
+                   (and (arrayp pass) (clear-string pass))
+                   (setq pass new-pass))))))
+       (message nil)
+       (or pass default "")))))
 
 ;; This should be used by `call-interactively' for `n' specs.
 (defun read-number (prompt &optional default)
@@ -1883,8 +1831,7 @@ Use a MESSAGE of \"\" to temporarily clear the echo area."
 See also `with-temp-file' and `with-output-to-string'."
   (declare (indent 0) (debug t))
   (let ((temp-buffer (make-symbol "temp-buffer")))
-    `(let ((,temp-buffer
-           (get-buffer-create (generate-new-buffer-name " *temp*"))))
+    `(let ((,temp-buffer (generate-new-buffer " *temp*")))
        (unwind-protect
           (with-current-buffer ,temp-buffer
             ,@body)
@@ -1905,14 +1852,14 @@ See also `with-temp-file' and `with-output-to-string'."
 
 (defmacro with-local-quit (&rest body)
   "Execute BODY, allowing quits to terminate BODY but not escape further.
-When a quit terminates BODY, `with-local-quit' requests another quit when
-it finishes.  That quit will be processed in turn, the next time quitting
-is again allowed."
+When a quit terminates BODY, `with-local-quit' returns nil but
+requests another quit.  That quit will be processed, the next time quitting
+is allowed once again."
   (declare (debug t) (indent 0))
   `(condition-case nil
        (let ((inhibit-quit nil))
         ,@body)
-     (quit (setq quit-flag t))))
+     (quit (setq quit-flag t) nil)))
 
 (defmacro combine-after-change-calls (&rest body)
   "Execute BODY, but don't call the after-change functions till the end.
@@ -2106,11 +2053,12 @@ STRING should be given if the last search was by `string-match' on STRING."
 
 (defun looking-back (regexp &optional limit)
   "Return non-nil if text before point matches regular expression REGEXP.
-Like `looking-at' except backwards and slower.
+Like `looking-at' except matches before point, and is slower.
 LIMIT if non-nil speeds up the search by specifying how far back the
 match can start."
-  (save-excursion
-    (re-search-backward (concat "\\(?:" regexp "\\)\\=") limit t)))
+  (not (null
+       (save-excursion
+         (re-search-backward (concat "\\(?:" regexp "\\)\\=") limit t)))))
 
 (defconst split-string-default-separators "[ \f\t\n\r\v]+"
   "The default value of separators for `split-string'.
@@ -2279,7 +2227,7 @@ from `standard-syntax-table' otherwise."
     table))
 
 (defun syntax-after (pos)
-  "Return the syntax of the char after POS."
+  "Return the raw syntax of the char after POS."
   (unless (or (< pos (point-min)) (>= pos (point-max)))
     (let ((st (if parse-sexp-lookup-properties
                  (get-char-property pos 'syntax-table))))