From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: CL function's docstrings Date: Wed, 18 May 2005 14:13:35 +0200 Message-ID: References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1116434935 27282 80.91.229.2 (18 May 2005 16:48:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 18 May 2005 16:48:55 +0000 (UTC) Cc: Juanma Barranquero , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed May 18 18:48:41 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DYRhw-0001cp-Li for ged-emacs-devel@m.gmane.org; Wed, 18 May 2005 18:47:44 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DYRjt-0003Aa-P7 for ged-emacs-devel@m.gmane.org; Wed, 18 May 2005 12:49:45 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DYNSh-000671-MQ for emacs-devel@gnu.org; Wed, 18 May 2005 08:15:44 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DYNSg-00066e-F5 for emacs-devel@gnu.org; Wed, 18 May 2005 08:15:42 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DYNSe-000652-Tr for emacs-devel@gnu.org; Wed, 18 May 2005 08:15:41 -0400 Original-Received: from [212.88.64.25] (helo=mail-relay.sonofon.dk) by monty-python.gnu.org with smtp (Exim 4.34) id 1DYNYU-0002aA-NW for emacs-devel@gnu.org; Wed, 18 May 2005 08:21:43 -0400 Original-Received: (qmail 83242 invoked from network); 18 May 2005 12:13:26 -0000 Original-Received: from unknown (HELO kfs-l.imdomain.dk.cua.dk) (213.83.150.2) by 0 with SMTP; 18 May 2005 12:13:26 -0000 Original-To: Stefan Monnier In-Reply-To: (Stefan Monnier's message of "Tue, 17 May 2005 17:15:59 -0400") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) 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: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:37268 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:37268 Stefan Monnier writes: >> 2) Change the argument names to match the docstrings. >> Pros: it is the cleaner way. >> Cons: lot of change in the cl* files; less coherence between argument >> names among functions. > > Thanks to the wonders of dynamic scoping this actually changes the > semantics subtly. In most cases you'll never be able to tell the > difference, but when higer-order functions are involved it can be a problem; > so if you do that, be careful. And do _not_ do it before the release! -- Kim F. Storm http://www.cua.dk