From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Wed, 13 Jul 2011 23:40:11 +0000 (+0200)
Subject: Doc fix for with-silent-modifications
X-Git-Tag: emacs-pretest-24.0.90~104^2~300
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a28e4607f0c5c5812a87dd816559d1601ed146ba;p=emacs.git

Doc fix for with-silent-modifications

* subr.el (with-silent-modifications): Clarify somewhat what the
macro inhibits.

Fixes: debbugs:6525
---

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  <larsi@gnus.org>
 
+	* 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))