From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Your last change to browse-url is bogus. Date: Fri, 14 Sep 2007 03:15:27 +0900 Message-ID: <87y7fajutc.fsf@uwakimon.sk.tsukuba.ac.jp> References: <87zlzs2qm1.fsf@cadilhac.name> <20070912102039.GD12104@saeurebad.de> <87ejh42mo4.fsf@cadilhac.name> <20070912.215405.160495149.mituharu@math.s.chiba-u.ac.jp> <87sl5k10yl.fsf@cadilhac.name> <87sl5jjwe8.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1189707338 15134 80.91.229.12 (13 Sep 2007 18:15:38 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 13 Sep 2007 18:15:38 +0000 (UTC) Cc: YAMAMOTO Mitsuharu , Johannes Weiner , =?iso-8859-1?Q?Micha=EBl?= Cadilhac , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Sep 13 20:15:32 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IVtDW-0001qK-0g for ged-emacs-devel@m.gmane.org; Thu, 13 Sep 2007 20:15:06 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IVtDV-0005XB-Bi for ged-emacs-devel@m.gmane.org; Thu, 13 Sep 2007 14:15:05 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IVtDS-0005WT-IQ for emacs-devel@gnu.org; Thu, 13 Sep 2007 14:15:02 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IVtDP-0005UG-RA for emacs-devel@gnu.org; Thu, 13 Sep 2007 14:15:02 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IVtDP-0005U5-LG for emacs-devel@gnu.org; Thu, 13 Sep 2007 14:14:59 -0400 Original-Received: from mtps02.sk.tsukuba.ac.jp ([130.158.97.224]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IVtDP-0005U4-85 for emacs-devel@gnu.org; Thu, 13 Sep 2007 14:14:59 -0400 Original-Received: from uwakimon.sk.tsukuba.ac.jp (unknown [130.158.99.156]) by mtps02.sk.tsukuba.ac.jp (Postfix) with ESMTP id 5B9D98001; Fri, 14 Sep 2007 03:14:56 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id D73C71A2E11; Fri, 14 Sep 2007 03:15:27 +0900 (JST) In-Reply-To: X-Mailer: VM 7.17 under 21.5 (beta28) "fuki" (+CVS-20070621) XEmacs Lucid X-Detected-Kernel: Linux 2.6, seldom 2.4 (older, 4) 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:78797 Archived-At: Stefan Monnier writes: > > I tend to agree with Yamamoto-san, because even if the string->string > > maps were identical, having the names specify the intended domain > > helps with deciding when to apply them at all. > > I beg to disagree: a function's name and docstring should reflect what the > function *does* rather than how it is used. That's what I said. I'm a categorist: functions with different domains are different functions, they do different things even if they happen to agree on the intersection of their domains. As for the docstring, we'll have to agree to disagree. There is no real cost to having a docstring that warns about improper usage any more, it's a matter of style. You prefer a style that assumes that people only need to be reminded of the arguments; others should refer to the manual. I think that's what skeletons etc are for, and prefer more verbose docstrings, more like Unix man pages in sections 2 and 3.