[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-25 9722ae1 54/64: with-silent-modifications doc clar
From: |
Lars Ingebrigtsen |
Subject: |
[Emacs-diffs] emacs-25 9722ae1 54/64: with-silent-modifications doc clarification |
Date: |
Sun, 01 May 2016 18:18:42 +0000 |
branch: emacs-25
commit 9722ae18c3aa7243185fb005241f337712ac0ac5
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>
with-silent-modifications doc clarification
* lisp/subr.el (with-silent-modifications): Rearrange the doc
string a bit so that the most pertinent information is at the
top (bug#21171).
(cherry picked from commit e0e70f030e69d9696a963a86f5f7caaff4df06eb)
---
lisp/subr.el | 7 +++----
1 file changed, 3 insertions(+), 4 deletions(-)
diff --git a/lisp/subr.el b/lisp/subr.el
index 23e7d01..3f5d6e4 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3291,6 +3291,8 @@ See also `with-temp-file' and `with-output-to-string'."
(defmacro with-silent-modifications (&rest body)
"Execute BODY, pretending it does not modify the buffer.
+This macro is Typically used around modifications of
+text-properties which do not really affect the buffer's content.
If BODY performs real modifications to the buffer's text, other
than cosmetic ones, undo data may become corrupted.
@@ -3298,10 +3300,7 @@ 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."
+of that nature."
(declare (debug t) (indent 0))
(let ((modified (make-symbol "modified")))
`(let* ((,modified (buffer-modified-p))
- [Emacs-diffs] emacs-25 925af7e 27/64: Fill the doc string of font-lock-keywords, (continued)
- [Emacs-diffs] emacs-25 925af7e 27/64: Fill the doc string of font-lock-keywords, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 6d8c2d0 49/64: custom-buffer-style doc fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 3cbc1e3 07/64: Change all occurrences of "Mouse-[0-9]" to "mouse-[0-9]", Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 25b4cf3 56/64: Describe WHEN in all the define-obsolete- macros, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 9f27bcf 60/64: isearch-search-fun-function doc tweak, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 3bc26a7 53/64: clear-visited-file-modtime doc string fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 afb2257 46/64: completion-table-with-predicate doc string fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 d1ab001 58/64: Fmarker_position doc string clarification, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 ef32be6 48/64: Rearrange the doc of query-replace slightly, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 f3f4502 45/64: Fill the completion-table-with-predicate doc string, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 9722ae1 54/64: with-silent-modifications doc clarification,
Lars Ingebrigtsen <=
- [Emacs-diffs] emacs-25 78ae805 59/64: Fill some imenu--index-alist doc lines, Lars Ingebrigtsen, 2016/05/01