aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2009-05-28 20:36:03 +0000
committerChong Yidong2009-05-28 20:36:03 +0000
commit623cec4c07aec805cb4ac234b1ebfa80a092e4a2 (patch)
tree46a573b28908e919c7f4d6d8919055cae57cd0ee
parent702b10e19bcf6aa11d6c00dde6ee1b94e92d5db1 (diff)
downloademacs-623cec4c07aec805cb4ac234b1ebfa80a092e4a2.tar.gz
emacs-623cec4c07aec805cb4ac234b1ebfa80a092e4a2.zip
* mark.texi (Mark): Further clarifications.
(Setting Mark): Emphasize that C-SPC activates the mark.
-rw-r--r--doc/emacs/ChangeLog5
-rw-r--r--doc/emacs/mark.texi27
2 files changed, 19 insertions, 13 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 9d804caa956..a73f8223742 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,5 +1,10 @@
12009-05-28 Chong Yidong <cyd@stupidchicken.com> 12009-05-28 Chong Yidong <cyd@stupidchicken.com>
2 2
3 * mark.texi (Mark): Further clarifications.
4 (Setting Mark): Emphasize that C-SPC activates the mark.
5
62009-05-28 Chong Yidong <cyd@stupidchicken.com>
7
3 * mark.texi (Mark): Clarify introduction. Mention disabling Transient 8 * mark.texi (Mark): Clarify introduction. Mention disabling Transient
4 Mark mode. 9 Mark mode.
5 (Using Region, Persistent Mark): Use "active mark" instead of "active 10 (Using Region, Persistent Mark): Use "active mark" instead of "active
diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi
index b84c98d3b5c..ca50643d596 100644
--- a/doc/emacs/mark.texi
+++ b/doc/emacs/mark.texi
@@ -16,9 +16,10 @@ The region always extends between point and the mark, no matter which
16one comes earlier in the text; each time you move point, the region 16one comes earlier in the text; each time you move point, the region
17changes. 17changes.
18 18
19 When the mark is @dfn{active}, Emacs indicates the extent of the 19 Setting the mark at a position in the text also @dfn{activates} it.
20region by highlighting the text within it, using the @code{region} 20When the mark is active, Emacs indicates the extent of the region by
21face (@pxref{Face Customization}). After certain non-motion commands, 21highlighting the text within it, using the @code{region} face
22(@pxref{Face Customization}). After certain non-motion commands,
22including any command that changes the text in the buffer, Emacs 23including any command that changes the text in the buffer, Emacs
23automatically @dfn{deactivates} the mark; this turns off the 24automatically @dfn{deactivates} the mark; this turns off the
24highlighting. You can also explicitly deactivate the mark at any 25highlighting. You can also explicitly deactivate the mark at any
@@ -56,7 +57,7 @@ non-@code{nil}, each window highlights its own region.
56 57
57@table @kbd 58@table @kbd
58@item C-@key{SPC} 59@item C-@key{SPC}
59Set the mark at point (@code{set-mark-command}). 60Set the mark at point, and activate it (@code{set-mark-command}).
60@item C-@@ 61@item C-@@
61The same. 62The same.
62@item C-x C-x 63@item C-x C-x
@@ -75,14 +76,14 @@ Set the mark at point if the mark is inactive, then move point.
75@kindex C-@@ 76@kindex C-@@
76@findex set-mark-command 77@findex set-mark-command
77 The most common way to set the mark is with @kbd{C-@key{SPC}} 78 The most common way to set the mark is with @kbd{C-@key{SPC}}
78(@code{set-mark-command}), which sets the mark where point 79(@code{set-mark-command})@footnote{There is no @kbd{C-@key{SPC}}
79is@footnote{There is no @kbd{C-@key{SPC}} character in 80character in @acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a
80@acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a text terminal 81text terminal gives the character @kbd{C-@@}. This key is also bound
81gives the character @kbd{C-@@}. This key is also bound to 82to @code{set-mark-command}, so unless you are unlucky enough to have
82@code{set-mark-command}, so unless you are unlucky enough to have an 83an text terminal that behaves differently, you might as well think of
83text terminal that behaves differently, you might as well think of 84@kbd{C-@@} as @kbd{C-@key{SPC}}.}. This sets the mark where point is,
84@kbd{C-@@} as @kbd{C-@key{SPC}}.}. You can then move point away, 85and activates it. You can then move point away, leaving the mark
85leaving the mark behind. 86behind.
86 87
87 For example, suppose you wish to convert part of the buffer to upper 88 For example, suppose you wish to convert part of the buffer to upper
88case. To accomplish this, go to the beginning of the desired text, 89case. To accomplish this, go to the beginning of the desired text,
@@ -95,7 +96,7 @@ deactivates the mark.
95@findex exchange-point-and-mark 96@findex exchange-point-and-mark
96 The command @kbd{C-x C-x} (@code{exchange-point-and-mark}) exchanges 97 The command @kbd{C-x C-x} (@code{exchange-point-and-mark}) exchanges
97the positions of point and the mark, keeping the region unchanged. If 98the positions of point and the mark, keeping the region unchanged. If
98no mark is active, Emacs first reactivates the mark wherever it was 99the mark is inactive, Emacs first reactivates the mark wherever it was
99last set. @kbd{C-x C-x} is useful when you are satisfied with the 100last set. @kbd{C-x C-x} is useful when you are satisfied with the
100position of point but want to move the other end of the region (where 101position of point but want to move the other end of the region (where
101the mark is). Using @kbd{C-x C-x} a second time, if necessary, puts 102the mark is). Using @kbd{C-x C-x} a second time, if necessary, puts