Document binding `deactivate-mark' around something that modifies the

buffer so as to keep the mark active.

diff --git a/lispref/markers.texi b/lispref/markers.texi
index e18e987bf22cebd7d2d72764467ec5935a051b77..508955e39df76d2373f7896207401879452ed7c6 100644 (file)
--- a/lispref/markers.texi
+++ b/lispref/markers.texi
@@ -558,6 +558,16 @@ command loop deactivates the mark after the command returns (if
 Transient Mark mode is enabled).  All the primitives that change the
 buffer set @code{deactivate-mark}, to deactivate the mark when the
 command is finished.
+
+To write Lisp code that modifies the buffer without causing
+deactivation of the mark at the end of the command, bind
+@code{deactivate-mark} to @code{nil} around the code that does the
+modification.  For example:
+
+@example
+(let (deactivate-mark)
+  (insert " "))
+@end example
 @end defvar
 
 @defun deactivate-mark