summaryrefslogtreecommitdiff
path: root/lispref/buffers.texi
diff options
context:
space:
mode:
Diffstat (limited to 'lispref/buffers.texi')
-rw-r--r--lispref/buffers.texi11
1 files changed, 8 insertions, 3 deletions
diff --git a/lispref/buffers.texi b/lispref/buffers.texi
index c0eb2ee6664..55e41e6b3e5 100644
--- a/lispref/buffers.texi
+++ b/lispref/buffers.texi
@@ -233,7 +233,9 @@ The @code{with-temp-buffer} macro evaluates the @var{body} forms
with a temporary buffer as the current buffer. It saves the identity of
the current buffer, creates a temporary buffer and makes it current,
evaluates the @var{body} forms, and finally restores the previous
-current buffer while killing the temporary buffer.
+current buffer while killing the temporary buffer. By default, undo
+information (@pxref{Undo}) is not recorded in the buffer created by
+this macro (but @var{body} can enable that, if needed).
The return value is the value of the last form in @var{body}. You can
return the contents of the temporary buffer by using
@@ -257,6 +259,8 @@ sort, and an error is signaled if it is neither a string nor a buffer.
Any argument called @var{buffer} must be an actual buffer
object, not a name.
+@cindex hidden buffers
+@cindex buffers without undo information
Buffers that are ephemeral and generally uninteresting to the user
have names starting with a space, so that the @code{list-buffers} and
@code{buffer-menu} commands don't mention them (but if such a buffer
@@ -908,8 +912,9 @@ nor a buffer.
@end example
The major mode for a newly created buffer is set to Fundamental mode.
-The variable @code{default-major-mode} is handled at a higher level.
-@xref{Auto Major Mode}.
+(The variable @code{default-major-mode} is handled at a higher level;
+see @ref{Auto Major Mode}.) If the name begins with a space, the
+buffer initially disables undo information recording (@pxref{Undo}).
@end defun
@defun generate-new-buffer name