aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2006-07-29 01:52:29 +0000
committerRichard M. Stallman2006-07-29 01:52:29 +0000
commit464dfe8f0ac72820c0a1f1de4dbd2a36cc865b44 (patch)
treec81094f7eed17c4c06ba102abaee55d6a8bd8de5
parentbcdf86fb51ea5a3860aaade93276f2661cbc70b2 (diff)
downloademacs-464dfe8f0ac72820c0a1f1de4dbd2a36cc865b44.tar.gz
emacs-464dfe8f0ac72820c0a1f1de4dbd2a36cc865b44.zip
(Transient Mark): Clarify that region never disappears
when Transient Mark mode is off, and not when it is on.
-rw-r--r--man/mark.texi28
1 files changed, 15 insertions, 13 deletions
diff --git a/man/mark.texi b/man/mark.texi
index cf7b87366e8..7429b67db2b 100644
--- a/man/mark.texi
+++ b/man/mark.texi
@@ -139,21 +139,23 @@ have a text terminal where typing @kbd{C-@key{SPC}} does not produce
139 On a terminal that supports colors, Emacs has the ability to 139 On a terminal that supports colors, Emacs has the ability to
140highlight the current region. But normally it does not. Why not? 140highlight the current region. But normally it does not. Why not?
141 141
142 Once you have set the mark in a buffer, there is @emph{always} a 142 In the normal mode of use, every command that sets the mark also
143region in that buffer. This is because every command that sets the 143activates it, and nothing ever deactivates it. Thus, once you have
144mark also activates it, and nothing ever deactivates it. Highlighting 144set the mark in a buffer, there is @emph{always} a region in that
145the region all the time would be a nuisance. So normally Emacs 145buffer. Highlighting the region all the time would be a nuisance. So
146highlights the region only immediately after you have selected one 146normally Emacs highlights the region only immediately after you have
147with the mouse. 147selected one with the mouse.
148 148
149 If you want region highlighting, you can use Transient Mark mode. 149 If you want region highlighting, you can use Transient Mark mode.
150This is a more rigid mode of operation in which the region always 150This is a more rigid mode of operation in which the region ``lasts''
151``lasts'' only until you use it; you explicitly must set up a region 151only until you use it; operating on the region text deactivates the
152for each command that uses one. In Transient Mark mode, most of the 152mark, so there is no region any more. Therefore, you must explicitly
153time there is no region; therefore, highlighting the region when it 153set up a region for each command that uses one.
154exists is useful and not annoying. When Transient Mark mode is 154
155enabled, Emacs always highlights the region whenever there is a 155 When Transient Mark mode is enabled, Emacs highlights the region,
156region. 156whenever there is a region. In Transient Mark mode, most of the time
157there is no region; therefore, highlighting the region when it exists
158is useful and not annoying.
157 159
158@findex transient-mark-mode 160@findex transient-mark-mode
159 To enable Transient Mark mode, type @kbd{M-x transient-mark-mode}. 161 To enable Transient Mark mode, type @kbd{M-x transient-mark-mode}.