diff lispref/buffers.texi @ 27301:8c79b30d8475

*** empty log message ***
author Richard M. Stallman <rms@gnu.org>
date Wed, 12 Jan 2000 05:22:30 +0000
parents 89afca54a135
children f242022750ee
line wrap: on
line diff
--- a/lispref/buffers.texi	Wed Jan 12 03:08:29 2000 +0000
+++ b/lispref/buffers.texi	Wed Jan 12 05:22:30 2000 +0000
@@ -335,9 +335,20 @@
 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}.