From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Daniel Brockman Newsgroups: gmane.emacs.devel Subject: Re: doc string of `local-variable-if-set-p' Date: Fri, 15 Oct 2004 05:12:07 +0200 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <87d5zkn08o.fsf@wigwam.deepwood.net> References: <20041014.014802.38725803.jet@gyve.org> <20041014.022254.179728295.jet@gyve.org> <200410150152.i9F1qO112604@raven.dms.auburn.edu> <87mzyon2zp.fsf@wigwam.deepwood.net> <200410150240.i9F2eQ412694@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1097809943 6874 80.91.229.6 (15 Oct 2004 03:12:23 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 15 Oct 2004 03:12:23 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 15 05:12:14 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CIIVp-0002wy-00 for ; Fri, 15 Oct 2004 05:12:14 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CIIcx-0006Bk-70 for ged-emacs-devel@m.gmane.org; Thu, 14 Oct 2004 23:19:35 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CIIcp-0006Be-53 for emacs-devel@gnu.org; Thu, 14 Oct 2004 23:19:27 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CIIco-0006BM-D6 for emacs-devel@gnu.org; Thu, 14 Oct 2004 23:19:26 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CIIco-0006B1-5x for emacs-devel@gnu.org; Thu, 14 Oct 2004 23:19:26 -0400 Original-Received: from [80.91.229.2] (helo=main.gmane.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CIIVO-00067B-5Z for emacs-devel@gnu.org; Thu, 14 Oct 2004 23:11:46 -0400 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 1CIIVN-0001fD-00 for ; Fri, 15 Oct 2004 05:11:45 +0200 Original-Received: from c-4db670d5.028-10-67766c2.cust.bredbandsbolaget.se ([213.112.182.77]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 15 Oct 2004 05:11:45 +0200 Original-Received: from drlion by c-4db670d5.028-10-67766c2.cust.bredbandsbolaget.se with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 15 Oct 2004 05:11:45 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-To: emacs-devel@gnu.org Original-Lines: 24 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: c-4db670d5.028-10-67766c2.cust.bredbandsbolaget.se X-Face: :&2UWGm>e24)ip~'K@iOsA&JT3JX*v@1-#L)=dUb825\Fwg#`^N!Y*g-TqdS AevzjFJe96f@V'ya8${57/T'"mTd`1o{TGYhHnVucLq!D$r2O{IN)7>.0op_Y`%r;/Q +(]`3F-t10N7NF\.Mm0q}p1:%iqTi:5]1E]rDF)R$9.!,Eu'9K':y9^U3F8UCS1M+A$ 8[[[WT^`$P[vu>P+8]aQMh9giu&fPCqLW2FSsGs User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/21.3.50 (gnu/linux) Cancel-Lock: sha1:WCPFYJeej9O6De92ltY+QcIquzw= X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:28411 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28411 Luc Teirlinck 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