diff options
| author | Sean Whitton <spwhitton@spwhitton.name> | 2021-12-27 12:58:25 -0700 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2021-12-28 19:39:22 +0200 |
| commit | 06dcd2be5d42362757e923bc5d1952a2bce509b9 (patch) | |
| tree | 111c214e3a87e6449d30684bc7ea687c95dde160 | |
| parent | c0815aca18e210e1590e47b78a01e5dd63401775 (diff) | |
| download | emacs-06dcd2be5d42362757e923bc5d1952a2bce509b9.tar.gz | |
Improve rectangle-mark-mode documentation regarding mark activation
* doc/emacs/killing.texi: Describe how rectangle-mark-mode works when
Transient Mark mode is off. Qualify discussion of
rectangle-exchange-point-and-mark to say that it cycles the four
corners only when the region is active.
* lisp/rect.el (rectangle-mark-mode): State that rectangle-mark-mode
does not activate the mark when Transient Mark mode is off. Reword
sentence about how long the mode lasts to account for when Transient
Mark mode is off. (Bug#42663)
| -rw-r--r-- | doc/emacs/killing.texi | 16 | ||||
| -rw-r--r-- | lisp/rect.el | 3 |
2 files changed, 13 insertions, 6 deletions
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi index 6e4fd77e8b9..37243b6cd2f 100644 --- a/doc/emacs/killing.texi +++ b/doc/emacs/killing.texi @@ -921,6 +921,11 @@ so in a rectangular fashion, and killing and yanking operate on the rectangle. @xref{Killing}. The mode persists only as long as the region is active. +The region-rectangle works only when the mark is active. In +particular, when Transient Mark mode is off (@pxref{Disabled Transient +Mark}), in addition to typing @kbd{C-x @key{SPC}} you will need to +activate the mark. + Unlike the standard region, the region-rectangle can have its corners extended past the end of buffer, or inside stretches of white space that point normally cannot enter, like in the middle of a TAB @@ -929,11 +934,12 @@ character. @findex rectangle-exchange-point-and-mark @findex exchange-point-and-mark@r{, in rectangle-mark-mode} @kindex C-x C-x@r{, in rectangle-mark-mode} -When the region is in rectangle-mark-mode, @kbd{C-x C-x} runs the -command @code{rectangle-exchange-point-and-mark}, which cycles between -the four corners of the region-rectangle. This comes in handy if you -want to modify the dimensions of the region-rectangle before invoking -an operation on the marked text. +When the region is active (@pxref{Mark}) and in rectangle-mark-mode, +@kbd{C-x C-x} runs the command +@code{rectangle-exchange-point-and-mark}, which cycles between the +four corners of the region-rectangle. This comes in handy if you want +to modify the dimensions of the region-rectangle before invoking an +operation on the marked text. @node CUA Bindings @section CUA Bindings diff --git a/lisp/rect.el b/lisp/rect.el index d288adfbaf6..80f992e182f 100644 --- a/lisp/rect.el +++ b/lisp/rect.el @@ -651,7 +651,8 @@ with a prefix argument, prompt for START-AT and FORMAT." (define-minor-mode rectangle-mark-mode "Toggle the region as rectangular. -Activates the region if needed. Only lasts until the region is deactivated." +Activates the region if it's inactive and Transient Mark mode is +on. Only lasts until the region is next deactivated." :lighter nil (rectangle--reset-crutches) (when rectangle-mark-mode |