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") |
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, |
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 |
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 |
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 |