Mercurial > emacs
diff lispref/buffers.texi @ 22138:d4ac295a98b3
*** empty log message ***
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Tue, 19 May 1998 03:45:57 +0000 |
parents | 90da2489c498 |
children | 40089afa2b1d |
line wrap: on
line diff
--- a/lispref/buffers.texi Tue May 19 03:41:25 1998 +0000 +++ b/lispref/buffers.texi Tue May 19 03:45:57 1998 +0000 @@ -47,9 +47,9 @@ Buffers in Emacs editing are objects that have distinct names and hold text that can be edited. Buffers appear to Lisp programs as a special -data type. You can think of the contents of a buffer as an extendable -string; insertions and deletions may occur in any part of the buffer. -@xref{Text}. +data type. You can think of the contents of a buffer as a string that +you can extend; insertions and deletions may occur in any part of the +buffer. @xref{Text}. A Lisp buffer object contains numerous pieces of information. Some of this information is directly accessible to the programmer through @@ -112,7 +112,7 @@ course, that is the subroutine's purpose). Therefore, you should normally use @code{set-buffer} within a @code{save-current-buffer} or @code{save-excursion} (@pxref{Excursions}) form that will restore the -current buffer when your function is done . Here is an example, the +current buffer when your function is done. Here is an example, the code for the command @code{append-to-buffer} (with the documentation string abridged): @@ -201,8 +201,8 @@ existing buffer. @end defun +@defspec save-current-buffer body... @tindex save-current-buffer -@defmac save-current-buffer body... The @code{save-current-buffer} macro saves the identity of the current buffer, evaluates the @var{body} forms, and finally restores that buffer as current. The return value is the value of the last form in @@ -215,8 +215,8 @@ remains current. @end defmac +@defmac with-current-buffer buffer body... @tindex with-current-buffer -@defmac with-current-buffer buffer body... The @code{with-current-buffer} macro saves the identity of the current buffer, makes @var{buffer} current, evaluates the @var{body} forms, and finally restores the buffer. The return value is the value of the last @@ -224,8 +224,8 @@ abnormal exit via @code{throw} or error (@pxref{Nonlocal Exits}). @end defmac +@defmac with-temp-buffer body... @tindex with-temp-buffer -@defmac with-temp-buffer body... 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,