From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 3 Jul 2005 16:38:17 +0000 (+0000)
Subject: (Special Properties): Change hook functions should bind
X-Git-Tag: emacs-pretest-22.0.90~8487
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=fbbad95fff0641e56337e0eca56b4f46d3f07e47;p=emacs.git

(Special Properties): Change hook functions should bind
inhibit-modification-hooks around altering buffer text.
---

diff --git a/lispref/text.texi b/lispref/text.texi
index 3d668738250..5b9b4259a1c 100644
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -3152,6 +3152,10 @@ particular modification hook function appears on several characters
 being modified by a single primitive, you can't predict how many times
 the function will be called.
 
+If these functions modify the buffer, they should bind
+@code{inhibit-modification-hooks} to @code{t} around doing so, to
+avoid confusing the internal mechanism that calls these hooks.
+
 @item insert-in-front-hooks
 @itemx insert-behind-hooks
 @kindex insert-in-front-hooks @r{(text property)}