(rmail-reply): Don't forget to narrow header in
[bpt/emacs.git] / lisp / register.el
index 76f0528..940ae58 100644 (file)
@@ -1,6 +1,6 @@
 ;;; register.el --- register commands for Emacs.
 
-;; Copyright (C) 1985, 1993 Free Software Foundation, Inc.
+;; Copyright (C) 1985, 1993, 1994 Free Software Foundation, Inc.
 
 ;; Maintainer: FSF
 ;; Keywords: internal
@@ -18,8 +18,9 @@
 ;; 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, 675 Mass Ave, Cambridge, MA 02139, USA.
+;; 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:
 
 
 (defvar register-alist nil
   "Alist of elements (NAME . CONTENTS), one for each Emacs register.
-NAME is a character (a number).  CONTENTS is a string, number,
-frame configuration, mark or list.
+NAME is a character (a number).  CONTENTS is a string, number, marker or list.
 A list of strings represents a rectangle.
-A list of the form (file . NAME) represents the file named NAME.")
-
-(defun get-register (char)
-  "Return contents of Emacs register named CHAR, or nil if none."
-  (cdr (assq char register-alist)))
-
-(defun set-register (char value)
-  "Set contents of Emacs register named CHAR to VALUE.  Returns VALUE.
+A list of the form (file . NAME) represents the file named NAME.
+A list of the form (file-query NAME POSITION) represents position POSITION
+ in the file named NAME, but query before visiting it.
+A list of the form (WINDOW-CONFIGURATION POSITION)
+ represents a saved window configuration plus a saved value of point.
+A list of the form (FRAME-CONFIGURATION POSITION)
+ represents a saved frame configuration plus a saved value of point.")
+
+(defun get-register (reg)
+  "Return contents of Emacs register named REG, or nil if none."
+  (cdr (assq reg register-alist)))
+
+(defun set-register (register value)
+  "Set contents of Emacs register named REGISTER to VALUE.  Returns VALUE.
 See the documentation of the variable `register-alist' for possible VALUE."
-  (let ((aelt (assq char register-alist)))
+  (let ((aelt (assq register register-alist)))
     (if aelt
        (setcdr aelt value)
-      (setq aelt (cons char value))
+      (setq aelt (cons register value))
       (setq register-alist (cons aelt register-alist)))
     value))
 
-(defun point-to-register (char &optional arg)
+(defun point-to-register (register &optional arg)
   "Store current location of point in register REGISTER.
 With prefix argument, store current frame configuration.
 Use \\[jump-to-register] to go to that location or restore that configuration.
 Argument is a character, naming the register."
   (interactive "cPoint to register: \nP")
-  (set-register char (if arg (current-frame-configuration) (point-marker))))
+  (set-register register
+               (if arg (list (current-frame-configuration) (point-marker))
+                 (point-marker))))
 
-(defun window-configuration-to-register (char &optional arg)
+(defun window-configuration-to-register (register &optional arg)
   "Store the window configuration of the selected frame in register REGISTER.
 Use \\[jump-to-register] to restore the configuration.
 Argument is a character, naming the register."
   (interactive "cWindow configuration to register: \nP")
-  (set-register char (current-window-configuration)))
+  ;; current-window-configuration does not include the value
+  ;; of point in the current buffer, so record that separately.
+  (set-register register (list (current-window-configuration) (point-marker))))
 
-(defun frame-configuration-to-register (char &optional arg)
+(defun frame-configuration-to-register (register &optional arg)
   "Store the window configuration of all frames in register REGISTER.
 Use \\[jump-to-register] to restore the configuration.
 Argument is a character, naming the register."
   (interactive "cFrame configuration to register: \nP")
-  (set-register char (current-frame-configuration)))
+  ;; current-frame-configuration does not include the value
+  ;; of point in the current buffer, so record that separately.
+  (set-register register (list (current-frame-configuration) (point-marker))))
 
 (defalias 'register-to-point 'jump-to-register)
-(defun jump-to-register (char &optional delete)
+(defun jump-to-register (register &optional delete)
   "Move point to location stored in a register.
 If the register contains a file name, find that file.
  \(To put a file name in a register, you must use `set-register'.)
@@ -85,62 +97,82 @@ Optional second arg non-nil (interactively, prefix argument) says to
 delete any existing frames that the frame configuration doesn't mention.
 \(Otherwise, these frames are iconified.)"
   (interactive "cJump to register: \nP")
-  (let ((val (get-register char)))
+  (let ((val (get-register register)))
     (cond
-     ((and (fboundp 'frame-configuration-p)
-          (frame-configuration-p val))
-      (set-frame-configuration val (not delete)))
-     ((window-configuration-p val)
-      (set-window-configuration val))
+     ((and (consp val) (frame-configuration-p (car val)))
+      (set-frame-configuration (car val) (not delete))
+      (goto-char (cadr val)))
+     ((and (consp val) (window-configuration-p (car val)))
+      (set-window-configuration (car val))
+      (goto-char (cadr val)))
      ((markerp val)
+      (or (marker-buffer val)
+         (error "That register's buffer no longer exists"))
       (switch-to-buffer (marker-buffer val))
       (goto-char val))
      ((and (consp val) (eq (car val) 'file))
       (find-file (cdr val)))
+     ((and (consp val) (eq (car val) 'file-query))
+      (or (find-buffer-visiting (nth 1 val))
+         (y-or-n-p (format "Visit file %s again? " (nth 1 val)))
+         (error "Register access aborted"))
+      (find-file (nth 1 val))
+      (goto-char (nth 2 val)))
      (t
       (error "Register doesn't contain a buffer position or configuration")))))
 
-;(defun number-to-register (arg char)
-;  "Store a number in a register.
-;Two args, NUMBER and REGISTER (a character, naming the register).
-;If NUMBER is nil, digits in the buffer following point are read
-;to get the number to store.
-;Interactively, NUMBER is the prefix arg (none means nil)."
-;  (interactive "P\ncNumber to register: ")
-;  (set-register char 
-;              (if arg
-;                  (prefix-numeric-value arg)
-;                (if (looking-at "[0-9][0-9]*")
-;                    (save-excursion
-;                     (save-restriction
-;                      (narrow-to-region (point)
-;                                        (progn (skip-chars-forward "0-9")
-;                                               (point)))
-;                      (goto-char (point-min))
-;                      (read (current-buffer))))
-;                  0))))
-
-;(defun increment-register (arg char)
-;  "Add NUMBER to the contents of register REGISTER.
-;Interactively, NUMBER is the prefix arg (none means nil)." 
-;  (interactive "p\ncNumber to register: ")
-;  (or (integerp (get-register char))
-;      (error "Register does not contain a number"))
-;  (set-register char (+ arg (get-register char))))
-
-(defun view-register (char)
+;; Turn markers into file-query references when a buffer is killed.
+(defun register-swap-out ()
+  (and buffer-file-name
+       (let ((tail register-alist))
+        (while tail
+          (and (markerp (cdr (car tail)))
+               (eq (marker-buffer (cdr (car tail))) (current-buffer))
+               (setcdr (car tail)
+                       (list 'file-query
+                             buffer-file-name
+                             (marker-position (cdr (car tail))))))
+          (setq tail (cdr tail))))))
+
+(add-hook 'kill-buffer-hook 'register-swap-out)
+
+(defun number-to-register (number register)
+  "Store a number in a register.
+Two args, NUMBER and REGISTER (a character, naming the register).
+If NUMBER is nil, a decimal number is read from the buffer starting
+at point, and point moves to the end of that number.
+Interactively, NUMBER is the prefix arg (none means nil)."
+  (interactive "P\ncNumber to register: ")
+  (set-register register 
+               (if number
+                   (prefix-numeric-value number)
+                 (if (looking-at "\\s-*-?[0-9]+")
+                     (progn
+                       (goto-char (match-end 0))
+                       (string-to-int (match-string 0)))
+                   0))))
+
+(defun increment-register (number register)
+  "Add NUMBER to the contents of register REGISTER.
+Interactively, NUMBER is the prefix arg."
+  (interactive "p\ncIncrement register: ")
+  (or (numberp (get-register register))
+      (error "Register does not contain a number"))
+  (set-register register (+ number (get-register register))))
+
+(defun view-register (register)
   "Display what is contained in register named REGISTER.
-REGISTER is a character."
+The Lisp value REGISTER is a character."
   (interactive "cView register: ")
-  (let ((val (get-register char)))
+  (let ((val (get-register register)))
     (if (null val)
-       (message "Register %s is empty" (single-key-description char))
+       (message "Register %s is empty" (single-key-description register))
       (with-output-to-temp-buffer "*Output*"
        (princ "Register ")
-       (princ (single-key-description char))
+       (princ (single-key-description register))
        (princ " contains ")
        (cond
-        ((integerp val)
+        ((numberp val)
          (princ val))
 
         ((markerp val)
@@ -152,10 +184,10 @@ REGISTER is a character."
              (princ ", position ")
              (princ (marker-position val)))))
 
-        ((window-configuration-p val)
+        ((and (consp val) (window-configuration-p (car val)))
          (princ "a window configuration."))
 
-        ((frame-configuration-p val)
+        ((and (consp val) (frame-configuration-p (car val)))
          (princ "a frame configuration."))
 
         ((and (consp val) (eq (car val) 'file))
@@ -163,6 +195,13 @@ REGISTER is a character."
          (prin1 (cdr val))
          (princ "."))
 
+        ((and (consp val) (eq (car val) 'file-query))
+         (princ "a file-query reference:\nfile ")
+         (prin1 (car (cdr val)))
+         (princ ",\nposition ")
+         (princ (car (cdr (cdr val))))
+         (princ "."))
+
         ((consp val)
          (princ "the rectangle:\n")
          (while val
@@ -178,20 +217,20 @@ REGISTER is a character."
          (princ "Garbage:\n")
          (prin1 val)))))))
 
-(defun insert-register (char &optional arg)
-  "Insert contents of register REG.  REG is a character.
+(defun insert-register (register &optional arg)
+  "Insert contents of register REGISTER.  (REGISTER is a character.)
 Normally puts point before and mark after the inserted text.
 If optional second arg is non-nil, puts mark before and point after.
 Interactively, second arg is non-nil if prefix arg is supplied."
-  (interactive "cInsert register: \nP")
+  (interactive "*cInsert register: \nP")
   (push-mark)
-  (let ((val (get-register char)))
+  (let ((val (get-register register)))
     (cond
      ((consp val)
       (insert-rectangle val))
      ((stringp val)
       (insert val))
-     ((integerp val)
+     ((numberp val)
       (princ val (current-buffer)))
      ((and (markerp val) (marker-position val))
       (princ (marker-position val) (current-buffer)))
@@ -199,42 +238,45 @@ Interactively, second arg is non-nil if prefix arg is supplied."
       (error "Register does not contain text"))))
   (if (not arg) (exchange-point-and-mark)))
 
-(defun copy-to-register (char start end &optional delete-flag)
-  "Copy region into register REG.  With prefix arg, delete as well.
-Called from program, takes four args: REG, START, END and DELETE-FLAG.
+(defun copy-to-register (register start end &optional delete-flag)
+  "Copy region into register REGISTER.  With prefix arg, delete as well.
+Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
 START and END are buffer positions indicating what to copy."
   (interactive "cCopy to register: \nr\nP")
-  (set-register char (buffer-substring start end))
+  (set-register register (buffer-substring start end))
   (if delete-flag (delete-region start end)))
 
-(defun append-to-register (char start end &optional delete-flag)
-  "Append region to text in register REG.  With prefix arg, delete as well.
-Called from program, takes four args: REG, START, END and DELETE-FLAG.
+(defun append-to-register (register start end &optional delete-flag)
+  "Append region to text in register REGISTER.
+With prefix arg, delete as well.
+Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
 START and END are buffer positions indicating what to append."
   (interactive "cAppend to register: \nr\nP")
-  (or (stringp (get-register char))
+  (or (stringp (get-register register))
       (error "Register does not contain text"))
-  (set-register char (concat (get-register char)
-                            (buffer-substring start end)))
+  (set-register register (concat (get-register register)
+                           (buffer-substring start end)))
   (if delete-flag (delete-region start end)))
 
-(defun prepend-to-register (char start end &optional delete-flag)
-  "Prepend region to text in register REG.  With prefix arg, delete as well.
-Called from program, takes four args: REG, START, END and DELETE-FLAG.
+(defun prepend-to-register (register start end &optional delete-flag)
+  "Prepend region to text in register REGISTER.
+With prefix arg, delete as well.
+Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
 START and END are buffer positions indicating what to prepend."
   (interactive "cPrepend to register: \nr\nP")
-  (or (stringp (get-register char))
+  (or (stringp (get-register register))
       (error "Register does not contain text"))
-  (set-register char (concat (buffer-substring start end)
-                            (get-register char)))
+  (set-register register (concat (buffer-substring start end)
+                           (get-register register)))
   (if delete-flag (delete-region start end)))
 
-(defun copy-rectangle-to-register (char start end &optional delete-flag)
-  "Copy rectangular region into register REG.  With prefix arg, delete as well.
-Called from program, takes four args: REG, START, END and DELETE-FLAG.
+(defun copy-rectangle-to-register (register start end &optional delete-flag)
+  "Copy rectangular region into register REGISTER.
+With prefix arg, delete as well.
+Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
 START and END are buffer positions giving two corners of rectangle."
   (interactive "cCopy rectangle to register: \nr\nP")
-  (set-register char
+  (set-register register
                (if delete-flag
                    (delete-extract-rectangle start end)
                  (extract-rectangle start end))))