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: Your last change to browse-url is bogus. Date: Thu, 13 Sep 2007 17:44:00 -0400 Message-ID: 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> <87y7fajutc.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 1189719864 25434 80.91.229.12 (13 Sep 2007 21:44:24 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 13 Sep 2007 21:44:24 +0000 (UTC) Cc: =?iso-8859-1?Q?Micha=EBl?= Cadilhac , Johannes Weiner , YAMAMOTO Mitsuharu , emacs-devel@gnu.org To: "Stephen J. Turnbull" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Sep 13 23:44:21 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 1IVwTs-00051h-Cm for ged-emacs-devel@m.gmane.org; Thu, 13 Sep 2007 23:44:12 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IVwTs-0007y8-0S for ged-emacs-devel@m.gmane.org; Thu, 13 Sep 2007 17:44:12 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IVwTo-0007uX-4M for emacs-devel@gnu.org; Thu, 13 Sep 2007 17:44:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IVwTn-0007sQ-H9 for emacs-devel@gnu.org; Thu, 13 Sep 2007 17:44:07 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IVwTn-0007s6-52 for emacs-devel@gnu.org; Thu, 13 Sep 2007 17:44:07 -0400 Original-Received: from x-132-204-254-81.xtpr.umontreal.ca ([132.204.254.81] helo=ceviche.home) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IVwTm-0000eg-PT for emacs-devel@gnu.org; Thu, 13 Sep 2007 17:44:06 -0400 Original-Received: by ceviche.home (Postfix, from userid 20848) id 18954B40C3; Thu, 13 Sep 2007 17:44:00 -0400 (EDT) In-Reply-To: <87y7fajutc.fsf@uwakimon.sk.tsukuba.ac.jp> (Stephen J. Turnbull's message of "Fri\, 14 Sep 2007 03\:15\:27 +0900") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) X-Detected-Kernel: Linux 2.6 (newer, 3) 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:78806 Archived-At: >> > 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. You lost me. I guess we were just not talking about the same thing. Stefan