From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Docstring for define-key Date: Mon, 24 Feb 2003 11:37:19 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <20030221083232.8366.LEKTU@terra.es> <5xd6lloqfe.fsf@kfs2.cua.dk> <200302222040.h1MKe7c14775@rum.cs.yale.edu> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1046104676 27434 80.91.224.249 (24 Feb 2003 16:37:56 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 24 Feb 2003 16:37:56 +0000 (UTC) Cc: monnier+gnu/emacs@rum.cs.yale.edu Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18nLbz-00077z-00 for ; Mon, 24 Feb 2003 17:37:51 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18nLrW-0006yb-00 for ; Mon, 24 Feb 2003 17:53:54 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18nLbt-0000fe-07 for emacs-devel@quimby.gnus.org; Mon, 24 Feb 2003 11:37:45 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18nLbd-0000eS-00 for emacs-devel@gnu.org; Mon, 24 Feb 2003 11:37:29 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18nLbb-0000dE-00 for emacs-devel@gnu.org; Mon, 24 Feb 2003 11:37:28 -0500 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18nLbT-0000b6-00 for emacs-devel@gnu.org; Mon, 24 Feb 2003 11:37:19 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.10) id 18nLbT-0002Ml-00; Mon, 24 Feb 2003 11:37:19 -0500 Original-To: "Stefan Monnier" In-reply-to: <200302222040.h1MKe7c14775@rum.cs.yale.edu> (monnier+gnu/emacs@rum.cs.yale.edu) Original-cc: lektu@terra.es Original-cc: storm@cua.dk Original-cc: emacs-devel@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:11917 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:11917 > The first line should mention all the important arguments of the > function, and should mention them in the order that they are written > in a function call. Why "in the order" ? To ease the work of the programmer reading it. To have to reorder the args for the code is extra work and a source of mistakes.