/[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.39 by rms, Mon Dec 27 19:54:59 2004 UTC revision 1.40 by rms, Thu Feb 3 06:56:24 2005 UTC
# Line 344  number inside of @samp{<@dots{}>}.  It s Line 344  number inside of @samp{<@dots{}>}.  It s
344  incrementing the number until it is not the name of an existing buffer.  incrementing the number until it is not the name of an existing buffer.
345    
346  If the optional second argument @var{ignore} is non-@code{nil}, it  If the optional second argument @var{ignore} is non-@code{nil}, it
347  should be a string; it makes a difference if it is a name in the  should be a string, a potential buffer name.  It means to consider
348  sequence of names to be tried.  That name will be considered acceptable,  that potential buffer acceptable, if it is tried, even it is the name
349  if it is tried, even if a buffer with that name exists.  Thus, if  of an existing buffer (which would normally be rejected).  Thus, if
350  buffers named @samp{foo}, @samp{foo<2>}, @samp{foo<3>} and @samp{foo<4>}  buffers named @samp{foo}, @samp{foo<2>}, @samp{foo<3>} and
351  exist,  @samp{foo<4>} exist,
352    
353  @example  @example
354  (generate-new-buffer-name "foo")  (generate-new-buffer-name "foo")
# Line 629  modification time, as a list of the form Line 629  modification time, as a list of the form
629  (This is the same format that @code{file-attributes} uses to return  (This is the same format that @code{file-attributes} uses to return
630  time values; see @ref{File Attributes}.)  time values; see @ref{File Attributes}.)
631    
632  The function returns zero if the buffer has no recorded last  If the buffer has no recorded last modification time, this function
633  modification time, which can happen, for instance, if the record has  returns zero.  This case occurs, for instance, if the buffer is not
634  been explicitly cleared by @code{clear-visited-file-modtime} or if the  visiting a file or if the time has been explicitly cleared by
635  buffer is not visiting a file.  Note, however, that  @code{clear-visited-file-modtime}.  Note, however, that
636  @code{visited-file-modtime} can return a non-zero value for some  @code{visited-file-modtime} returns a list for some non-file buffers
637  buffers that are not visiting files, but are nevertheless closely  too.  For instance, in a Dired buffer listing a directory, it returns
638  associated with a file.  This happens, for instance, with dired  the last modification time of that directory, as recorded by Dired.
 buffers listing a directory.  For such buffers,  
 @code{visited-file-modtime} returns the last modification time of that  
 directory, as recorded by dired.  
639    
640  For a new buffer visiting a not yet existing file, @var{high} is  For a new buffer visiting a not yet existing file, @var{high} is
641  @minus{}1 and @var{low} is 65535, that is,  @minus{}1 and @var{low} is 65535, that is,
# Line 857  If no suitable buffer exists, the buffer Line 854  If no suitable buffer exists, the buffer
854  This function puts @var{buffer-or-name} at the end of the buffer list,  This function puts @var{buffer-or-name} at the end of the buffer list,
855  without changing the order of any of the other buffers on the list.  without changing the order of any of the other buffers on the list.
856  This buffer therefore becomes the least desirable candidate for  This buffer therefore becomes the least desirable candidate for
857  @code{other-buffer} to return.  @code{other-buffer} to return.  The argument can be either a buffer
858    itself or the name of one.
859    
860  @code{bury-buffer} operates on each frame's @code{buffer-list} parameter  @code{bury-buffer} operates on each frame's @code{buffer-list} parameter
861  as well as the frame-independent Emacs buffer list; therefore, the  as well as the frame-independent Emacs buffer list; therefore, the
# Line 949  Names}. Line 947  Names}.
947  @cindex killing buffers  @cindex killing buffers
948  @cindex buffers, killing  @cindex buffers, killing
949    
950    @dfn{Killing a buffer} makes its name unknown to Emacs and makes its    @dfn{Killing a buffer} makes its name unknown to Emacs and makes the
951  text space available for other use.  memory space it occupied available for other use.
952    
953    The buffer object for the buffer that has been killed remains in    The buffer object for the buffer that has been killed remains in
954  existence as long as anything refers to it, but it is specially marked  existence as long as anything refers to it, but it is specially marked
# Line 1101  non-@code{nil}, the initial state is cop Line 1099  non-@code{nil}, the initial state is cop
1099  buffer, not from @var{base-buffer}.  buffer, not from @var{base-buffer}.
1100  @end deffn  @end deffn
1101    
1102    @defun clone-indirect-buffer newname display-flag &optional norecord
1103    This function creates and returns a new indirect buffer that shares
1104    the current buffer's base buffer and copies the rest of the current
1105    buffer's attributes.  (If the current buffer is not indirect, it is
1106    used as the base buffer.)
1107    
1108    If @var{display-flag} is non-@code{nil}, that means to display the new
1109    buffer by calling @code{pop-to-buffer}.  If @var{norecord} is
1110    non-@code{nil}, that means not to put the new buffer to the front of
1111    the buffer list.
1112    @end defun
1113    
1114  @defun buffer-base-buffer &optional buffer  @defun buffer-base-buffer &optional buffer
1115  This function returns the base buffer of @var{buffer}, which defaults  This function returns the base buffer of @var{buffer}, which defaults
1116  to the current buffer.  If @var{buffer} is not indirect, the value is  to the current buffer.  If @var{buffer} is not indirect, the value is

Legend:
Removed from v.1.39  
changed lines
  Added in v.1.40

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