[Emacs-diffs] /srv/bzr/emacs/trunk r105183: Doc fix for with-silent-modifications

[Lars Magne Ingebrigtsen]

------------------------------------------------------------
revno: 105183
fixes bug(s): http://debbugs.gnu.org/6525
committer: Lars Magne Ingebrigtsen <address@hidden>
branch nick: trunk
timestamp: Thu 2011-07-14 01:40:11 +0200
message:
  Doc fix for with-silent-modifications
  
  * subr.el (with-silent-modifications): Clarify somewhat what the
  macro inhibits.
modified:
  lisp/ChangeLog
  lisp/subr.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-07-13 23:35:36 +0000
+++ b/lisp/ChangeLog    2011-07-13 23:40:11 +0000
@@ -1,5 +1,8 @@
 2011-07-13  Lars Magne Ingebrigtsen  <address@hidden>
 
+       * 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).
 

=== modified file 'lisp/subr.el'
--- a/lisp/subr.el      2011-07-13 21:38:56 +0000
+++ b/lisp/subr.el      2011-07-13 23:40:11 +0000
@@ -3072,8 +3072,15 @@
   "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))