mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 22:41:06 -08:00
Code Issues Projects Releases Wiki Activity

; More accurate documentation of 'set-mark-command'

Browse source 
* doc/emacs/mark.texi (Setting Mark, Global Mark Ring): Explain
that activating an existing mark doesn't set a new mark, and
doesn't push the mark onto the global mark ring.  (Bug#74438)
This commit is contained in:
Eli Zaretskii 2024-11-21 11:47:07 +02:00
parent 70dd5705e1
commit 4d80c4f485
1 changed files with 7 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

8
doc/emacs/mark.texi
View file

@ -112,7 +112,8 @@ to @code{set-mark-command}, so unless you are unlucky enough to have
a text terminal that behaves differently, you might as well think of a text terminal that behaves differently, you might as well think of
@kbd{C-@@} as @kbd{C-@key{SPC}}.}. This sets the mark where point is, @kbd{C-@@} as @kbd{C-@key{SPC}}.}. This sets the mark where point is,
and activates it. You can then move point away, leaving the mark and activates it. You can then move point away, leaving the mark
behind. behind. If the mark is already set where point is, this command doesn't
set another mark, but only activates the existing mark.
For example, suppose you wish to convert part of the buffer to upper For example, suppose you wish to convert part of the buffer to upper
case. To accomplish this, go to one end of the desired text, type case. To accomplish this, go to one end of the desired text, type
@ -398,6 +399,11 @@ of buffers that you have been in, and, for each buffer, a place where
you set the mark. The length of the global mark ring is controlled by you set the mark. The length of the global mark ring is controlled by
@code{global-mark-ring-max}, and is 16 by default. @code{global-mark-ring-max}, and is 16 by default.
Note that a mark is recorded in the global mark ring only when some
command sets the mark. If an existing mark is merely activated, as is
the case when you use @kbd{C-@key{SPC}} where a mark is already set
(@pxref{Setting Mark}), that doesn't push the mark onto the global ring.
@kindex C-x C-SPC @kindex C-x C-SPC
@findex pop-global-mark @findex pop-global-mark
The command @kbd{C-x C-@key{SPC}} (@code{pop-global-mark}) jumps to The command @kbd{C-x C-@key{SPC}} (@code{pop-global-mark}) jumps to