From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [External] : Re: master 7f53446: Doc fix for y-or-n-p; trailing space is no longer needed Date: Wed, 04 Jan 2023 19:31:24 +0200 Message-ID: <83358qyzo3.fsf@gnu.org> References: <20210916073852.6025.85941@vcs0.savannah.gnu.org> <20210916073853.B90BA20ABE@vcs0.savannah.gnu.org> <87mt6zk7v0.fsf@gmail.com> <874jt6k3uc.fsf@gmail.com> <87mt6yi8qe.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5937"; mail-complaints-to="usenet@ciao.gmane.io" Cc: drew.adams@oracle.com, stefankangas@gmail.com, emacs-devel@gnu.org To: Robert Pluim Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jan 04 18:31:49 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pD7cC-0001N9-HF for ged-emacs-devel@m.gmane-mx.org; Wed, 04 Jan 2023 18:31:48 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pD7bg-0004ew-5x; Wed, 04 Jan 2023 12:31:16 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pD7be-0004eX-Ld for emacs-devel@gnu.org; Wed, 04 Jan 2023 12:31:14 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pD7bd-00046X-QP; Wed, 04 Jan 2023 12:31:13 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=tprQNeJheB4s1ArBVTI1Ii9AZq1CwA0TU7cbhVsyh+M=; b=UEafR9gB8IBtZCF8JuFp TP1ZTN2LLvqROgEuOq07FaIn5aWGYtrrJ0vzry4K8j0oQfJslU3X2v8OUL/zh22vvHt1L3nIFusa+ bthp6M/Kwd4DcU8KEYbhlZKKexnIyf6kYCsO7TBf6m1Kd2o8zpMuuN59YYsZWE8S8KE23s3XoSfi2 A9Lt9X7ZDLfC029KHpHsSVdVYRjY5abpH/gUQKdSJFg9Jz9m8KCrxbaBdQujjqM2WJeoSgIyvyIhu rXrqothIOpnHMHTtUH18+BimgehF+cdSAGA6vIuvxvrP5zj8mwgIxaqFX+L4XHfbojgS6VjkWb/uV chz/DlFqCfasyg==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pD7bc-0002F6-Kn; Wed, 04 Jan 2023 12:31:13 -0500 In-Reply-To: <87mt6yi8qe.fsf@gmail.com> (message from Robert Pluim on Wed, 04 Jan 2023 17:07:37 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:302228 Archived-At: > From: Robert Pluim > Cc: Stefan Kangas , "emacs-devel@gnu.org" > > Date: Wed, 04 Jan 2023 17:07:37 +0100 > > - `y-or-n-p' has, since emacs 24.3 or so, appended a space to the prompt > if there wasnʼt one > - `yes-or-no-p' doesnʼt mess with the prompt > > This discussion is about the documentation of those two facts, which > needs adjusting since itʼs currently incorrect. There was a suggestion > by me to maybe align `yes-or-no-p' behaviour (what you call "dwim") to > match `y-or-n-p', but since thatʼs 'legacy' I doubt itʼs going to be > done. I don't see any reasons whatsoever to mention this DWIM-ish behavior in a doc string. We made these functions behave like that because we believe that would silently DTRT in every reasonable use case, so unless someone complains about this behavior, and documenting it somehow satisfies the complaint, we should not confuse Lisp programmers with these details, about which they should not care. So I've went ahead and removed this detail from the two doc string, including the fact that y-or-n-p adds a space _before_ the parentheses. I hope this will put this thread to rest.