Re: doc string of `local-variable-if-set-p'

[Daniel Brockman <drlion@deepwood.net>]

Luc Teirlinck <teirllm@dms.auburn.edu> writes:

> Daniel Brockman wrote;
>
>    I don't see why the word ``buffer'' needs to be doubled.  The
>    following reads better and is shorter:
>
>       Non-nil if VARIABLE will be local in BUFFER when set there.
>
> BUFFER _must_ be a buffer however.  (In similar functions you can
> often also use a buffer name.  Not here.)

Ah, I didn't realize that.

Still, I think that's a detail that belongs somewhere after the
space-constrained first line.  Just doubling the word ``buffer'' isn't
going to make it clear that a buffer *name* won't do, so you might as
well spell it out clearly in the long description.

Or am I missing some long-established Emacs documentation convention?

-- 
Daniel Brockman
drlion@deepwood.net