From: Luc Teirlinck <teirllm@auburn.edu>
Date: Sun, 11 Jul 2004 02:18:15 +0000 (+0000)
Subject: (switch-to-buffer-other-window): Doc fix.
X-Git-Tag: ttn-vms-21-2-B4~5509
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=839857c7bdeab1cfc27f10245a7ef28d9e639e3d;p=emacs.git

(switch-to-buffer-other-window): Doc fix.
---

diff --git a/lisp/files.el b/lisp/files.el
index 301a3f48f15..da1e7128a94 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -869,8 +869,15 @@ use with M-x."
 
 (defun switch-to-buffer-other-window (buffer &optional norecord)
   "Select buffer BUFFER in another window.
+If BUFFER does not identify an existing buffer, then this function
+creates a buffer with that name.
+
+When called from Lisp, BUFFER can be a buffer, a string \(a buffer name),
+or nil.  If BUFFER is nil, then this function chooses a buffer
+using `other-buffer'.
 Optional second arg NORECORD non-nil means
 do not put this buffer at the front of the list of recently selected ones.
+This function returns the buffer it switched to.
 
 This uses the function `display-buffer' as a subroutine; see its
 documentation for additional customization information."