doc string of `diff' does not mention prefix arg

doc string of `diff' does not mention prefix arg

[Drew Adams]

The doc string of command `diff' should mention that if you supply a
prefix arg you are prompted for the diff switches.  Otherwise, there
is no way to know this.  If you somehow figure out that a prefix arg
calls function `diff-switches', you still can't know what it does,
because there is no doc string for `diff-switches' - it should have a
doc string.


In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600)
 of 2007-06-02 on RELEASE
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'

Re: doc string of `diff' does not mention prefix arg

[Andreas Schwab]

"Drew Adams" <drew.adams@oracle.com> writes:

> The doc string of command `diff' should mention that if you supply a
> prefix arg you are prompted for the diff switches.

"With prefix arg, prompt for diff switches."

Copied directly from the doc string.

Andreas.

-- 
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

RE: doc string of `diff' does not mention prefix arg

[Drew Adams]

> > The doc string of command `diff' should mention that if you supply a
> > prefix arg you are prompted for the diff switches.
>
> "With prefix arg, prompt for diff switches."
>
> Copied directly from the doc string.

My bad; sorry for the noise. Thanks.

No excuse for my not seeing that, but don't we usually mention the
interactive use first? That is, wouldn't it be better to put the info about
C-u before the explanation of non-interactive arg NO-ASYNC? And to
explicitly call out that NO-ASYNC is for a non-interactive call?