switch-to-buffer's docstring needs beefing up

[Dan Jacobson]

>>>>> "Eli" == Eli Zaretskii <eliz@is.elta.co.il> writes:

>> enlarge-window's help info makes no mention of what happens if one
>> doesn't give ARG:

Eli> The same is true with forward-char, next-line, and a gazillion of
Eli> other commands which take the argument as a repeat count: if the
Eli> argument is not given, it defaults to one.

Eli> But I added that to the doc string anyway (you failed to mention
Eli> shrink-window, btw).

Here's a good one:
----------------
C-x b runs the command switch-to-buffer
   which is an interactive built-in function.

Select buffer BUFFER in the current window.
BUFFER may be a buffer or a buffer name.
Optional second arg NORECORD non-nil means
do not put this buffer at the front of the list of recently selected ones.
-----------------

No mention is made that BUFFER is indeed optional at least when
hitting C-x b RET, however it is not optional when doing
(switch-to-buffer) ... anyway, this is probably a 2-level spot where
the documentation needs to be [um, how does a vegetarian say] beefed up.

begin never-mind 666

Eli> [Still with fake address, sigh...  What will it take?]
I think it would take a "coming out party" were several of us no-spam
address people reveal our real e-mail addresses right there in usenet
>From lines at the same time :-(
-- 
http://www.geocities.com/jidanni Tel886-4-25854780 e-mail:restore .com. 積丹尼