Mercurial > emacs
changeset 103303:220750e4fe9a
* mark.texi (Mark): Further clarifications.
(Setting Mark): Emphasize that C-SPC activates the mark.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Thu, 28 May 2009 20:36:03 +0000 |
parents | 94d7b0fd65d2 |
children | 2ebd7d8c8506 |
files | doc/emacs/ChangeLog doc/emacs/mark.texi |
diffstat | 2 files changed, 19 insertions(+), 13 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/emacs/ChangeLog Thu May 28 16:53:05 2009 +0000 +++ b/doc/emacs/ChangeLog Thu May 28 20:36:03 2009 +0000 @@ -1,3 +1,8 @@ +2009-05-28 Chong Yidong <cyd@stupidchicken.com> + + * mark.texi (Mark): Further clarifications. + (Setting Mark): Emphasize that C-SPC activates the mark. + 2009-05-28 Chong Yidong <cyd@stupidchicken.com> * mark.texi (Mark): Clarify introduction. Mention disabling Transient
--- a/doc/emacs/mark.texi Thu May 28 16:53:05 2009 +0000 +++ b/doc/emacs/mark.texi Thu May 28 20:36:03 2009 +0000 @@ -16,9 +16,10 @@ one comes earlier in the text; each time you move point, the region changes. - When the mark is @dfn{active}, Emacs indicates the extent of the -region by highlighting the text within it, using the @code{region} -face (@pxref{Face Customization}). After certain non-motion commands, + Setting the mark at a position in the text also @dfn{activates} it. +When the mark is active, Emacs indicates the extent of the region by +highlighting the text within it, using the @code{region} face +(@pxref{Face Customization}). After certain non-motion commands, including any command that changes the text in the buffer, Emacs automatically @dfn{deactivates} the mark; this turns off the highlighting. You can also explicitly deactivate the mark at any @@ -56,7 +57,7 @@ @table @kbd @item C-@key{SPC} -Set the mark at point (@code{set-mark-command}). +Set the mark at point, and activate it (@code{set-mark-command}). @item C-@@ The same. @item C-x C-x @@ -75,14 +76,14 @@ @kindex C-@@ @findex set-mark-command The most common way to set the mark is with @kbd{C-@key{SPC}} -(@code{set-mark-command}), which sets the mark where point -is@footnote{There is no @kbd{C-@key{SPC}} character in -@acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a text terminal -gives the character @kbd{C-@@}. This key is also bound to -@code{set-mark-command}, so unless you are unlucky enough to have an -text terminal that behaves differently, you might as well think of -@kbd{C-@@} as @kbd{C-@key{SPC}}.}. You can then move point away, -leaving the mark behind. +(@code{set-mark-command})@footnote{There is no @kbd{C-@key{SPC}} +character in @acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a +text terminal gives the character @kbd{C-@@}. This key is also bound +to @code{set-mark-command}, so unless you are unlucky enough to have +an text terminal that behaves differently, you might as well think of +@kbd{C-@@} as @kbd{C-@key{SPC}}.}. This sets the mark where point is, +and activates it. You can then move point away, leaving the mark +behind. For example, suppose you wish to convert part of the buffer to upper case. To accomplish this, go to the beginning of the desired text, @@ -95,7 +96,7 @@ @findex exchange-point-and-mark The command @kbd{C-x C-x} (@code{exchange-point-and-mark}) exchanges the positions of point and the mark, keeping the region unchanged. If -no mark is active, Emacs first reactivates the mark wherever it was +the mark is inactive, Emacs first reactivates the mark wherever it was last set. @kbd{C-x C-x} is useful when you are satisfied with the position of point but want to move the other end of the region (where the mark is). Using @kbd{C-x C-x} a second time, if necessary, puts