[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 4be6c92 5/6: Merge from origin/emacs-27
From: |
Glenn Morris |
Subject: |
master 4be6c92 5/6: Merge from origin/emacs-27 |
Date: |
Wed, 27 Jan 2021 10:55:17 -0500 (EST) |
branch: master
commit 4be6c9215bdc5c6856e6d1b2c445f4a268a6f2be
Merge: 27889f0 3443a1c
Author: Glenn Morris <rgm@gnu.org>
Commit: Glenn Morris <rgm@gnu.org>
Merge from origin/emacs-27
3443a1c698 Fix last change
---
doc/lispref/text.texi | 17 +++++++++++++++--
1 file changed, 15 insertions(+), 2 deletions(-)
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 14854a5..b367346 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -1441,6 +1441,11 @@ the @code{amalgamating-undo-limit} variable. If this
variable is 1,
no changes are amalgamated.
@end defun
+A Lisp program can amalgamate a series of changes into a single change
+group by calling @code{undo-amalgamate-change-group} (@pxref{Atomic
+Changes}). Note that @code{amalgamating-undo-limit} has no effect on
+the groups produced by that function.
+
@defvar undo-auto-current-boundary-timer
Some buffers, such as process buffers, can change even when no
commands are executing. In these cases, @code{undo-boundary} is
@@ -5629,9 +5634,17 @@ This function cancels and undoes all the changes in the
change group
specified by @var{handle}.
@end defun
+ You can cause some or all of the changes in a change group to be
+considered as a single unit for the purposes of the @code{undo}
+commands (@pxref{Undo}) by using @code{undo-amalgamate-change-group}.
+
@defun undo-amalgamate-change-group
-Amalgamate changes in change-group since @var{handle}. I.e., remove
-all undo boundaries between the state of @var{handle} and now.
+Amalgamate all the changes made in the change-group since the state
+identified by @var{handle}. This function removes all undo boundaries
+between undo records of changes since the state described by
+@var{handle}. Usually, @var{handle} is the handle returned by
+@code{prepare-change-group}, in which case all the changes since the
+beginning of the change-group are amalgamated into a single undo unit.
@end defun
Your code should use @code{unwind-protect} to make sure the group is
- master updated (ff03411 -> 7c257e2), Glenn Morris, 2021/01/27
- master 27889f0 4/6: ; Merge from origin/emacs-27, Glenn Morris, 2021/01/27
- master 4be6c92 5/6: Merge from origin/emacs-27,
Glenn Morris <=
- master 588d230 1/6: Merge from origin/emacs-27, Glenn Morris, 2021/01/27
- master 0ca75f1 3/6: Merge from origin/emacs-27, Glenn Morris, 2021/01/27
- master 5597398 2/6: ; Merge from origin/emacs-27, Glenn Morris, 2021/01/27
- master 7c257e2 6/6: ; Merge from origin/emacs-27, Glenn Morris, 2021/01/27