(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 3d6687382505f0aa1968635704c697b5c34a6e2b..5b9b4259a1c96081b2ddb3d95cffee78dc515308 100644 (file)
--- 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)}