From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: CL function's docstrings Date: Tue, 17 May 2005 17:15:59 -0400 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 1116416728 19815 80.91.229.2 (18 May 2005 11:45:28 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 18 May 2005 11:45:28 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed May 18 13:45:25 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DYMyT-0000Hv-Hz for ged-emacs-devel@m.gmane.org; Wed, 18 May 2005 13:44:30 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DYN0t-0003sW-28 for ged-emacs-devel@m.gmane.org; Wed, 18 May 2005 07:46:59 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DYBQ4-0005cH-Mn for emacs-devel@gnu.org; Tue, 17 May 2005 19:24:13 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DYBQ0-0005Z4-0t for emacs-devel@gnu.org; Tue, 17 May 2005 19:24:09 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DYBPy-0005XD-Rw for emacs-devel@gnu.org; Tue, 17 May 2005 19:24:06 -0400 Original-Received: from [199.232.41.67] (helo=mx20.gnu.org) by monty-python.gnu.org with esmtp (TLS-1.0:RSA_ARCFOUR_SHA:16) (Exim 4.34) id 1DYBVI-00029E-My for emacs-devel@gnu.org; Tue, 17 May 2005 19:29:36 -0400 Original-Received: from [132.204.24.67] (helo=mercure.iro.umontreal.ca) by mx20.gnu.org with esmtp (Exim 4.34) id 1DY9Q7-0007rK-Mh for emacs-devel@gnu.org; Tue, 17 May 2005 17:16:07 -0400 Original-Received: from hidalgo.iro.umontreal.ca (hidalgo.iro.umontreal.ca [132.204.27.50]) by mercure.iro.umontreal.ca (Postfix) with ESMTP id 978DD2CEA9E; Tue, 17 May 2005 17:16:06 -0400 (EDT) Original-Received: from asado.iro.umontreal.ca (asado.iro.umontreal.ca [132.204.24.84]) by hidalgo.iro.umontreal.ca (Postfix) with ESMTP id 785284AC00E; Tue, 17 May 2005 17:15:59 -0400 (EDT) Original-Received: by asado.iro.umontreal.ca (Postfix, from userid 20848) id 60F04F69C4; Tue, 17 May 2005 17:15:59 -0400 (EDT) Original-To: Juanma Barranquero In-Reply-To: (Juanma Barranquero's message of "Tue, 17 May 2005 01:52:06 +0200") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) X-DIRO-MailScanner-Information: Please contact the ISP for more information X-DIRO-MailScanner: Found to be clean X-DIRO-MailScanner-SpamCheck: n'est pas un polluriel, SpamAssassin (score=-4.841, requis 5, autolearn=not spam, AWL 0.06, BAYES_00 -4.90) X-MailScanner-From: monnier@iro.umontreal.ca 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:37243 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:37243 > 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. Stefan