From a28e4607f0c5c5812a87dd816559d1601ed146ba Mon Sep 17 00:00:00 2001 From: Lars Magne Ingebrigtsen Date: Thu, 14 Jul 2011 01:40:11 +0200 Subject: [PATCH] Doc fix for with-silent-modifications * subr.el (with-silent-modifications): Clarify somewhat what the macro inhibits. Fixes: debbugs:6525 --- lisp/ChangeLog | 3 +++ lisp/subr.el | 11 +++++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/lisp/ChangeLog b/lisp/ChangeLog index 71faf19b621..b78a6a4c580 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,5 +1,8 @@ 2011-07-13 Lars Magne Ingebrigtsen + * subr.el (with-silent-modifications): Clarify somewhat what the + macro inhibits (bug#6525). + * simple.el (eval-expression): Note what it does if called interactively (bug#6495). diff --git a/lisp/subr.el b/lisp/subr.el index a2f560461eb..5c890eefa29 100644 --- a/lisp/subr.el +++ b/lisp/subr.el @@ -3072,8 +3072,15 @@ See also `with-temp-file' and `with-output-to-string'." "Execute BODY, pretending it does not modify the buffer. If BODY performs real modifications to the buffer's text, other than cosmetic ones, undo data may become corrupted. -Typically used around modifications of text-properties which do not really -affect the buffer's content." + +This macro will run BODY normally, but doesn't count its buffer +modifications as being buffer modifications. This affects things +like buffer-modified-p, checking whether the file is locked by +someone else, running buffer modification hooks, and other things +of that nature. + +Typically used around modifications of text-properties which do +not really affect the buffer's content." (declare (debug t) (indent 0)) (let ((modified (make-symbol "modified"))) `(let* ((,modified (buffer-modified-p)) -- 2.39.2