[Top][All Lists]
[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
- Re: doc string of `local-variable-if-set-p', (continued)
- Re: doc string of `local-variable-if-set-p', Masatake YAMATO, 2004/10/13
- Re: doc string of `local-variable-if-set-p', Andreas Schwab, 2004/10/13
- Re: doc string of `local-variable-if-set-p', Richard Stallman, 2004/10/14
- Re: doc string of `local-variable-if-set-p', Miles Bader, 2004/10/14
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/14
- Re: doc string of `local-variable-if-set-p', Daniel Brockman, 2004/10/14
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/14
- Re: doc string of `local-variable-if-set-p',
Daniel Brockman <=
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/15
- Re: doc string of `local-variable-if-set-p', Daniel Brockman, 2004/10/15
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/15
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/13
- Re: doc string of `local-variable-if-set-p', Masatake YAMATO, 2004/10/13
- Re: doc string of `local-variable-if-set-p', Luc Teirlinck, 2004/10/13
Re: doc string of `local-variable-if-set-p', Richard Stallman, 2004/10/14