annotate man/mark.texi @ 66439:52c79134b5d5

(jit-lock-fontify-now): Be careful not to skip multiline regions when moving the jit-lock-context-unfontify-pos boundary.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Tue, 25 Oct 2005 15:26:41 +0000
parents 3723093a21fd
children 9c71dbde648a 2d92f5c9d6ae
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
64890
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 63005
diff changeset
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2001, 2002,
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 63005
diff changeset
3 @c 2003, 2004, 2005 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @node Mark, Killing, Help, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @chapter The Mark and the Region
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @cindex mark
Dave Love <fx@gnu.org>
parents:
diff changeset
8 @cindex setting a mark
Dave Love <fx@gnu.org>
parents:
diff changeset
9 @cindex region
Dave Love <fx@gnu.org>
parents:
diff changeset
10
Dave Love <fx@gnu.org>
parents:
diff changeset
11 Many Emacs commands operate on an arbitrary contiguous part of the
Dave Love <fx@gnu.org>
parents:
diff changeset
12 current buffer. To specify the text for such a command to operate on,
Dave Love <fx@gnu.org>
parents:
diff changeset
13 you set @dfn{the mark} at one end of it, and move point to the other
Dave Love <fx@gnu.org>
parents:
diff changeset
14 end. The text between point and the mark is called @dfn{the region}.
Dave Love <fx@gnu.org>
parents:
diff changeset
15 Emacs highlights the region whenever there is one, if you enable
Dave Love <fx@gnu.org>
parents:
diff changeset
16 Transient Mark mode (@pxref{Transient Mark}).
Dave Love <fx@gnu.org>
parents:
diff changeset
17
38411
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
18 Certain Emacs commands set the mark; other editing commands do not
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
19 affect it, so the mark remains where you set it last. Each Emacs
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
20 buffer has its own mark, and setting the mark in one buffer has no
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
21 effect on other buffers' marks. When you return to a buffer that was
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
22 current earlier, its mark is at the same place as before.
38411
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
23
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
24 The ends of the region are always point and the mark. It doesn't
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
25 matter which of them was put in its current place first, or which one
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
26 comes earlier in the text---the region starts from point or the mark
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
27 (whichever comes first), and ends at point or the mark (whichever
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
28 comes last). Every time you move point, or set the mark in a new
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
29 place, the region changes.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
30
Dave Love <fx@gnu.org>
parents:
diff changeset
31 Many commands that insert text, such as @kbd{C-y} (@code{yank}) and
38411
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
32 @kbd{M-x insert-buffer}, position point and the mark at opposite ends
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
33 of the inserted text, so that the region consists of the text just
2fc02d49a9a4 Clarify initial discussion.
Richard M. Stallman <rms@gnu.org>
parents: 38208
diff changeset
34 inserted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
35
Dave Love <fx@gnu.org>
parents:
diff changeset
36 Aside from delimiting the region, the mark is also useful for
Dave Love <fx@gnu.org>
parents:
diff changeset
37 remembering a spot that you may want to go back to. To make this
Dave Love <fx@gnu.org>
parents:
diff changeset
38 feature more useful, each buffer remembers 16 previous locations of the
Dave Love <fx@gnu.org>
parents:
diff changeset
39 mark in the @dfn{mark ring}.
Dave Love <fx@gnu.org>
parents:
diff changeset
40
Dave Love <fx@gnu.org>
parents:
diff changeset
41 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
42 * Setting Mark:: Commands to set the mark.
Dave Love <fx@gnu.org>
parents:
diff changeset
43 * Transient Mark:: How to make Emacs highlight the region--
Dave Love <fx@gnu.org>
parents:
diff changeset
44 when there is one.
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
45 * Momentary Mark:: Enabling Transient Mark mode momentarily.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
46 * Using Region:: Summary of ways to operate on contents of the region.
Dave Love <fx@gnu.org>
parents:
diff changeset
47 * Marking Objects:: Commands to put region around textual units.
Dave Love <fx@gnu.org>
parents:
diff changeset
48 * Mark Ring:: Previous mark positions saved so you can go back there.
Dave Love <fx@gnu.org>
parents:
diff changeset
49 * Global Mark Ring:: Previous mark positions in various buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
50 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
51
Dave Love <fx@gnu.org>
parents:
diff changeset
52 @node Setting Mark
Dave Love <fx@gnu.org>
parents:
diff changeset
53 @section Setting the Mark
Dave Love <fx@gnu.org>
parents:
diff changeset
54
Dave Love <fx@gnu.org>
parents:
diff changeset
55 Here are some commands for setting the mark:
Dave Love <fx@gnu.org>
parents:
diff changeset
56
Dave Love <fx@gnu.org>
parents:
diff changeset
57 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
58 @item C-@key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
59 Set the mark where point is (@code{set-mark-command}).
Dave Love <fx@gnu.org>
parents:
diff changeset
60 @item C-@@
Dave Love <fx@gnu.org>
parents:
diff changeset
61 The same.
Dave Love <fx@gnu.org>
parents:
diff changeset
62 @item C-x C-x
Dave Love <fx@gnu.org>
parents:
diff changeset
63 Interchange mark and point (@code{exchange-point-and-mark}).
Dave Love <fx@gnu.org>
parents:
diff changeset
64 @item Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
65 Set point and the mark around the text you drag across.
Dave Love <fx@gnu.org>
parents:
diff changeset
66 @item Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
67 Set the mark where point is, then move point to where you click
Dave Love <fx@gnu.org>
parents:
diff changeset
68 (@code{mouse-save-then-kill}).
Dave Love <fx@gnu.org>
parents:
diff changeset
69 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
70
Dave Love <fx@gnu.org>
parents:
diff changeset
71 For example, suppose you wish to convert part of the buffer to
Dave Love <fx@gnu.org>
parents:
diff changeset
72 upper case, using the @kbd{C-x C-u} (@code{upcase-region}) command,
Dave Love <fx@gnu.org>
parents:
diff changeset
73 which operates on the text in the region. You can first go to the
Dave Love <fx@gnu.org>
parents:
diff changeset
74 beginning of the text to be capitalized, type @kbd{C-@key{SPC}} to put
Dave Love <fx@gnu.org>
parents:
diff changeset
75 the mark there, move to the end, and then type @kbd{C-x C-u}. Or, you
Dave Love <fx@gnu.org>
parents:
diff changeset
76 can set the mark at the end of the text, move to the beginning, and then
Dave Love <fx@gnu.org>
parents:
diff changeset
77 type @kbd{C-x C-u}.
Dave Love <fx@gnu.org>
parents:
diff changeset
78
Dave Love <fx@gnu.org>
parents:
diff changeset
79 @kindex C-SPC
Dave Love <fx@gnu.org>
parents:
diff changeset
80 @findex set-mark-command
Dave Love <fx@gnu.org>
parents:
diff changeset
81 The most common way to set the mark is with the @kbd{C-@key{SPC}} command
Dave Love <fx@gnu.org>
parents:
diff changeset
82 (@code{set-mark-command}). This sets the mark where point is. Then you
Dave Love <fx@gnu.org>
parents:
diff changeset
83 can move point away, leaving the mark behind.
Dave Love <fx@gnu.org>
parents:
diff changeset
84
Dave Love <fx@gnu.org>
parents:
diff changeset
85 There are two ways to set the mark with the mouse. You can drag mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
86 button one across a range of text; that puts point where you release the
Dave Love <fx@gnu.org>
parents:
diff changeset
87 mouse button, and sets the mark at the other end of that range. Or you
Dave Love <fx@gnu.org>
parents:
diff changeset
88 can click mouse button three, which sets the mark at point (like
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
89 @kbd{C-@key{SPC}}) and then moves point where you clicked (like
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
90 @kbd{Mouse-1}). Both of these methods copy the region into the kill
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
91 ring in addition to setting the mark; that gives behavior consistent
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
92 with other window-driven applications, but if you don't want to modify
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
93 the kill ring, you must use keyboard commands to set the mark.
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
94 @xref{Mouse Commands}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
95
Dave Love <fx@gnu.org>
parents:
diff changeset
96 @kindex C-x C-x
Dave Love <fx@gnu.org>
parents:
diff changeset
97 @findex exchange-point-and-mark
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
98 When Emacs was developed, terminals had only one cursor, so Emacs
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
99 does not show where the mark is located--you have to remember. If you
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
100 enable Transient Mark mode (see below), then the region is highlighted
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
101 when it is active; you can tell mark is at the other end of the
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
102 highlighted region. But this only applies when the mark is active.
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
103
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
104 The usual solution to this problem is to set the mark and then use
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
105 it soon, before you forget where it is. Alternatively, you can see
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
106 where the mark is with the command @kbd{C-x C-x}
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
107 (@code{exchange-point-and-mark}) which puts the mark where point was
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
108 and point where the mark was. The extent of the region is unchanged,
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
109 but the cursor and point are now at the previous position of the mark.
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
110 In Transient Mark mode, this command also reactivates the mark.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
111
Dave Love <fx@gnu.org>
parents:
diff changeset
112 @kbd{C-x C-x} is also useful when you are satisfied with the position
Dave Love <fx@gnu.org>
parents:
diff changeset
113 of point but want to move the other end of the region (where the mark
Dave Love <fx@gnu.org>
parents:
diff changeset
114 is); do @kbd{C-x C-x} to put point at that end of the region, and then
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
115 move it. Using @kbd{C-x C-x} a second time, if necessary, puts the mark at
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
116 the new position with point back at its original position.
Dave Love <fx@gnu.org>
parents:
diff changeset
117
36359
33c7ddaf02c6 (Setting Mark): Add a cross-reference to the section which describes
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
118 For more facilities that allow you to go to previously set marks, see
33c7ddaf02c6 (Setting Mark): Add a cross-reference to the section which describes
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
119 @ref{Mark Ring}.
33c7ddaf02c6 (Setting Mark): Add a cross-reference to the section which describes
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
120
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
121 @kindex C-@@
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
122 There is no such character as @kbd{C-@key{SPC}} in @acronym{ASCII};
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
123 when you type @key{SPC} while holding down @key{CTRL} on a text
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
124 terminal, what you get is the character @kbd{C-@@}. This key is also
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
125 bound to @code{set-mark-command}--so unless you are unlucky enough to
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
126 have a text terminal where typing @kbd{C-@key{SPC}} does not produce
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
127 @kbd{C-@@}, you might as well think of this character as
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
128 @kbd{C-@key{SPC}}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
129
Dave Love <fx@gnu.org>
parents:
diff changeset
130 @node Transient Mark
Dave Love <fx@gnu.org>
parents:
diff changeset
131 @section Transient Mark Mode
Dave Love <fx@gnu.org>
parents:
diff changeset
132 @cindex mode, Transient Mark
Dave Love <fx@gnu.org>
parents:
diff changeset
133 @cindex Transient Mark mode
Dave Love <fx@gnu.org>
parents:
diff changeset
134 @cindex highlighting region
Dave Love <fx@gnu.org>
parents:
diff changeset
135 @cindex region highlighting
Dave Love <fx@gnu.org>
parents:
diff changeset
136
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
137 On a terminal that supports colors, Emacs has the ability to
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
138 highlight the current region. But normally it does not. Why not?
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
139
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
140 Once you have set the mark in a buffer, there is @emph{always} a
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
141 region in that buffer. This is because every command that sets the
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
142 mark also activates it, and nothing ever deactivates it. Highlighting
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
143 the region all the time would be a nuisance. So normally Emacs
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
144 highlights the region only immediately after you have selected one
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
145 with the mouse.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
146
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
147 If you want region highlighting, you can use Transient Mark mode.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
148 This is a more rigid mode of operation in which the region always
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
149 ``lasts'' only until you use it; you explicitly must set up a region
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
150 for each command that uses one. In Transient Mark mode, most of the
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
151 time there is no region; therefore, highlighting the region when it
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
152 exists is useful and not annoying. When Transient Mark mode is
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
153 enabled, Emacs always highlights the region whenever there is a
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
154 region.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
155
Dave Love <fx@gnu.org>
parents:
diff changeset
156 @findex transient-mark-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
157 To enable Transient Mark mode, type @kbd{M-x transient-mark-mode}.
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
158 This command toggles the mode; you can use the same command to turn
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
159 the mode off again.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
160
Dave Love <fx@gnu.org>
parents:
diff changeset
161 Here are the details of Transient Mark mode:
Dave Love <fx@gnu.org>
parents:
diff changeset
162
Dave Love <fx@gnu.org>
parents:
diff changeset
163 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
164 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
165 To set the mark, type @kbd{C-@key{SPC}} (@code{set-mark-command}).
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
166 This makes the mark active and thus begins highlighting of the region.
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
167 As you move point, you will see the highlighted region grow and
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
168 shrink.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
169
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 46237
diff changeset
170 @item
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
171 The mouse commands for specifying the mark also make it active. So do
Dave Love <fx@gnu.org>
parents:
diff changeset
172 keyboard commands whose purpose is to specify a region, including
Dave Love <fx@gnu.org>
parents:
diff changeset
173 @kbd{M-@@}, @kbd{C-M-@@}, @kbd{M-h}, @kbd{C-M-h}, @kbd{C-x C-p}, and
Dave Love <fx@gnu.org>
parents:
diff changeset
174 @kbd{C-x h}.
Dave Love <fx@gnu.org>
parents:
diff changeset
175
Dave Love <fx@gnu.org>
parents:
diff changeset
176 @item
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
177 You can tell that the mark is active because the region is highlighted.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
178
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
179 @item
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
180 When the mark is active, you can execute commands that operate on the
Dave Love <fx@gnu.org>
parents:
diff changeset
181 region, such as killing, indenting, or writing to a file.
Dave Love <fx@gnu.org>
parents:
diff changeset
182
Dave Love <fx@gnu.org>
parents:
diff changeset
183 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
184 Any change to the buffer, such as inserting or deleting a character,
Dave Love <fx@gnu.org>
parents:
diff changeset
185 deactivates the mark. This means any subsequent command that operates
Dave Love <fx@gnu.org>
parents:
diff changeset
186 on a region will get an error and refuse to operate. You can make the
Dave Love <fx@gnu.org>
parents:
diff changeset
187 region active again by typing @kbd{C-x C-x}.
Dave Love <fx@gnu.org>
parents:
diff changeset
188
Dave Love <fx@gnu.org>
parents:
diff changeset
189 @item
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
190 If Delete Selection mode is also enabled, some commands delete the
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
191 region when used while the mark is active. @xref{Graphical Kill}.
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
192
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
193 @item
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
194 Quitting with @kbd{C-g} deactivates the mark.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
195
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
196 @item
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
197 Commands like @kbd{M->} and @kbd{C-s}, that ``leave the mark behind'' in
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
198 addition to some other primary purpose, do not activate the new mark.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
199 You can activate the new region by executing @kbd{C-x C-x}
Dave Love <fx@gnu.org>
parents:
diff changeset
200 (@code{exchange-point-and-mark}).
Dave Love <fx@gnu.org>
parents:
diff changeset
201
Dave Love <fx@gnu.org>
parents:
diff changeset
202 @item
58974
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
203 Commands that normally set the mark before moving long distances (like
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
204 @kbd{M-<} and @kbd{C-s}) do not alter the mark in Transient Mark mode
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
205 when the mark is active.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
206
Dave Love <fx@gnu.org>
parents:
diff changeset
207 @item
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
208 Some commands operate on the region if a region is active. For
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
209 instance, @kbd{C-x u} in Transient Mark mode operates on the region,
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
210 when there is a region. (Outside Transient Mark mode, you must type
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
211 @kbd{C-u C-x u} if you want it to operate on the region.)
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
212 @xref{Undo}. Other commands that act this way are identified in their
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
213 own documentation.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
214 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
215
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
216 The highlighting of the region uses the @code{region} face; you can
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
217 customize the appearance of the highlighted region by changing this
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
218 face. @xref{Face Customization}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
219
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @vindex highlight-nonselected-windows
Dave Love <fx@gnu.org>
parents:
diff changeset
221 When multiple windows show the same buffer, they can have different
Dave Love <fx@gnu.org>
parents:
diff changeset
222 regions, because they can have different values of point (though they
Dave Love <fx@gnu.org>
parents:
diff changeset
223 all share one common mark position). Ordinarily, only the selected
Dave Love <fx@gnu.org>
parents:
diff changeset
224 window highlights its region (@pxref{Windows}). However, if the
Dave Love <fx@gnu.org>
parents:
diff changeset
225 variable @code{highlight-nonselected-windows} is non-@code{nil}, then
Dave Love <fx@gnu.org>
parents:
diff changeset
226 each window highlights its own region (provided that Transient Mark mode
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
227 is enabled and the mark in the window's buffer is active).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
228
Dave Love <fx@gnu.org>
parents:
diff changeset
229 @vindex mark-even-if-inactive
Dave Love <fx@gnu.org>
parents:
diff changeset
230 If the variable @code{mark-even-if-inactive} is non-@code{nil} in
Dave Love <fx@gnu.org>
parents:
diff changeset
231 Transient Mark mode, then commands can use the mark and the region
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
232 even when it is inactive. Region highlighting appears and disappears
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
233 just as it normally does in Transient Mark mode, but the mark doesn't
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
234 really go away when the highlighting disappears, so you can still use
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
235 region commands.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
236
Dave Love <fx@gnu.org>
parents:
diff changeset
237 @cindex Zmacs mode
Dave Love <fx@gnu.org>
parents:
diff changeset
238 Transient Mark mode is also sometimes known as ``Zmacs mode''
Dave Love <fx@gnu.org>
parents:
diff changeset
239 because the Zmacs editor on the MIT Lisp Machine handled the mark in a
Dave Love <fx@gnu.org>
parents:
diff changeset
240 similar way.
Dave Love <fx@gnu.org>
parents:
diff changeset
241
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
242 @node Momentary Mark
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
243 @section Using Transient Mark Mode Momentarily
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
244
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
245 If you don't like Transient Mark mode in general, you might still
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
246 want to use it once in a while. To do this, type @kbd{C-@key{SPC}
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
247 C-@key{SPC}} or @kbd{C-u C-x C-x}. These commands set or activate the
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
248 mark, and enable Transient Mark mode only until the mark is
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
249 deactivated.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
250
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
251 @table @kbd
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
252 @item C-@key{SPC} C-@key{SPC}
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
253 @kindex C-@key{SPC} C-@key{SPC}
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
254 Set the mark at point (like plain @kbd{C-@key{SPC}}), and enable
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
255 Transient Mark mode just once until the mark is deactivated. (This is
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
256 not really a separate command; you are using the @kbd{C-@key{SPC}}
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
257 command twice.)
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
258
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
259 @item C-u C-x C-x
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
260 @kindex C-u C-x C-x
56691
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
261 Activate the mark without changing it; enable Transient Mark mode just
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
262 once, until the mark is deactivated. (This is the @kbd{C-x C-x}
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
263 command, @code{exchange-point-and-mark}, with a prefix argument.)
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
264 @end table
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
265
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
266 One of the secondary features of Transient Mark mode is that certain
56691
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
267 commands operate only on the region, when there is an active region.
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
268 If you don't use Transient Mark mode, the region once set never
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
269 becomes inactive, so there is no way for these commands to make such a
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
270 distinction. Enabling Transient Mark mode momentarily gives you a way
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
271 to use these commands on the region.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
272
56691
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
273 Momentary use of Transient Mark mode is also a way to highlight the
378fee0ad45e (Momentary Mark): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
274 region for the time being.
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
275
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
276 @node Using Region
Dave Love <fx@gnu.org>
parents:
diff changeset
277 @section Operating on the Region
Dave Love <fx@gnu.org>
parents:
diff changeset
278
Dave Love <fx@gnu.org>
parents:
diff changeset
279 @cindex operations on a marked region
Dave Love <fx@gnu.org>
parents:
diff changeset
280 Once you have a region and the mark is active, here are some of the
Dave Love <fx@gnu.org>
parents:
diff changeset
281 ways you can operate on the region:
Dave Love <fx@gnu.org>
parents:
diff changeset
282
Dave Love <fx@gnu.org>
parents:
diff changeset
283 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
284 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
285 Kill it with @kbd{C-w} (@pxref{Killing}).
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
287 Save it in a register with @kbd{C-x r s} (@pxref{Registers}).
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
289 Save it in a buffer or a file (@pxref{Accumulating Text}).
Dave Love <fx@gnu.org>
parents:
diff changeset
290 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
291 Convert case with @kbd{C-x C-l} or @kbd{C-x C-u} (@pxref{Case}).
Dave Love <fx@gnu.org>
parents:
diff changeset
292 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
293 Indent it with @kbd{C-x @key{TAB}} or @kbd{C-M-\} (@pxref{Indentation}).
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
295 Fill it as text with @kbd{M-x fill-region} (@pxref{Filling}).
Dave Love <fx@gnu.org>
parents:
diff changeset
296 @item
63005
e4c68c19a6bc (Using Region): Change Hardcopy xref to Printing.
Eli Zaretskii <eliz@gnu.org>
parents: 60244
diff changeset
297 Print hardcopy with @kbd{M-x print-region} (@pxref{Printing}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
298 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
299 Evaluate it as Lisp code with @kbd{M-x eval-region} (@pxref{Lisp Eval}).
Dave Love <fx@gnu.org>
parents:
diff changeset
300 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
301
38482
c8c4805bde95 Minor changes from Richard Stallman.
Eli Zaretskii <eliz@gnu.org>
parents: 38461
diff changeset
302 Most commands that operate on the text in the region have the word
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
303 @code{region} in their names.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
304
Dave Love <fx@gnu.org>
parents:
diff changeset
305 @node Marking Objects
Dave Love <fx@gnu.org>
parents:
diff changeset
306 @section Commands to Mark Textual Objects
Dave Love <fx@gnu.org>
parents:
diff changeset
307
Dave Love <fx@gnu.org>
parents:
diff changeset
308 @cindex marking sections of text
Dave Love <fx@gnu.org>
parents:
diff changeset
309 Here are the commands for placing point and the mark around a textual
Dave Love <fx@gnu.org>
parents:
diff changeset
310 object such as a word, list, paragraph or page.
Dave Love <fx@gnu.org>
parents:
diff changeset
311
Dave Love <fx@gnu.org>
parents:
diff changeset
312 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
313 @item M-@@
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
314 Set mark after end of next word (@code{mark-word}). This command and
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
315 the following one do not move point.
Dave Love <fx@gnu.org>
parents:
diff changeset
316 @item C-M-@@
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
317 Set mark after end of following balanced expression (@code{mark-sexp}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
318 @item M-h
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
319 Put region around current paragraph (@code{mark-paragraph}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
320 @item C-M-h
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
321 Put region around current defun (@code{mark-defun}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
322 @item C-x h
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
323 Put region around the entire buffer (@code{mark-whole-buffer}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
324 @item C-x C-p
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
325 Put region around current page (@code{mark-page}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
326 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
327
38207
e24d77a5adf1 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37316
diff changeset
328 @kbd{M-@@} (@code{mark-word}) puts the mark at the end of the next
e24d77a5adf1 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37316
diff changeset
329 word, while @kbd{C-M-@@} (@code{mark-sexp}) puts it at the end of the
e24d77a5adf1 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37316
diff changeset
330 next balanced expression (@pxref{Expressions}). These commands handle
43301
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41795
diff changeset
331 arguments just like @kbd{M-f} and @kbd{C-M-f}. If you repeat these
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
332 commands, that extends the region. For example, you can type either
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
333 @kbd{C-u 2 M-@@} or @kbd{M-@@ M-@@} to mark the next two words. This
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
334 command also extends the region when the mark is active in Transient
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
335 Mark mode, regardless of the last command.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
336
Dave Love <fx@gnu.org>
parents:
diff changeset
337 @kindex C-x h
Dave Love <fx@gnu.org>
parents:
diff changeset
338 @findex mark-whole-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
339 Other commands set both point and mark, to delimit an object in the
Dave Love <fx@gnu.org>
parents:
diff changeset
340 buffer. For example, @kbd{M-h} (@code{mark-paragraph}) moves point to
41748
0302528bddbc Fix wording of the last change.
Eli Zaretskii <eliz@gnu.org>
parents: 41743
diff changeset
341 the beginning of the paragraph that surrounds or follows point, and
0302528bddbc Fix wording of the last change.
Eli Zaretskii <eliz@gnu.org>
parents: 41743
diff changeset
342 puts the mark at the end of that paragraph (@pxref{Paragraphs}). It
0302528bddbc Fix wording of the last change.
Eli Zaretskii <eliz@gnu.org>
parents: 41743
diff changeset
343 prepares the region so you can indent, case-convert, or kill a whole
0302528bddbc Fix wording of the last change.
Eli Zaretskii <eliz@gnu.org>
parents: 41743
diff changeset
344 paragraph. With prefix argument, if the argument's value is positive,
41795
48c74a2caa77 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 41748
diff changeset
345 @kbd{M-h} marks that many paragraphs starting with the one surrounding
48c74a2caa77 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 41748
diff changeset
346 point. If the prefix argument is @minus{}@var{n}, @kbd{M-h} also
48c74a2caa77 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 41748
diff changeset
347 marks @var{n} paragraphs, running back form the one surrounding point.
48c74a2caa77 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 41748
diff changeset
348 In that last case, point moves forward to the end of that paragraph,
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
349 and the mark goes at the start of the region. Repeating the @kbd{M-h}
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
350 command extends the region, just as with @kbd{M-@@} and @kbd{C-M-@@}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
351
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
352 @kbd{C-M-h} (@code{mark-defun}) similarly puts point before, and the
38786
4d3fd773cd30 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38490
diff changeset
353 mark after, the current (or following) major top-level definition, or
60244
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
354 defun (@pxref{Moving by Defuns}). Repeating @kbd{C-M-h} also extends
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
355 the region.
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
356
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
357 @kbd{C-x C-p} (@code{mark-page}) puts point before the current page,
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
358 and mark at the end (@pxref{Pages}). The mark goes after the
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
359 terminating page delimiter (to include it in the region), while point
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
360 goes after the preceding page delimiter (to exclude it). A numeric
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
361 argument specifies a later page (if positive) or an earlier page (if
1f085a397379 (Setting Mark): Clarify info about displaying mark.
Richard M. Stallman <rms@gnu.org>
parents: 58974
diff changeset
362 negative) instead of the current page.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
363
Dave Love <fx@gnu.org>
parents:
diff changeset
364 Finally, @kbd{C-x h} (@code{mark-whole-buffer}) sets up the entire
Dave Love <fx@gnu.org>
parents:
diff changeset
365 buffer as the region, by putting point at the beginning and the mark at
Dave Love <fx@gnu.org>
parents:
diff changeset
366 the end.
Dave Love <fx@gnu.org>
parents:
diff changeset
367
Dave Love <fx@gnu.org>
parents:
diff changeset
368 In Transient Mark mode, all of these commands activate the mark.
Dave Love <fx@gnu.org>
parents:
diff changeset
369
Dave Love <fx@gnu.org>
parents:
diff changeset
370 @node Mark Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
371 @section The Mark Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
372
Dave Love <fx@gnu.org>
parents:
diff changeset
373 @kindex C-u C-SPC
Dave Love <fx@gnu.org>
parents:
diff changeset
374 @cindex mark ring
Dave Love <fx@gnu.org>
parents:
diff changeset
375 @kindex C-u C-@@
Dave Love <fx@gnu.org>
parents:
diff changeset
376 Aside from delimiting the region, the mark is also useful for
Dave Love <fx@gnu.org>
parents:
diff changeset
377 remembering a spot that you may want to go back to. To make this
Dave Love <fx@gnu.org>
parents:
diff changeset
378 feature more useful, each buffer remembers 16 previous locations of the
Dave Love <fx@gnu.org>
parents:
diff changeset
379 mark, in the @dfn{mark ring}. Commands that set the mark also push the
Dave Love <fx@gnu.org>
parents:
diff changeset
380 old mark onto this ring. To return to a marked location, use @kbd{C-u
38490
1518ad710658 Fix last changes.
Eli Zaretskii <eliz@gnu.org>
parents: 38482
diff changeset
381 C-@key{SPC}} (or @kbd{C-u C-@@}); this is the command
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
382 @code{set-mark-command} given a numeric argument. It moves point to
Dave Love <fx@gnu.org>
parents:
diff changeset
383 where the mark was, and restores the mark from the ring of former
46237
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
384 marks.
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
385
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
386 If you repeat the character @kbd{C-@key{SPC}}, after typing @kbd{C-u
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
387 C-@key{SPC}}, each repetition moves point to a previous mark position
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
388 from the ring. The mark positions you move through in this way are
46b0c6f318b5 New node Momentary Mark.
Richard M. Stallman <rms@gnu.org>
parents: 43301
diff changeset
389 not lost; they go to the end of the ring.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
390
Dave Love <fx@gnu.org>
parents:
diff changeset
391 Each buffer has its own mark ring. All editing commands use the current
Dave Love <fx@gnu.org>
parents:
diff changeset
392 buffer's mark ring. In particular, @kbd{C-u C-@key{SPC}} always stays in
Dave Love <fx@gnu.org>
parents:
diff changeset
393 the same buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
394
Dave Love <fx@gnu.org>
parents:
diff changeset
395 Many commands that can move long distances, such as @kbd{M-<}
Dave Love <fx@gnu.org>
parents:
diff changeset
396 (@code{beginning-of-buffer}), start by setting the mark and saving the
Dave Love <fx@gnu.org>
parents:
diff changeset
397 old mark on the mark ring. This is to make it easier for you to move
58974
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
398 back later. Searches set the mark if they move point. However, in
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
399 Transient Mark mode, these commands do not set the mark when the mark
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
400 is already active. You can tell when a command sets the mark because
f23a14da8463 (Transient Mark, Mark Ring): M-< and other
Juri Linkov <juri@jurta.org>
parents: 58920
diff changeset
401 it displays @samp{Mark set} in the echo area.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
402
Dave Love <fx@gnu.org>
parents:
diff changeset
403 If you want to move back to the same place over and over, the mark
Dave Love <fx@gnu.org>
parents:
diff changeset
404 ring may not be convenient enough. If so, you can record the position
37316
171ad460e884 Correct case of "Mark set" message.
Richard M. Stallman <rms@gnu.org>
parents: 36359
diff changeset
405 in a register for later retrieval (@pxref{RegPos,, Saving Positions in
171ad460e884 Correct case of "Mark set" message.
Richard M. Stallman <rms@gnu.org>
parents: 36359
diff changeset
406 Registers}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
407
Dave Love <fx@gnu.org>
parents:
diff changeset
408 @vindex mark-ring-max
Dave Love <fx@gnu.org>
parents:
diff changeset
409 The variable @code{mark-ring-max} specifies the maximum number of
Dave Love <fx@gnu.org>
parents:
diff changeset
410 entries to keep in the mark ring. If that many entries exist and
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38411
diff changeset
411 another one is pushed, the earliest one in the list is discarded. Repeating
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
412 @kbd{C-u C-@key{SPC}} cycles through the positions currently in the
Dave Love <fx@gnu.org>
parents:
diff changeset
413 ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
414
Dave Love <fx@gnu.org>
parents:
diff changeset
415 @vindex mark-ring
Dave Love <fx@gnu.org>
parents:
diff changeset
416 The variable @code{mark-ring} holds the mark ring itself, as a list of
Dave Love <fx@gnu.org>
parents:
diff changeset
417 marker objects, with the most recent first. This variable is local in
Dave Love <fx@gnu.org>
parents:
diff changeset
418 every buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
419
Dave Love <fx@gnu.org>
parents:
diff changeset
420 @node Global Mark Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
421 @section The Global Mark Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
422 @cindex global mark ring
Dave Love <fx@gnu.org>
parents:
diff changeset
423
Dave Love <fx@gnu.org>
parents:
diff changeset
424 In addition to the ordinary mark ring that belongs to each buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
425 Emacs has a single @dfn{global mark ring}. It records a sequence of
Dave Love <fx@gnu.org>
parents:
diff changeset
426 buffers in which you have recently set the mark, so you can go back
Dave Love <fx@gnu.org>
parents:
diff changeset
427 to those buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
428
Dave Love <fx@gnu.org>
parents:
diff changeset
429 Setting the mark always makes an entry on the current buffer's mark
Dave Love <fx@gnu.org>
parents:
diff changeset
430 ring. If you have switched buffers since the previous mark setting, the
Dave Love <fx@gnu.org>
parents:
diff changeset
431 new mark position makes an entry on the global mark ring also. The
Dave Love <fx@gnu.org>
parents:
diff changeset
432 result is that the global mark ring records a sequence of buffers that
Dave Love <fx@gnu.org>
parents:
diff changeset
433 you have been in, and, for each buffer, a place where you set the mark.
Dave Love <fx@gnu.org>
parents:
diff changeset
434
Dave Love <fx@gnu.org>
parents:
diff changeset
435 @kindex C-x C-@key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
436 @findex pop-global-mark
Dave Love <fx@gnu.org>
parents:
diff changeset
437 The command @kbd{C-x C-@key{SPC}} (@code{pop-global-mark}) jumps to
Dave Love <fx@gnu.org>
parents:
diff changeset
438 the buffer and position of the latest entry in the global ring. It also
Dave Love <fx@gnu.org>
parents:
diff changeset
439 rotates the ring, so that successive uses of @kbd{C-x C-@key{SPC}} take
Dave Love <fx@gnu.org>
parents:
diff changeset
440 you to earlier and earlier buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
441
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
442 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
443 arch-tag: f35e4d82-911b-4cfc-a3d7-3c87b2abba20
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
444 @end ignore