mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-14 23:40:39 -08:00
Code Issues Projects Releases Wiki Activity

Improve rectangle-mark-mode documentation regarding mark activation

Browse source 
* 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)
This commit is contained in:
Sean Whitton 2021-12-27 12:58:25 -07:00 • committed by Eli Zaretskii
parent c0815aca18
commit 06dcd2be5d
2 changed files with 13 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/emacs/killing.texi
View file

@ -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 rectangle. @xref{Killing}. The mode persists only as long as the
region is active. 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 Unlike the standard region, the region-rectangle can have its corners
extended past the end of buffer, or inside stretches of white space extended past the end of buffer, or inside stretches of white space
that point normally cannot enter, like in the middle of a TAB that point normally cannot enter, like in the middle of a TAB
@ -929,11 +934,12 @@ character.
@findex rectangle-exchange-point-and-mark @findex rectangle-exchange-point-and-mark
@findex exchange-point-and-mark@r{, in rectangle-mark-mode} @findex exchange-point-and-mark@r{, in rectangle-mark-mode}
@kindex C-x C-x@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 When the region is active (@pxref{Mark}) and in rectangle-mark-mode,
command @code{rectangle-exchange-point-and-mark}, which cycles between @kbd{C-x C-x} runs the command
the four corners of the region-rectangle. This comes in handy if you @code{rectangle-exchange-point-and-mark}, which cycles between the
want to modify the dimensions of the region-rectangle before invoking four corners of the region-rectangle. This comes in handy if you want
an operation on the marked text. to modify the dimensions of the region-rectangle before invoking an
operation on the marked text.
@node CUA Bindings @node CUA Bindings
@section CUA Bindings @section CUA Bindings

3
lisp/rect.el
View file

@ -651,7 +651,8 @@ with a prefix argument, prompt for START-AT and FORMAT."
(define-minor-mode rectangle-mark-mode (define-minor-mode rectangle-mark-mode
"Toggle the region as rectangular. "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 :lighter nil
(rectangle--reset-crutches) (rectangle--reset-crutches)
(when rectangle-mark-mode (when rectangle-mark-mode