/[emacs]/emacs/lispref/buffers.texi
ViewVC logotype

Diff of /emacs/lispref/buffers.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.24.2.1 by miles, Fri Apr 4 06:20:41 2003 UTC revision 1.24.2.2 by miles, Tue Oct 14 23:10:11 2003 UTC
# Line 106  Emacs reads a command is the buffer that Line 106  Emacs reads a command is the buffer that
106  switch visibly to a different buffer so that the user can edit it.  For  switch visibly to a different buffer so that the user can edit it.  For
107  that, you must use the functions described in @ref{Displaying Buffers}.  that, you must use the functions described in @ref{Displaying Buffers}.
108    
109    @strong{Note:} Lisp functions that change to a different current buffer    @strong{Warning:} Lisp functions that change to a different current buffer
110  should not depend on the command loop to set it back afterwards.  should not depend on the command loop to set it back afterwards.
111  Editing commands written in Emacs Lisp can be called from other programs  Editing commands written in Emacs Lisp can be called from other programs
112  as well as from the command loop; it is convenient for the caller if  as well as from the command loop; it is convenient for the caller if
# Line 444  such buffer in the buffer list. Line 444  such buffer in the buffer list.
444  If @var{filename} is a non-empty string, this function changes the  If @var{filename} is a non-empty string, this function changes the
445  name of the file visited in the current buffer to @var{filename}.  (If the  name of the file visited in the current buffer to @var{filename}.  (If the
446  buffer had no visited file, this gives it one.)  The @emph{next time}  buffer had no visited file, this gives it one.)  The @emph{next time}
447  the buffer is saved it will go in the newly-specified file.  This  the buffer is saved it will go in the newly-specified file.
448  command marks the buffer as modified, since it does not (as far as Emacs  
449  knows) match the contents of @var{filename}, even if it matched the  This command marks the buffer as modified, since it does not (as far
450  former visited file.  as Emacs knows) match the contents of @var{filename}, even if it
451    matched the former visited file.  It also renames the buffer to
452    correspond to the new file name, unless the new name is already in
453    use.
454    
455  If @var{filename} is @code{nil} or the empty string, that stands for  If @var{filename} is @code{nil} or the empty string, that stands for
456  ``no visited file''.  In this case, @code{set-visited-file-name} marks  ``no visited file''.  In this case, @code{set-visited-file-name} marks
# Line 678  signal an error if the current buffer is Line 681  signal an error if the current buffer is
681  @cindex buffer list  @cindex buffer list
682    
683    The @dfn{buffer list} is a list of all live buffers.  Creating a    The @dfn{buffer list} is a list of all live buffers.  Creating a
684  buffer adds it to this list, and killing a buffer excises it.  The order  buffer adds it to this list, and killing a buffer removes it.  The
685  of the buffers in the list is based primarily on how recently each  order of the buffers in the list is based primarily on how recently
686  buffer has been displayed in the selected window.  Buffers move to the  each buffer has been displayed in the selected window.  Buffers move
687  front of the list when they are selected and to the end when they are  to the front of the list when they are selected (selecting a window
688  buried (see @code{bury-buffer}, below).  Several functions, notably  that already displays the buffer counts as selecting the buffer), and
689  @code{other-buffer}, use this ordering.  A buffer list displayed for the  to the end when they are buried (see @code{bury-buffer}, below).
690  user also follows this order.  Several functions, notably @code{other-buffer}, use this ordering.  A
691    buffer list displayed for the user also follows this order.
692    
693    In addition to the fundamental Emacs buffer list, each frame has its    In addition to the fundamental Emacs buffer list, each frame has its
694  own version of the buffer list, in which the buffers that have been  own version of the buffer list, in which the buffers that have been
# Line 937  ask for confirmation from the user.  If Line 941  ask for confirmation from the user.  If
941  This is a normal hook run by @code{kill-buffer} after asking all the  This is a normal hook run by @code{kill-buffer} after asking all the
942  questions it is going to ask, just before actually killing the buffer.  questions it is going to ask, just before actually killing the buffer.
943  The buffer to be killed is current when the hook functions run.  The buffer to be killed is current when the hook functions run.
944  @xref{Hooks}.  @xref{Hooks}.  This variable is a permanent local, so its local binding
945    is not cleared by changing major modes.
946  @end defvar  @end defvar
947    
948  @defvar buffer-offer-save  @defvar buffer-offer-save
# Line 1016  This function returns the current gap po Line 1021  This function returns the current gap po
1021  @defun gap-size  @defun gap-size
1022  This function returns the current gap size of the current buffer.  This function returns the current gap size of the current buffer.
1023  @end defun  @end defun
1024    
1025    @ignore
1026       arch-tag: 2e53cfab-5691-41f6-b5a8-9c6a3462399c
1027    @end ignore

Legend:
Removed from v.1.24.2.1  
changed lines
  Added in v.1.24.2.2

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26