annotate lisp/register.el @ 95321:f362398714d9

(vc-cvs-status-extra-headers): Align labels.
author Dan Nicolaescu <dann@ics.uci.edu>
date Mon, 26 May 2008 23:50:21 +0000
parents ee5932bf781d
children 40356b7a4808
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38412
253f761ad37b Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents: 20675
diff changeset
1 ;;; register.el --- register commands for Emacs
658
7cbd4fcd8b0f *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 243
diff changeset
2
74442
b2e5081b9320 Update copyright years.
Glenn Morris <rgm@gnu.org>
parents: 68651
diff changeset
3 ;; Copyright (C) 1985, 1993, 1994, 2001, 2002, 2003, 2004,
79721
73661ddc7ac7 Add 2008 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 78236
diff changeset
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
845
213978acbc1e entered into RCS
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 820
diff changeset
5
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 779
diff changeset
6 ;; Maintainer: FSF
814
38b2499cb3e9 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 807
diff changeset
7 ;; Keywords: internal
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 779
diff changeset
8
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
13 ;; the Free Software Foundation, either version 3 of the License, or
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
14 ;; (at your option) any later version.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
15
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 ;; GNU General Public License for more details.
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
20
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
21 ;; You should have received a copy of the GNU General Public License
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23
2315
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
24 ;;; Commentary:
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
25
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
26 ;; This package of functions emulates and somewhat extends the venerable
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
27 ;; TECO's `register' feature, which permits you to save various useful
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
28 ;; pieces of buffer state to named variables. The entry points are
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
29 ;; documented in the Emacs user's manual.
9e7ec92a4fdf Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2203
diff changeset
30
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 779
diff changeset
31 ;;; Code:
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
33 (defvar register-alist nil
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34 "Alist of elements (NAME . CONTENTS), one for each Emacs register.
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
35 NAME is a character (a number). CONTENTS is a string, number, marker or list.
2699
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
36 A list of strings represents a rectangle.
16279
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
37 A list of the form (file . NAME) represents the file named NAME.
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
38 A list of the form (file-query NAME POSITION) represents position POSITION
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
39 in the file named NAME, but query before visiting it.
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
40 A list of the form (WINDOW-CONFIGURATION POSITION)
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
41 represents a saved window configuration plus a saved value of point.
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
42 A list of the form (FRAME-CONFIGURATION POSITION)
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
43 represents a saved frame configuration plus a saved value of point.")
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
45 (defun get-register (reg)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
46 "Return contents of Emacs register named REG, or nil if none."
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
47 (cdr (assq reg register-alist)))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
48
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
49 (defun set-register (register value)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
50 "Set contents of Emacs register named REGISTER to VALUE. Returns VALUE.
2699
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
51 See the documentation of the variable `register-alist' for possible VALUE."
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
52 (let ((aelt (assq register register-alist)))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
53 (if aelt
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
54 (setcdr aelt value)
47646
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
55 (push (cons register value) register-alist))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
56 value))
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
57
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
58 (defun point-to-register (register &optional arg)
141
405b4fa6de27 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72
diff changeset
59 "Store current location of point in register REGISTER.
779
c2dbf1fe0506 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 658
diff changeset
60 With prefix argument, store current frame configuration.
141
405b4fa6de27 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72
diff changeset
61 Use \\[jump-to-register] to go to that location or restore that configuration.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
62 Argument is a character, naming the register."
141
405b4fa6de27 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72
diff changeset
63 (interactive "cPoint to register: \nP")
47646
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
64 ;; Turn the marker into a file-ref if the buffer is killed.
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
65 (add-hook 'kill-buffer-hook 'register-swap-out nil t)
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
66 (set-register register
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
67 (if arg (list (current-frame-configuration) (point-marker))
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
68 (point-marker))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
69
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
70 (defun window-configuration-to-register (register &optional arg)
820
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
71 "Store the window configuration of the selected frame in register REGISTER.
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
72 Use \\[jump-to-register] to restore the configuration.
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
73 Argument is a character, naming the register."
4669
e212db4385f9 ({window,frame}-configuration-to-register): Fix prompt string in
Roland McGrath <roland@gnu.org>
parents: 3656
diff changeset
74 (interactive "cWindow configuration to register: \nP")
20324
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
75 ;; current-window-configuration does not include the value
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
76 ;; of point in the current buffer, so record that separately.
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
77 (set-register register (list (current-window-configuration) (point-marker))))
820
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
78
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
79 (defun frame-configuration-to-register (register &optional arg)
820
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
80 "Store the window configuration of all frames in register REGISTER.
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
81 Use \\[jump-to-register] to restore the configuration.
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
82 Argument is a character, naming the register."
4669
e212db4385f9 ({window,frame}-configuration-to-register): Fix prompt string in
Roland McGrath <roland@gnu.org>
parents: 3656
diff changeset
83 (interactive "cFrame configuration to register: \nP")
20324
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
84 ;; current-frame-configuration does not include the value
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
85 ;; of point in the current buffer, so record that separately.
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
86 (set-register register (list (current-frame-configuration) (point-marker))))
820
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
87
2571
b65cf676a09b All fsets changed to defaliases.
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 2315
diff changeset
88 (defalias 'register-to-point 'jump-to-register)
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
89 (defun jump-to-register (register &optional delete)
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
90 "Move point to location stored in a register.
2699
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
91 If the register contains a file name, find that file.
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
92 \(To put a file name in a register, you must use `set-register'.)
820
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
93 If the register contains a window configuration (one frame) or a frame
cd6b1e1da3fc *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 814
diff changeset
94 configuration (all frames), restore that frame or all frames accordingly.
4671
3c5e001c9d60 (jump-to-register): Take new optional arg NODELETE (prefix arg); pass
Roland McGrath <roland@gnu.org>
parents: 4669
diff changeset
95 First argument is a character, naming the register.
4931
ad035a2d8e26 (jump-to-register): Rename prefix arg to DELETE and invert its sense.
Richard M. Stallman <rms@gnu.org>
parents: 4671
diff changeset
96 Optional second arg non-nil (interactively, prefix argument) says to
ad035a2d8e26 (jump-to-register): Rename prefix arg to DELETE and invert its sense.
Richard M. Stallman <rms@gnu.org>
parents: 4671
diff changeset
97 delete any existing frames that the frame configuration doesn't mention.
4932
5986d619b4ca (jump-to-register): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 4931
diff changeset
98 \(Otherwise, these frames are iconified.)"
4671
3c5e001c9d60 (jump-to-register): Take new optional arg NODELETE (prefix arg); pass
Roland McGrath <roland@gnu.org>
parents: 4669
diff changeset
99 (interactive "cJump to register: \nP")
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
100 (let ((val (get-register register)))
2202
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
101 (cond
20324
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
102 ((and (consp val) (frame-configuration-p (car val)))
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
103 (set-frame-configuration (car val) (not delete))
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
104 (goto-char (cadr val)))
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
105 ((and (consp val) (window-configuration-p (car val)))
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
106 (set-window-configuration (car val))
2365fc61875d (window-configuration-to-register):
Karl Heuer <kwzh@gnu.org>
parents: 16279
diff changeset
107 (goto-char (cadr val)))
2202
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
108 ((markerp val)
6462
e58207907f53 (jump-to-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 6336
diff changeset
109 (or (marker-buffer val)
e58207907f53 (jump-to-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 6336
diff changeset
110 (error "That register's buffer no longer exists"))
2202
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
111 (switch-to-buffer (marker-buffer val))
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
112 (goto-char val))
2699
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
113 ((and (consp val) (eq (car val) 'file))
83fee0378e0e (jump-to-register): Allow file name "in" a register.
Richard M. Stallman <rms@gnu.org>
parents: 2571
diff changeset
114 (find-file (cdr val)))
16279
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
115 ((and (consp val) (eq (car val) 'file-query))
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
116 (or (find-buffer-visiting (nth 1 val))
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
117 (y-or-n-p (format "Visit file %s again? " (nth 1 val)))
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
118 (error "Register access aborted"))
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
119 (find-file (nth 1 val))
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
120 (goto-char (nth 2 val)))
2202
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
121 (t
081afcef5e85 Make frame configurations start with a distinctive symbol.
Jim Blandy <jimb@redhat.com>
parents: 1955
diff changeset
122 (error "Register doesn't contain a buffer position or configuration")))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123
16279
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
124 (defun register-swap-out ()
47646
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
125 "Turn markers into file-query references when a buffer is killed."
16279
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
126 (and buffer-file-name
47646
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
127 (dolist (elem register-alist)
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
128 (and (markerp (cdr elem))
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
129 (eq (marker-buffer (cdr elem)) (current-buffer))
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
130 (setcdr elem
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
131 (list 'file-query
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
132 buffer-file-name
0e418919d79e (set-register): Use push.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 44677
diff changeset
133 (marker-position (cdr elem))))))))
16279
e69577ede89e New kind of register value is a file name and position.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
134
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
135 (defun number-to-register (number register)
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
136 "Store a number in a register.
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
137 Two args, NUMBER and REGISTER (a character, naming the register).
20430
1b4c829e2f42 (number-to-register): Move point as a side effect.
Karl Heuer <kwzh@gnu.org>
parents: 20417
diff changeset
138 If NUMBER is nil, a decimal number is read from the buffer starting
1b4c829e2f42 (number-to-register): Move point as a side effect.
Karl Heuer <kwzh@gnu.org>
parents: 20417
diff changeset
139 at point, and point moves to the end of that number.
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
140 Interactively, NUMBER is the prefix arg (none means nil)."
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
141 (interactive "P\ncNumber to register: ")
48451
c623c9adbefe (describe-register-1): Don't assign to val the value returned by
Juanma Barranquero <lekktu@gmail.com>
parents: 47646
diff changeset
142 (set-register register
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
143 (if number
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
144 (prefix-numeric-value number)
20430
1b4c829e2f42 (number-to-register): Move point as a side effect.
Karl Heuer <kwzh@gnu.org>
parents: 20417
diff changeset
145 (if (looking-at "\\s-*-?[0-9]+")
1b4c829e2f42 (number-to-register): Move point as a side effect.
Karl Heuer <kwzh@gnu.org>
parents: 20417
diff changeset
146 (progn
1b4c829e2f42 (number-to-register): Move point as a side effect.
Karl Heuer <kwzh@gnu.org>
parents: 20417
diff changeset
147 (goto-char (match-end 0))
51057
afc4352d55f3 (number-to-register): Use `string-to-number' instead
John Paul Wallington <jpw@pobox.com>
parents: 49597
diff changeset
148 (string-to-number (match-string 0)))
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
149 0))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
150
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
151 (defun increment-register (number register)
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
152 "Add NUMBER to the contents of register REGISTER.
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
153 Interactively, NUMBER is the prefix arg."
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
154 (interactive "p\ncIncrement register: ")
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
155 (or (numberp (get-register register))
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
156 (error "Register does not contain a number"))
20675
483ae4df691a (number-to-register, increment-register): Args
Karl Heuer <kwzh@gnu.org>
parents: 20511
diff changeset
157 (set-register register (+ number (get-register register))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
158
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
159 (defun view-register (register)
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
160 "Display what is contained in register named REGISTER.
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
161 The Lisp value REGISTER is a character."
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
162 (interactive "cView register: ")
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
163 (let ((val (get-register register)))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
164 (if (null val)
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
165 (message "Register %s is empty" (single-key-description register))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
166 (with-output-to-temp-buffer "*Output*"
43170
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
167 (describe-register-1 register t)))))
2203
12e9bc8a4a7f * register.el (view-register): Neglect not to avoid failing to
Jim Blandy <jimb@redhat.com>
parents: 2202
diff changeset
168
43170
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
169 (defun list-registers ()
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
170 "Display a list of nonempty registers saying briefly what they contain."
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
171 (interactive)
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
172 (let ((list (copy-sequence register-alist)))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
173 (setq list (sort list (lambda (a b) (< (car a) (car b)))))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
174 (with-output-to-temp-buffer "*Output*"
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
175 (dolist (elt list)
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
176 (when (get-register (car elt))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
177 (describe-register-1 (car elt))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
178 (terpri))))))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
179
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
180 (defun describe-register-1 (register &optional verbose)
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
181 (princ "Register ")
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
182 (princ (single-key-description register))
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
183 (princ " contains ")
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
184 (let ((val (get-register register)))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
185 (cond
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
186 ((numberp val)
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
187 (princ val))
2203
12e9bc8a4a7f * register.el (view-register): Neglect not to avoid failing to
Jim Blandy <jimb@redhat.com>
parents: 2202
diff changeset
188
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
189 ((markerp val)
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
190 (let ((buf (marker-buffer val)))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
191 (if (null buf)
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
192 (princ "a marker in no buffer")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
193 (princ "a buffer position:\n buffer ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
194 (princ (buffer-name buf))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
195 (princ ", position ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
196 (princ (marker-position val)))))
2203
12e9bc8a4a7f * register.el (view-register): Neglect not to avoid failing to
Jim Blandy <jimb@redhat.com>
parents: 2202
diff changeset
197
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
198 ((and (consp val) (window-configuration-p (car val)))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
199 (princ "a window configuration."))
43170
a2f11ee215ea (list-registers): New command.
Richard M. Stallman <rms@gnu.org>
parents: 38412
diff changeset
200
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
201 ((and (consp val) (frame-configuration-p (car val)))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
202 (princ "a frame configuration."))
2203
12e9bc8a4a7f * register.el (view-register): Neglect not to avoid failing to
Jim Blandy <jimb@redhat.com>
parents: 2202
diff changeset
203
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
204 ((and (consp val) (eq (car val) 'file))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
205 (princ "the file ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
206 (prin1 (cdr val))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
207 (princ "."))
3656
c57aec7e822b (view-register): Handle file name values.
Richard M. Stallman <rms@gnu.org>
parents: 3039
diff changeset
208
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
209 ((and (consp val) (eq (car val) 'file-query))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
210 (princ "a file-query reference:\n file ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
211 (prin1 (car (cdr val)))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
212 (princ ",\n position ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
213 (princ (car (cdr (cdr val))))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
214 (princ "."))
20511
9a051580fa02 (view-register): Show register type file-query.
Richard M. Stallman <rms@gnu.org>
parents: 20430
diff changeset
215
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
216 ((consp val)
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
217 (if verbose
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
218 (progn
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
219 (princ "the rectangle:\n")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
220 (while val
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
221 (princ " ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
222 (princ (car val))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
223 (terpri)
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
224 (setq val (cdr val))))
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
225 (princ "a rectangle starting with ")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
226 (princ (car val))))
2203
12e9bc8a4a7f * register.el (view-register): Neglect not to avoid failing to
Jim Blandy <jimb@redhat.com>
parents: 2202
diff changeset
227
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
228 ((stringp val)
60281
90ca0ff28286 (describe-register-1): Explicitly handle yank-excluded-properties = t.
Richard M. Stallman <rms@gnu.org>
parents: 54406
diff changeset
229 (if (eq yank-excluded-properties t)
90ca0ff28286 (describe-register-1): Explicitly handle yank-excluded-properties = t.
Richard M. Stallman <rms@gnu.org>
parents: 54406
diff changeset
230 (set-text-properties 0 (length val) nil val)
90ca0ff28286 (describe-register-1): Explicitly handle yank-excluded-properties = t.
Richard M. Stallman <rms@gnu.org>
parents: 54406
diff changeset
231 (remove-list-of-text-properties 0 (length val)
90ca0ff28286 (describe-register-1): Explicitly handle yank-excluded-properties = t.
Richard M. Stallman <rms@gnu.org>
parents: 54406
diff changeset
232 yank-excluded-properties val))
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
233 (if verbose
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
234 (progn
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
235 (princ "the text:\n")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
236 (princ val))
49597
e88404e8f2cf Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 48715
diff changeset
237 (cond
48715
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
238 ;; Extract first N characters starting with first non-whitespace.
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
239 ((string-match (format "[^ \t\n].\\{,%d\\}"
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
240 ;; Deduct 6 for the spaces inserted below.
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
241 (min 20 (max 0 (- (window-width) 6))))
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
242 val)
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
243 (princ "text starting with\n ")
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
244 (princ (match-string 0 val)))
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
245 ((string-match "^[ \t\n]+$" val)
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
246 (princ "whitespace"))
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
247 (t
1e0c7ad65f05 (describe-register-1): Use window-width
Richard M. Stallman <rms@gnu.org>
parents: 48451
diff changeset
248 (princ "the empty string")))))
43291
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
249 (t
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
250 (princ "Garbage:\n")
d6866cd43406 (describe-register-1): Access register contents here.
Richard M. Stallman <rms@gnu.org>
parents: 43170
diff changeset
251 (if verbose (prin1 val))))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
252
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
253 (defun insert-register (register &optional arg)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
254 "Insert contents of register REGISTER. (REGISTER is a character.)
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
255 Normally puts point before and mark after the inserted text.
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
256 If optional second arg is non-nil, puts mark before and point after.
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
257 Interactively, second arg is non-nil if prefix arg is supplied."
8812
36f7b14b38e3 (insert-register): Add `*' interactive spec.
Karl Heuer <kwzh@gnu.org>
parents: 7300
diff changeset
258 (interactive "*cInsert register: \nP")
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
259 (push-mark)
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
260 (let ((val (get-register register)))
6336
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
261 (cond
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
262 ((consp val)
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
263 (insert-rectangle val))
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
264 ((stringp val)
44677
b8ccc58cc821 (insert-register): Use insert-for-yank.
Richard M. Stallman <rms@gnu.org>
parents: 43291
diff changeset
265 (insert-for-yank val))
20417
01d602ca5dcf (frame-configuration-to-register)
Karl Heuer <kwzh@gnu.org>
parents: 20324
diff changeset
266 ((numberp val)
6336
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
267 (princ val (current-buffer)))
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
268 ((and (markerp val) (marker-position val))
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
269 (princ (marker-position val) (current-buffer)))
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
270 (t
d7f922a411f9 (view-register, insert-register): Handle dead marker.
Karl Heuer <kwzh@gnu.org>
parents: 4932
diff changeset
271 (error "Register does not contain text"))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
272 (if (not arg) (exchange-point-and-mark)))
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
273
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
274 (defun copy-to-register (register start end &optional delete-flag)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
275 "Copy region into register REGISTER. With prefix arg, delete as well.
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
276 Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
277 START and END are buffer positions indicating what to copy."
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
278 (interactive "cCopy to register: \nr\nP")
61112
c0f29f51c65c (copy-to-register, append-to-register, prepend-to-register):
Richard M. Stallman <rms@gnu.org>
parents: 60281
diff changeset
279 (set-register register (filter-buffer-substring start end))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
280 (if delete-flag (delete-region start end)))
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
281
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
282 (defun append-to-register (register start end &optional delete-flag)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
283 "Append region to text in register REGISTER.
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
284 With prefix arg, delete as well.
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
285 Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
286 START and END are buffer positions indicating what to append."
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
287 (interactive "cAppend to register: \nr\nP")
85914
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
288 (let ((reg (get-register register))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
289 (text (filter-buffer-substring start end)))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
290 (set-register
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
291 register (cond ((not reg) text)
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
292 ((stringp reg) (concat reg text))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
293 (t (error "Register does not contain text")))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
294 (if delete-flag (delete-region start end)))
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
295
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
296 (defun prepend-to-register (register start end &optional delete-flag)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
297 "Prepend region to text in register REGISTER.
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
298 With prefix arg, delete as well.
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
299 Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
300 START and END are buffer positions indicating what to prepend."
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
301 (interactive "cPrepend to register: \nr\nP")
85914
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
302 (let ((reg (get-register register))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
303 (text (filter-buffer-substring start end)))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
304 (set-register
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
305 register (cond ((not reg) text)
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
306 ((stringp reg) (concat text reg))
b51c8db87a41 (append-to-register, prepend-to-register):
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 78236
diff changeset
307 (t (error "Register does not contain text")))))
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
308 (if delete-flag (delete-region start end)))
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
309
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
310 (defun copy-rectangle-to-register (register start end &optional delete-flag)
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
311 "Copy rectangular region into register REGISTER.
53410
ce3a88ca37ee (copy-rectangle-to-register): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 52401
diff changeset
312 With prefix arg, delete as well. To insert this register
ce3a88ca37ee (copy-rectangle-to-register): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 52401
diff changeset
313 in the buffer, use \\[insert-register].
ce3a88ca37ee (copy-rectangle-to-register): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 52401
diff changeset
314
ce3a88ca37ee (copy-rectangle-to-register): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 52401
diff changeset
315 Called from a program, takes four args: REGISTER, START, END and DELETE-FLAG.
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
316 START and END are buffer positions giving two corners of rectangle."
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
317 (interactive "cCopy rectangle to register: \nr\nP")
13009
a418156c25ea Rename all register-name args to `register'.
Richard M. Stallman <rms@gnu.org>
parents: 8812
diff changeset
318 (set-register register
47
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
319 (if delete-flag
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
320 (delete-extract-rectangle start end)
dfec464ac265 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
321 (extract-rectangle start end))))
658
7cbd4fcd8b0f *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 243
diff changeset
322
54406
1647b704e48e Provide `register' feature.
Masatake YAMATO <jet@gyve.org>
parents: 53410
diff changeset
323 (provide 'register)
93975
1e3a407766b9 Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 87649
diff changeset
324 ;; arch-tag: ce14dd68-8265-475f-9341-5d4ec5a53035
658
7cbd4fcd8b0f *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 243
diff changeset
325 ;;; register.el ends here