[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 22a9a20513: Merge from origin/emacs-28
From: |
Stefan Kangas |
Subject: |
master 22a9a20513: Merge from origin/emacs-28 |
Date: |
Wed, 29 Dec 2021 00:51:53 -0500 (EST) |
branch: master
commit 22a9a205137f404863451c7dc43c15d2ef396325
Merge: 8419011ceb 06dcd2be5d
Author: Stefan Kangas <stefan@marxist.se>
Commit: Stefan Kangas <stefan@marxist.se>
Merge from origin/emacs-28
06dcd2be5d Improve rectangle-mark-mode documentation regarding mark a...
---
doc/emacs/killing.texi | 16 +++++++++++-----
lisp/rect.el | 3 ++-
2 files changed, 13 insertions(+), 6 deletions(-)
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 375ac970d7..3815c0fef6 100644
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -929,6 +929,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
@@ -937,11 +942,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 d288adfbaf..80f992e182 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