From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: juri@linkov.net, bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 02:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 50390@debbugs.gnu.org Cc: juri linkov X-Debbugs-Original-To: bug-gnu-emacs@gnu.org X-Debbugs-Original-Xcc: juri linkov Received: via spool by submit@debbugs.gnu.org id=B.163081059413715 (code B ref -1); Sun, 05 Sep 2021 02:57:01 +0000 Received: (at submit) by debbugs.gnu.org; 5 Sep 2021 02:56:34 +0000 Received: from localhost ([127.0.0.1]:48921 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMiKg-0003Z8-LP for submit@debbugs.gnu.org; Sat, 04 Sep 2021 22:56:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:52228) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMiKe-0003Z0-HE for submit@debbugs.gnu.org; Sat, 04 Sep 2021 22:56:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60986) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mMiKe-0004Ow-92 for bug-gnu-emacs@gnu.org; Sat, 04 Sep 2021 22:56:32 -0400 Received: from mail-pl1-f171.google.com ([209.85.214.171]:37687) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mMiKc-0000vh-Ks for bug-gnu-emacs@gnu.org; Sat, 04 Sep 2021 22:56:31 -0400 Received: by mail-pl1-f171.google.com with SMTP id q3so1901310plx.4 for ; Sat, 04 Sep 2021 19:56:30 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=dFNz0U1qOev1zqticdSbx5hvx8IUkqHRpbTrnQbRxCc=; b=ib04TzhTSW0hS158Tn7OfYeNluA5M5EGZLdTd62cQ8sLJ37U1m4TQZCcj7OhyOr+zS /6ptkpSjiNb58AFGwCavj4LtTaowHZqRsowiMvdR7d9XSuGqUj1PpC8PmSLZPBqiznGo 29U+6s/TExOWm5zauSs+8qW2FnERCVYyJtFHf/tyuZUlf3FiQJcR8VVcn/GjGgFF2xoU ukUWvze4kqfXUKSZOa3KMjP9pbYUZyfJhIrnXJf+rAUtRURaKpWSqfq/aFrM3qwWSeLh 0EzpQ/8E90lXuvsRQay6YniUMP4Hqrj1wr5F9T6ci2lOGgeGRnokMpcRfC/6XBx69OSi yXhQ== X-Gm-Message-State: AOAM5308okJeAcaR4k5HT9CuJpK4PJkTHt1NCcxiHQ2151PKqb39lGTC jF8zTfSudNc+zouPzOTzrcxhPW2A5e6HjSlb8VyoozjEVvc= X-Google-Smtp-Source: ABdhPJyxWxSlHbw8PQtuR/skLnAHdYHSYNLbtI+3hycFeR7rz4Gr/VMyxlgy9MI3BFIPCospHIzQNFWDVPCgh5pgfvk= X-Received: by 2002:a17:902:b691:b029:12d:2b6:d116 with SMTP id c17-20020a170902b691b029012d02b6d116mr5298653pls.71.1630810589092; Sat, 04 Sep 2021 19:56:29 -0700 (PDT) MIME-Version: 1.0 From: Stefan Kangas Date: Sun, 5 Sep 2021 04:56:18 +0200 Message-ID: Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=209.85.214.171; envelope-from=stefankangas@gmail.com; helo=mail-pl1-f171.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: -0.8 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.8 (-) Severity: wishlist X-Debbugs-CC: Juri Linkov I read in NEWS for Emacs 28: New variables 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key'. When I look into the documentation of those variables, I do not get any explanation of why I would want to use them. I also can't find any explanation in the manual. Even just one or two sentences that indicates its typical use would be very helpful here. From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 08:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Kangas Cc: 50390@debbugs.gnu.org Received: via spool by 50390-submit@debbugs.gnu.org id=B50390.163082946628271 (code B ref 50390); Sun, 05 Sep 2021 08:12:02 +0000 Received: (at 50390) by debbugs.gnu.org; 5 Sep 2021 08:11:06 +0000 Received: from localhost ([127.0.0.1]:49127 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMnF4-0007Lv-Gs for submit@debbugs.gnu.org; Sun, 05 Sep 2021 04:11:06 -0400 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:43009) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMnF2-0007Kv-It for 50390@debbugs.gnu.org; Sun, 05 Sep 2021 04:11:05 -0400 Received: (Authenticated sender: juri@linkov.net) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 95FEE60003; Sun, 5 Sep 2021 08:10:57 +0000 (UTC) From: Juri Linkov Organization: LINKOV.NET References: Date: Sun, 05 Sep 2021 11:08:13 +0300 In-Reply-To: (Stefan Kangas's message of "Sun, 5 Sep 2021 04:56:18 +0200") Message-ID: <87mtorv40i.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > I read in NEWS for Emacs 28: > > New variables 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key'. > > When I look into the documentation of those variables, I do not get > any explanation of why I would want to use them. I also can't find > any explanation in the manual. > > Even just one or two sentences that indicates its typical use would be > very helpful here. The problem is that read-char-choice still has no docstring. After adding it, the docstring of read-char-choice should refer to read-char-choice-use-read-key and explain it. y-or-n-p already has docstring and should mention y-or-n-p-use-read-key. From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 10:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Juri Linkov Cc: Stefan Kangas , 50390@debbugs.gnu.org Received: via spool by 50390-submit@debbugs.gnu.org id=B50390.163083622024512 (code B ref 50390); Sun, 05 Sep 2021 10:04:02 +0000 Received: (at 50390) by debbugs.gnu.org; 5 Sep 2021 10:03:40 +0000 Received: from localhost ([127.0.0.1]:49289 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp00-0006NH-8R for submit@debbugs.gnu.org; Sun, 05 Sep 2021 06:03:40 -0400 Received: from quimby.gnus.org ([95.216.78.240]:50154) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMozy-0006N2-Q5 for 50390@debbugs.gnu.org; Sun, 05 Sep 2021 06:03:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=3c9FLMC4HqYmVULdt4e99AOSBFh+dL50EQ3Lip8OUAo=; b=eWSZGWRWOm/lwBdD2l4XOZu0ZM IDPbio8KZJhNa4PA0d2vsF1DP/ZrTh69rbLc625Xw4Iix8TSvTxDIdCVn+zZEg2hJdgf033pCl4sd PWeUMn4TW0UWLsiCuNRqOy8y8SUbcSxhHlxRAqMNO/arj+K83xX9RiA3btnVw7kuEAlI=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mMozp-0004AL-Ht; Sun, 05 Sep 2021 12:03:32 +0200 From: Lars Ingebrigtsen References: <87mtorv40i.fsf@mail.linkov.net> Date: Sun, 05 Sep 2021 12:03:28 +0200 In-Reply-To: <87mtorv40i.fsf@mail.linkov.net> (Juri Linkov's message of "Sun, 05 Sep 2021 11:08:13 +0300") Message-ID: <87r1e3mj9r.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Juri Linkov writes: >> When I look into the documentation of those variables, I do not get >> any explanation of why I would want to use them. I also can't find >> any explanation in the manual. >> >> Even just one or tw [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Juri Linkov writes: >> When I look into the documentation of those variables, I do not get >> any explanation of why I would want to use them. I also can't find >> any explanation in the manual. >> >> Even just one or two sentences that indicates its typical use would be >> very helpful here. > > The problem is that read-char-choice still has no docstring. > After adding it, the docstring of read-char-choice should > refer to read-char-choice-use-read-key and explain it. > > y-or-n-p already has docstring and should mention y-or-n-p-use-read-key. I've now added some text to the doc strings of the variables and functions to try to explain what the difference here is, which isn't obvious. Feel free to improve more -- it's kinda hard to succinctly explain the user interface difference here. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 06:03:44 2021 Received: (at control) by debbugs.gnu.org; 5 Sep 2021 10:03:44 +0000 Received: from localhost ([127.0.0.1]:49292 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp04-0006Nb-Gd for submit@debbugs.gnu.org; Sun, 05 Sep 2021 06:03:44 -0400 Received: from quimby.gnus.org ([95.216.78.240]:50168) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp03-0006N9-1I for control@debbugs.gnu.org; Sun, 05 Sep 2021 06:03:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=gf7Q/Y54GB0g9Aqh8cywb997avc1BfP/J58EfJEeXV8=; b=nHeGTyDcbx0FlHDtGE1z1isVbx hgcs56Lj+G/zcSmxRyP1a/D0kSMjZ1VNtYoVJOLubjSfpHm2rZ1OW25oY5eHj3HYWFcUHi7r3r/EY rVu+OylOppJ50V9/3CP4ywZt7T9pRRPgpPvxOJwNKs0w7e48AqHov+ZzzmTUTIcEaINk=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mMozv-0004AT-7y for control@debbugs.gnu.org; Sun, 05 Sep 2021 12:03:37 +0200 Date: Sun, 05 Sep 2021 12:03:34 +0200 Message-Id: <87pmtnmj9l.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #50390 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 50390 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) close 50390 28.1 quit From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 10:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net Received: via spool by 50390-submit@debbugs.gnu.org id=B50390.163083670925362 (code B ref 50390); Sun, 05 Sep 2021 10:12:02 +0000 Received: (at 50390) by debbugs.gnu.org; 5 Sep 2021 10:11:49 +0000 Received: from localhost ([127.0.0.1]:49315 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp7t-0006az-2T for submit@debbugs.gnu.org; Sun, 05 Sep 2021 06:11:49 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57506) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp7s-0006an-55 for 50390@debbugs.gnu.org; Sun, 05 Sep 2021 06:11:48 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:59512) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mMp7m-0002YU-8x; Sun, 05 Sep 2021 06:11:42 -0400 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:3739 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 1mMp7l-0004YJ-SJ; Sun, 05 Sep 2021 06:11:42 -0400 Date: Sun, 05 Sep 2021 13:11:42 +0300 Message-Id: <83pmtntjq9.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87r1e3mj9r.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 05 Sep 2021 12:03:28 +0200) References: <87mtorv40i.fsf@mail.linkov.net> <87r1e3mj9r.fsf@gnus.org> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lars Ingebrigtsen > Date: Sun, 05 Sep 2021 12:03:28 +0200 > Cc: Stefan Kangas , 50390@debbugs.gnu.org > > I've now added some text to the doc strings of the variables and > functions to try to explain what the difference here is, which isn't > obvious. Feel free to improve more -- it's kinda hard to succinctly > explain the user interface difference here. What is the non-succinct explanation? From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 10:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net Received: via spool by 50390-submit@debbugs.gnu.org id=B50390.163083681325565 (code B ref 50390); Sun, 05 Sep 2021 10:14:02 +0000 Received: (at 50390) by debbugs.gnu.org; 5 Sep 2021 10:13:33 +0000 Received: from localhost ([127.0.0.1]:49329 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp9Z-0006eF-Gl for submit@debbugs.gnu.org; Sun, 05 Sep 2021 06:13:33 -0400 Received: from quimby.gnus.org ([95.216.78.240]:50328) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMp9Y-0006e3-DC for 50390@debbugs.gnu.org; Sun, 05 Sep 2021 06:13:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=XMFKIAZpD8Ka9HQPc4JfbqrNBZFQVsgf+n0bmUhZHoE=; b=Y1GsHflFpsa/Ild6Y1xQs2sRUq lRvF2Nxf/dJae7TjHvdqUld+isWFFE3pvyJ1HM8cihEkQocSbIJ/ZTvcyS43e0VH+CbqmuzOMAcAM m5LsE/9RpJ1KY1O7WXa65AHwq/gjMqWGLSTyVidVJroEDfwoTFnRfSU5tNhbp8Ya1QNA=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mMp9P-0004GB-KB; Sun, 05 Sep 2021 12:13:25 +0200 From: Lars Ingebrigtsen References: <87mtorv40i.fsf@mail.linkov.net> <87r1e3mj9r.fsf@gnus.org> <83pmtntjq9.fsf@gnu.org> Date: Sun, 05 Sep 2021 12:13:23 +0200 In-Reply-To: <83pmtntjq9.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 05 Sep 2021 13:11:42 +0300") Message-ID: <87czpnmit8.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eli Zaretskii writes: >> I've now added some text to the doc strings of the variables and >> functions to try to explain what the difference here is, which isn't >> obvious. Feel free to improve more -- it's kinda hard to [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: >> I've now added some text to the doc strings of the variables and >> functions to try to explain what the difference here is, which isn't >> obvious. Feel free to improve more -- it's kinda hard to succinctly >> explain the user interface difference here. > > What is the non-succinct explanation? It's in the patch. :-) -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sat Aug 16 14:31:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Sep 2021 10:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50390 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net Received: via spool by 50390-submit@debbugs.gnu.org id=B50390.163083795111685 (code B ref 50390); Sun, 05 Sep 2021 10:33:02 +0000 Received: (at 50390) by debbugs.gnu.org; 5 Sep 2021 10:32:31 +0000 Received: from localhost ([127.0.0.1]:49357 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMpRu-000327-Lp for submit@debbugs.gnu.org; Sun, 05 Sep 2021 06:32:30 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60118) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mMpRt-0002xL-DD for 50390@debbugs.gnu.org; Sun, 05 Sep 2021 06:32:30 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:60076) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mMpRn-00038H-Hv; Sun, 05 Sep 2021 06:32:23 -0400 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:1042 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 1mMpRn-0000OC-4X; Sun, 05 Sep 2021 06:32:23 -0400 Date: Sun, 05 Sep 2021 13:32:26 +0300 Message-Id: <83mtortirp.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87czpnmit8.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 05 Sep 2021 12:13:23 +0200) References: <87mtorv40i.fsf@mail.linkov.net> <87r1e3mj9r.fsf@gnus.org> <83pmtntjq9.fsf@gnu.org> <87czpnmit8.fsf@gnus.org> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lars Ingebrigtsen > Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net > Date: Sun, 05 Sep 2021 12:13:23 +0200 > > Eli Zaretskii writes: > > >> I've now added some text to the doc strings of the variables and > >> functions to try to explain what the difference here is, which isn't > >> obvious. Feel free to improve more -- it's kinda hard to succinctly > >> explain the user interface difference here. > > > > What is the non-succinct explanation? > > It's in the patch. :-) LGTM.