(regexp-opt-group): Compute HALF2 properly.

[gnu-emacs] / lispref / buffers.texi

diff --git a/lispref/buffers.texi b/lispref/buffers.texi
index e97d44319928257f7b30da15721088d14fbfe763..b0c79cd28d5efc87a06242ba792ec379c6bf35aa 100644 (file)
--- a/lispref/buffers.texi
+++ b/lispref/buffers.texi
@@ -253,7 +253,8 @@ object, not a name.
 
   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.  A name starting with
+@code{buffer-menu} commands don't mention them (but if such a buffer
+visits a file, it @strong{is} mentioned).  A name starting with
 space also initially disables recording undo information; see
 @ref{Undo}.
 
@@ -335,9 +336,20 @@ produces a name not currently in use for any buffer by appending a
 number inside of @samp{<@dots{}>}.
 
 If the optional second argument @var{ignore} is non-@code{nil}, it
-should be buffer name in the sequence to be tried.  That name will be
-considered acceptable, if it is tried, even if a buffer with that name
-exists.
+should be a string; it makes a difference if it is a name in the
+sequence of names to be tried.  That name will be considered acceptable,
+if it is tried, even if a buffer with that name exists.  Thus, if
+buffers named @samp{foo}, @samp{foo<2>}, @samp{foo<3>} and @samp{foo<4>}
+exist,
+
+@example
+(generate-new-buffer-name "foo")
+     @result{} "foo<5>"
+(generate-new-buffer-name "foo" "foo<3>")
+     @result{} "foo<3>"
+(generate-new-buffer-name "foo" "foo<6>")
+     @result{} "foo<5>"
+@end example
 
 See the related function @code{generate-new-buffer} in @ref{Creating
 Buffers}.
@@ -734,9 +746,9 @@ live buffer.
 @defun other-buffer &optional buffer visible-ok frame
 This function returns the first buffer in the buffer list other than
 @var{buffer}.  Usually this is the buffer selected most recently (in
-frame @var{frame} or else the currently selected frame), aside from
-@var{buffer}.  Buffers whose names start with a space are not considered
-at all.
+frame @var{frame} or else the currently selected frame, @pxref{Input
+Focus}), aside from @var{buffer}.  Buffers whose names start with a
+space are not considered at all.
 
 If @var{buffer} is not supplied (or if it is not a buffer), then
 @code{other-buffer} returns the first buffer in the selected frame's
@@ -889,7 +901,7 @@ returns @code{nil}.
 Any processes that have this buffer as the @code{process-buffer} are
 sent the @code{SIGHUP} signal, which normally causes them to terminate.
 (The basic meaning of @code{SIGHUP} is that a dialup line has been
-disconnected.)  @xref{Deleting Processes}.
+disconnected.)  @xref{Signals to Processes}.
 
 If the buffer is visiting a file and contains unsaved changes,
 @code{kill-buffer} asks the user to confirm before the buffer is killed.