From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: Small docstring improvements Date: Sat, 20 Aug 2016 16:17:27 -0700 Message-ID: References: <83r39jdif8.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1471735079 10460 195.159.176.226 (20 Aug 2016 23:17:59 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 20 Aug 2016 23:17:59 +0000 (UTC) User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/25.1 (darwin) Cc: p.stephani2@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Aug 21 01:17:55 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bbFWT-0002Lh-8s for ged-emacs-devel@m.gmane.org; Sun, 21 Aug 2016 01:17:53 +0200 Original-Received: from localhost ([::1]:34588 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bbFWQ-00059v-Nm for ged-emacs-devel@m.gmane.org; Sat, 20 Aug 2016 19:17:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35788) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bbFWJ-00059q-TD for emacs-devel@gnu.org; Sat, 20 Aug 2016 19:17:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bbFWH-0001CW-Np for emacs-devel@gnu.org; Sat, 20 Aug 2016 19:17:42 -0400 Original-Received: from mail-pa0-x235.google.com ([2607:f8b0:400e:c03::235]:33885) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bbFWC-0001CJ-OQ; Sat, 20 Aug 2016 19:17:36 -0400 Original-Received: by mail-pa0-x235.google.com with SMTP id fi15so26342355pac.1; Sat, 20 Aug 2016 16:17:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version; bh=+b/Sx0IONvu4aE/CT6oEYy+KnaN5hsEnan5m2n+wJ5U=; b=Y6MSievBegENDr5q0CbLq90wdWEKp0z6ygEgGLtEqBmmj9VrWlliWD9O7G5UfbFJv4 WTP6OHwwaA0zy/OEPmr4/FKKDTiBfv7tZMWaDXHlVsmHjSbOKvO0QoDcu6YQ1sJBlgmG B380lS2iZV33BzxzewM2c9jeQiFLXEFGwUby6GrYARdg39X0fXC4xHArKZK63IQ0pHrV mBG2c6jAt+t/OB3XAc+WFAtr0vOyqwWqtcTEUZotdVTfUHE30XRtMoQ4TogYz7rmxQoK Ab3wro2UTZ1WUe+ldLR7nf6/tRIj5gX6pkIJ2SghNfkpYEcTCyVx0OHy2KkBGRdEpwHQ h2tQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:mail-followup-to:mime-version; bh=+b/Sx0IONvu4aE/CT6oEYy+KnaN5hsEnan5m2n+wJ5U=; b=GPk7Ry4S6e6U57V4P1AAt/Nup73nwMV2TT2HGmEgVa3ip3snwjfg2U4A7o9ABT8h9G 4+BDGOSi3DznZeE0+crU6R2Y1aiICC7gCA722IuXX55h68Jrs4aw7SV6qZQ8XYewcYVs RZ85j+RnRHV6NEdCnieTXuDLN+36VWVgL4fHljDHRTwIyYrKxlBwc5bHfv2SEh0Nex9C jiylhC7r2WtAZOQWLYMFSBwiChJ2kyyOVfjGKum2SCuyHyxnCH1AjT16++3I5ucx7jfv UF25dRLoFQ+ggn5q6N0hnUCFSoMRaQoqV00k3/qVgGvaMsoe+SFIks+NdPOUyv8yNFTn +Crw== X-Gm-Message-State: AEkoouvtO+LGc+/AJ59/1EDdGg0gXzYo8CNUrrSkkVix/ZT0Lrr2NX/xRa4EI0OXBS0mSg== X-Received: by 10.66.72.40 with SMTP id a8mr27951584pav.15.1471735054290; Sat, 20 Aug 2016 16:17:34 -0700 (PDT) Original-Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id t7sm21440099paz.21.2016.08.20.16.17.32 (version=TLS1 cipher=AES128-SHA bits=128/128); Sat, 20 Aug 2016 16:17:32 -0700 (PDT) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 4F050206D9AC; Sat, 20 Aug 2016 16:17:31 -0700 (PDT) In-Reply-To: <83r39jdif8.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 20 Aug 2016 10:10:51 +0300") Mail-Followup-To: Eli Zaretskii , p.stephani2@gmail.com, emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c03::235 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:206714 Archived-At: >>>>> Eli Zaretskii writes: > Once again, I don't see why you dislike that. Lisp is not C. It's like having a function called "print" that sends e-mail when called on Tuesday. Yay, polymorphism! But it doesn't mean what it says on the box. START should mean START, or else the function shouldn't be called `call-process-region' (since it's not always acting on a region, sometimes it's a string), and the argument shouldn't be called START, but rather START-OR-BUFFER-IF-NIL-OR-STRING, since that's what it actually means. I'm against one thing acting as multiple other things, just because a hack of that nature was convenient at some time in the past. It's ugly, it's messy, it's unnecessary. If a function does 3 separate-yet-related things, there should be 3 separate-yet-related functions instead. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2