emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Daniel Brockman
Subject: Re: doc string of `local-variable-if-set-p'
Date: Fri, 15 Oct 2004 05:12:07 +0200
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/21.3.50 (gnu/linux)

Luc Teirlinck <address@hidden> 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
address@hidden





reply via email to

[Prev in Thread] Current Thread [Next in Thread]