diff options
| author | Chong Yidong | 2009-05-28 20:36:03 +0000 |
|---|---|---|
| committer | Chong Yidong | 2009-05-28 20:36:03 +0000 |
| commit | 623cec4c07aec805cb4ac234b1ebfa80a092e4a2 (patch) | |
| tree | 46a573b28908e919c7f4d6d8919055cae57cd0ee | |
| parent | 702b10e19bcf6aa11d6c00dde6ee1b94e92d5db1 (diff) | |
| download | emacs-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/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/emacs/mark.texi | 27 |
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 @@ | |||
| 1 | 2009-05-28 Chong Yidong <cyd@stupidchicken.com> | 1 | 2009-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 | |||
| 6 | 2009-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 | |||
| 16 | one comes earlier in the text; each time you move point, the region | 16 | one comes earlier in the text; each time you move point, the region |
| 17 | changes. | 17 | changes. |
| 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. |
| 20 | region by highlighting the text within it, using the @code{region} | 20 | When the mark is active, Emacs indicates the extent of the region by |
| 21 | face (@pxref{Face Customization}). After certain non-motion commands, | 21 | highlighting the text within it, using the @code{region} face |
| 22 | (@pxref{Face Customization}). After certain non-motion commands, | ||
| 22 | including any command that changes the text in the buffer, Emacs | 23 | including any command that changes the text in the buffer, Emacs |
| 23 | automatically @dfn{deactivates} the mark; this turns off the | 24 | automatically @dfn{deactivates} the mark; this turns off the |
| 24 | highlighting. You can also explicitly deactivate the mark at any | 25 | highlighting. 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} |
| 59 | Set the mark at point (@code{set-mark-command}). | 60 | Set the mark at point, and activate it (@code{set-mark-command}). |
| 60 | @item C-@@ | 61 | @item C-@@ |
| 61 | The same. | 62 | The 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}} |
| 79 | is@footnote{There is no @kbd{C-@key{SPC}} character in | 80 | character in @acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a |
| 80 | @acronym{ASCII}; usually, typing @kbd{C-@key{SPC}} on a text terminal | 81 | text terminal gives the character @kbd{C-@@}. This key is also bound |
| 81 | gives the character @kbd{C-@@}. This key is also bound to | 82 | to @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 | 83 | an text terminal that behaves differently, you might as well think of |
| 83 | text 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, | 85 | and activates it. You can then move point away, leaving the mark |
| 85 | leaving the mark behind. | 86 | behind. |
| 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 |
| 88 | case. To accomplish this, go to the beginning of the desired text, | 89 | case. 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 |
| 97 | the positions of point and the mark, keeping the region unchanged. If | 98 | the positions of point and the mark, keeping the region unchanged. If |
| 98 | no mark is active, Emacs first reactivates the mark wherever it was | 99 | the mark is inactive, Emacs first reactivates the mark wherever it was |
| 99 | last set. @kbd{C-x C-x} is useful when you are satisfied with the | 100 | last set. @kbd{C-x C-x} is useful when you are satisfied with the |
| 100 | position of point but want to move the other end of the region (where | 101 | position of point but want to move the other end of the region (where |
| 101 | the mark is). Using @kbd{C-x C-x} a second time, if necessary, puts | 102 | the mark is). Using @kbd{C-x C-x} a second time, if necessary, puts |