From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 04 22:56:34 2021 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: Subject: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' To: bug-gnu-emacs@gnu.org 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-Debbugs-Envelope-To: submit 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 debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 04:11:06 2021 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 To: Stefan Kangas Subject: Re: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' 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-Debbugs-Envelope-To: 50390 Cc: 50390@debbugs.gnu.org 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 debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 06:03:40 2021 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 To: Juri Linkov Subject: Re: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' 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-Debbugs-Envelope-To: 50390 Cc: Stefan Kangas , 50390@debbugs.gnu.org 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 debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 06:11:49 2021 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 To: Lars Ingebrigtsen In-Reply-To: <87r1e3mj9r.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 05 Sep 2021 12:03:28 +0200) Subject: Re: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' References: <87mtorv40i.fsf@mail.linkov.net> <87r1e3mj9r.fsf@gnus.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 50390 Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net 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 debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 06:13:33 2021 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 To: Eli Zaretskii Subject: Re: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' 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-Debbugs-Envelope-To: 50390 Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net 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 debbugs-submit-bounces@debbugs.gnu.org Sun Sep 05 06:32:30 2021 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 To: Lars Ingebrigtsen In-Reply-To: <87czpnmit8.fsf@gnus.org> (message from Lars Ingebrigtsen on Sun, 05 Sep 2021 12:13:23 +0200) Subject: Re: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key' References: <87mtorv40i.fsf@mail.linkov.net> <87r1e3mj9r.fsf@gnus.org> <83pmtntjq9.fsf@gnu.org> <87czpnmit8.fsf@gnus.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 50390 Cc: stefan@marxist.se, 50390@debbugs.gnu.org, juri@linkov.net 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. From unknown Fri Aug 15 17:22:27 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 03 Oct 2021 11:24:09 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator