[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-26 a5f718c: ; * doc/lispref/text.texi (Change Hooks)
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-26 a5f718c: ; * doc/lispref/text.texi (Change Hooks): Fix last change. |
Date: |
Sat, 6 Jan 2018 14:44:04 -0500 (EST) |
branch: emacs-26
commit a5f718c4c58c821fb121196a499df01391bb7ba4
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
; * doc/lispref/text.texi (Change Hooks): Fix last change.
---
doc/lispref/text.texi | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index cd64447..a004952 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -5023,21 +5023,21 @@ these functions, and neither do certain internal buffer
changes, such
as changes in buffers created by Emacs internally for certain jobs,
that should not be visible to Lisp programs.
-The vast bulk of buffer changing primitives will call
+The vast majority of buffer changing primitives will call
@code{before-change-functions} and @code{after-change-functions} in
balanced pairs, once for each change, where the arguments to these
hooks exactly delimit the change being made. Yet, hook functions
-should not rely on this always being the case:
-
-Other, complex primitives call @code{before-change-functions} once
-before making changes, and then call @code{after-change-functions}
-zero, one, or several times, depending on how many individual changes
-the primitive is making. The arguments to
+should not rely on this always being the case, because some complex
+primitives call @code{before-change-functions} once before making
+changes, and then call @code{after-change-functions} zero or more
+times, depending on how many individual changes the primitive is
+making. When that happens, the arguments to
@code{before-change-functions} will enclose a region in which the
individual changes are made, but won't necessarily be the minimal such
-region. The arguments to each successive call of
address@hidden will then delimit the current part of
-the change exactly.
+region, and the arguments to each successive call of
address@hidden will then delimit the part of text being
+changed exactly. In general, we advise to use either before- or the
+after-change hooks, but not both.
@defmac combine-after-change-calls address@hidden
The macro executes @var{body} normally, but arranges to call the
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-26 a5f718c: ; * doc/lispref/text.texi (Change Hooks): Fix last change.,
Eli Zaretskii <=