[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-28 6f22631a63: * doc/emacs/buffers.texi (Indirect Buffers): Mentio
From: |
Stefan Monnier |
Subject: |
emacs-28 6f22631a63: * doc/emacs/buffers.texi (Indirect Buffers): Mention modification hook quirk |
Date: |
Wed, 29 Jun 2022 13:42:07 -0400 (EDT) |
branch: emacs-28
commit 6f22631a63e95c8264c5eda269e12400a1bcb9ca
Author: Stefan Monnier <monnier@iro.umontreal.ca>
Commit: Stefan Monnier <monnier@iro.umontreal.ca>
* doc/emacs/buffers.texi (Indirect Buffers): Mention modification hook quirk
---
doc/emacs/buffers.texi | 13 +++++++++++--
1 file changed, 11 insertions(+), 2 deletions(-)
diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index 8a8584689f..a1ad4926be 100644
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -616,10 +616,11 @@ select it in another window
(@code{clone-indirect-buffer-other-window}).
The text of the indirect buffer is always identical to the text of its
base buffer; changes made by editing either one are visible immediately
-in the other. But in all other respects, the indirect buffer and its
+in the other. ``Text'' here includes both the characters and their text
+properties. But in all other respects, the indirect buffer and its
base buffer are completely separate. They can have different names,
different values of point, different narrowing, different markers,
-different major modes, and different local variables.
+different overlays, different major modes, and different local variables.
An indirect buffer cannot visit a file, but its base buffer can. If
you try to save the indirect buffer, that actually works by saving the
@@ -645,6 +646,14 @@ buffer in another window. These functions run the hook
named @var{indirect-name} from a buffer @var{base-buffer}, prompting for
both using the minibuffer.
+Note: When a modification is made to the text of a buffer, the
+modification hooks are run only in the base buffer, because most of
+the functions on those hooks are not prepared to work correctly in
+indirect buffers. So if you need a modification hook function in an
+indirect buffer, you need to manually add that function to the hook
+@emph{in the base buffer} and then make the function operate in the
+desired indirect buffer.
+
@node Buffer Convenience
@section Convenience Features and Customization of Buffer Handling
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-28 6f22631a63: * doc/emacs/buffers.texi (Indirect Buffers): Mention modification hook quirk,
Stefan Monnier <=