display-buffer-other-frame - useful? doc string?

["Drew Adams" <drew.adams@oracle.com>]

Is the command `display-buffer-other-frame' useful as it is currently
designed? It displays a buffer in another frame, but it also lowers
that frame among all window-manager windows. Even if the buffer was
already displayed in another frame, that frame is still lowered behind
all others.
 
That hardly seems like TRT. If you ask to display a buffer, you don't
want it to be buried out of sight behind all other window-manager
windows.
 
Aside from the question of its usefulness, I wonder about its doc
string. The first line of the doc string is identical to the first
line of the doc string of `switch-to-buffer-other-frame': "Switch to
buffer BUFFER in another frame." 
 
But `display-buffer-other-frame' does *not* switch to the buffer (it
does not select it); it simply displays it (in a not-very-visible
fashion). Contrast that with the doc string of `display-buffer', whose
first line explicitly says that the buffer is not selected: "Make
BUFFER appear in some window but don't select it."
 
Command `display-buffer-other-frame' is not documented in any manual -
perhaps for good reason. It seems half-baked, to me.
 

In GNU Emacs 22.1.90.1 (i386-mingw-nt5.1.2600)
 of 2008-01-30 on PRETEST
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'