summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorŠtěpán Němec <stepnem@gmail.com>2020-03-31 05:38:50 +0200
committerŠtěpán Němec <stepnem@gmail.com>2020-04-13 12:15:13 +0200
commitf84aed5fd233d59196d942acfb67bb4051c69cf1 (patch)
tree6a096f13faea8904b23e0e975d77d3cae754bfa4 /src
parent81d07da788e7caea266f4a520cd9922c990d04e9 (diff)
downloademacs-f84aed5fd233d59196d942acfb67bb4051c69cf1.tar.gz
Clarify documentation on inhibit-modification-hooks intended usage
Cf. bug#40332 and the discussion at https://lists.gnu.org/archive/html/emacs-devel/2020-03/msg00921.html * doc/lispref/text.texi (Change Hooks): * src/insdel.c (syms_of_insdel): Clarify the intended usage of 'inhibit-modification-hooks'.
Diffstat (limited to 'src')
-rw-r--r--src/insdel.c8
1 files changed, 7 insertions, 1 deletions
diff --git a/src/insdel.c b/src/insdel.c
index 21acf0e61db..dfa1cc311ca 100644
--- a/src/insdel.c
+++ b/src/insdel.c
@@ -2397,7 +2397,13 @@ This affects `before-change-functions' and `after-change-functions',
as well as hooks attached to text properties and overlays.
Setting this variable non-nil also inhibits file locks and checks
whether files are locked by another Emacs session, as well as
-handling of the active region per `select-active-regions'. */);
+handling of the active region per `select-active-regions'.
+
+To delay change hooks during a series of changes, use
+`combine-change-calls' or `combine-after-change-calls' instead of
+binding this variable.
+
+See also the info node `(elisp) Change Hooks'. */);
inhibit_modification_hooks = 0;
DEFSYM (Qinhibit_modification_hooks, "inhibit-modification-hooks");