From unknown Sat Jun 21 10:38:47 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#31628 <31628@debbugs.gnu.org> To: bug#31628 <31628@debbugs.gnu.org> Subject: Status: 26.1; Problem in read-multiple-choice's docstring Reply-To: bug#31628 <31628@debbugs.gnu.org> Date: Sat, 21 Jun 2025 17:38:47 +0000 retitle 31628 26.1; Problem in read-multiple-choice's docstring reassign 31628 emacs submitter 31628 Damien Cassou severity 31628 minor tag 31628 fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Mon May 28 11:23:38 2018 Received: (at submit) by debbugs.gnu.org; 28 May 2018 15:23:38 +0000 Received: from localhost ([127.0.0.1]:52569 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNJzk-0001vz-A0 for submit@debbugs.gnu.org; Mon, 28 May 2018 11:23:36 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40367) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNJzi-0001vn-En for submit@debbugs.gnu.org; Mon, 28 May 2018 11:23:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNJzc-0002aD-6N for submit@debbugs.gnu.org; Mon, 28 May 2018 11:23:29 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:54910) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fNJzc-0002a6-2X for submit@debbugs.gnu.org; Mon, 28 May 2018 11:23:28 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59547) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNJza-0003DG-MQ for bug-gnu-emacs@gnu.org; Mon, 28 May 2018 11:23:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNJzY-0002XX-2O for bug-gnu-emacs@gnu.org; Mon, 28 May 2018 11:23:26 -0400 Received: from mail.choca.pics ([2001:bc8:20ab::1]:33220) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fNJzX-0002SR-N2 for bug-gnu-emacs@gnu.org; Mon, 28 May 2018 11:23:23 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 1429E233207E for ; Mon, 28 May 2018 17:23:14 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id 867x-SVz2g-V for ; Mon, 28 May 2018 17:23:13 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id CFD64233207F for ; Mon, 28 May 2018 17:23:12 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.10.3 mail.choca.pics CFD64233207F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cassou.me; s=9EA44F5C-DEF4-11E6-A83F-A08DF322D8FB; t=1527520992; bh=9XYm6+L/10xMRF9WjRpxqEn7mmgvM1/lopSFiD1DBF0=; h=From:To:Date:Message-ID:MIME-Version; b=b0pfKnrH3vY3tJwfnEfilrtcA1msXVbWb2BVnVKpsxQfR1a/LzVQcbI9rYu5nVkQx 5jvpBlJ+ceT+zfqEIqBX173kAI0sn/lkDTGZYpongX3pPhmgaFXmMfvAzPEgGzw3mh meHgkZuAMM1sEUtlCeLhPB+3zWkPG/LMKT+RXM03yhGux9hrtwxE4+Dvc4WYtK2nqK fzFggm57VPLGb9Um53AJq1gv1myQ1ln2/YVmCvP+7pxaKeW4++Hmp/GNQyQsshBZH6 I5vlZxgbA2GCfz0jzIqwULDddzWz/bN0JQhzNtI1e0o1xiqf6l1Fce8kulL3Oit6+M Y65Uz0c6ybFzg== X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id zNEVtW-HvxuD for ; Mon, 28 May 2018 17:23:12 +0200 (CEST) Received: from luz4 (20-44-190-109.dsl.ovh.fr [109.190.44.20]) by mail.choca.pics (Postfix) with ESMTPSA id 49065233207E for ; Mon, 28 May 2018 17:23:12 +0200 (CEST) From: Damien Cassou To: bug-gnu-emacs@gnu.org Subject: 26.1; Problem in read-multiple-choice's docstring Date: Mon, 28 May 2018 17:23:08 +0200 Message-ID: <87lgc3pzxf.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) 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: -5.1 (-----) --=-=-= Content-Type: text/plain Attached patch fixes the docstring of read-multiple-choice. Previous docstring, said CHOICES was an alist which it isn't. The new docstring fixes that and gives names to components of each choice. -- Damien Cassou http://damiencassou.seasidehosting.st "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-lisp-emacs-lisp-rmc.el-read-multiple-choice-Improve-.patch >From 255c09ac20c940140e20d199b1f715fc98264da5 Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Mon, 28 May 2018 17:12:34 +0200 Subject: [PATCH] * lisp/emacs-lisp/rmc.el (read-multiple-choice): Improve docstring. --- lisp/emacs-lisp/rmc.el | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/lisp/emacs-lisp/rmc.el b/lisp/emacs-lisp/rmc.el index 3dd3508903..9813dcf2e5 100644 --- a/lisp/emacs-lisp/rmc.el +++ b/lisp/emacs-lisp/rmc.el @@ -30,12 +30,11 @@ read-multiple-choice "Ask user a multiple choice question. PROMPT should be a string that will be displayed as the prompt. -CHOICES is an alist where the first element in each entry is a -character to be entered, the second element is a short name for -the entry to be displayed while prompting (if there's room, it -might be shortened), and the third, optional entry is a longer -explanation that will be displayed in a help buffer if the user -requests more help. +CHOICES is a list of (KEY NAME [DESCRIPTION]). KEY is a character +to be entered. NAME a short name for the entry to be displayed +while prompting (if there's room, it might be shortened). +DESCRIPTION is an optional longer explanation that will be +displayed in a help buffer if the user requests more help. This function translates user input into responses by consulting the bindings in `query-replace-map'; see the documentation of -- 2.17.0 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Mon May 28 14:07:34 2018 Received: (at 31628) by debbugs.gnu.org; 28 May 2018 18:07:34 +0000 Received: from localhost ([127.0.0.1]:52694 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNMYQ-0005pz-Ln for submit@debbugs.gnu.org; Mon, 28 May 2018 14:07:34 -0400 Received: from mail-wm0-f54.google.com ([74.125.82.54]:36224) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNMYP-0005pl-5k for 31628@debbugs.gnu.org; Mon, 28 May 2018 14:07:33 -0400 Received: by mail-wm0-f54.google.com with SMTP id v131-v6so14879048wma.1 for <31628@debbugs.gnu.org>; Mon, 28 May 2018 11:07:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=fKKjw8Cv39hWWB5jSAG53vItq8BSY9Y7Kk+yWQzO5wM=; b=fm+XkgvE6lA3/ZoWq1hCAfxa1zU0CUQE1d+/AghjK5fLzVy9YTc4wlaVnruwNXwrYP TZc9QpRsaUAz1qMJHBunDb324p5VOgPdFIOoTn1Ab7AzPLYvqM5MZUaKvfbsTADwe5hL 7Q7JmsgRsHeWF0c+NRYYStwYmI6MoenmCYAROzSRWWSX1aS2QSG/WlHn3BAd9LFuAqLy XadidIZFtPb4ot/xnBaF13zwUIEheAOQWAPI+7s8HMzz/LR9eg+zaxQ3n/l82OgN5NBJ 2N47F144g0pLP2GXxfP+1J18XNbT9ECfSRLcdWZ0Gm9xtw5KHxXLVNmsvNgbIJ0bifdE NF0w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=fKKjw8Cv39hWWB5jSAG53vItq8BSY9Y7Kk+yWQzO5wM=; b=AOCfVu2xWerCZzSlGOLwM7BjQFuNrZUBDx+WvmTk9UrtmrgDaHFRfgozeZ27aNyE6+ V5xTKFJvd35g8FxRDUXlkcY+Y5ni5gGqZ7OoL+GjKU69bpV0siTH4WFbDKCaArAwceW6 nVu0VwzeH2uR9LR3KNNTgXAe3npE9EFWmKe0/wz7dKAGag2GjB00maEDZ4wR6N/gJBlU +T1SxYWdI5LWedmrlnE6qIaut6QfpsOEEOannMnf9oyqE0/+w/+5B5F7iwhxVdTvGXLu /yNvu03qH0sAEslvqM7mBidg/lkVX3CpeelzaNLRxmlsjPubf35TlaJIPFPYrnPuU/Cj aSLQ== X-Gm-Message-State: ALKqPwdKb1+4tmk7aihhvSWGv2GcTTmYMi6dyIw2kqj0Ky4TmamOAZbm Nz3A+nIOFapwg9fzj4NwFkWlfSWi X-Google-Smtp-Source: AB8JxZon8eedBLQ5I2MYWRn5i25Z/iRbRo83fAb0KBwXo1sGMjvh9QjweP/Q+sE1M3N31jx9Izh2cg== X-Received: by 2002:a50:9ae1:: with SMTP id p88-v6mr15778466edb.20.1527530847439; Mon, 28 May 2018 11:07:27 -0700 (PDT) Received: from localhost ([213.233.149.25]) by smtp.gmail.com with ESMTPSA id x3-v6sm7037426eda.55.2018.05.28.11.07.26 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 28 May 2018 11:07:26 -0700 (PDT) From: "Basil L. Contovounesios" To: Damien Cassou Subject: Re: bug#31628: 26.1; Problem in read-multiple-choice's docstring References: <87lgc3pzxf.fsf@cassou.me> Date: Mon, 28 May 2018 19:07:25 +0100 In-Reply-To: <87lgc3pzxf.fsf@cassou.me> (Damien Cassou's message of "Mon, 28 May 2018 17:23:08 +0200") Message-ID: <877enn64de.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 1.5 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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 the administrator of that system for details. Content preview: Damien Cassou writes: > Previous docstring, said CHOICES was an alist which it isn't. Technically, a list of (A B C) is as much an alist as a list of (A . B), but I agree that the docstring can be clarified a bit. [...] Content analysis details: (1.5 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 1.5 RCVD_IN_SORBS_WEB RBL: SORBS: sender is an abusable web server [213.233.149.25 listed in dnsbl.sorbs.net] -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at http://www.dnswl.org/, no trust [74.125.82.54 listed in list.dnswl.org] -0.0 RCVD_IN_MSPIKE_H3 RBL: Good reputation (+3) [74.125.82.54 listed in wl.mailspike.net] 0.0 T_DKIM_INVALID DKIM-Signature header exists but is not valid -0.0 RCVD_IN_MSPIKE_WL Mailspike good senders X-Debbugs-Envelope-To: 31628 Cc: 31628@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: 0.5 (/) Damien Cassou writes: > Previous docstring, said CHOICES was an alist which it isn't. Technically, a list of (A B C) is as much an alist as a list of (A . B), but I agree that the docstring can be clarified a bit. > From 255c09ac20c940140e20d199b1f715fc98264da5 Mon Sep 17 00:00:00 2001 > From: Damien Cassou > Date: Mon, 28 May 2018 17:12:34 +0200 > Subject: [PATCH] * lisp/emacs-lisp/rmc.el (read-multiple-choice): Improve > docstring. > > --- > lisp/emacs-lisp/rmc.el | 11 +++++------ > 1 file changed, 5 insertions(+), 6 deletions(-) > > diff --git a/lisp/emacs-lisp/rmc.el b/lisp/emacs-lisp/rmc.el > index 3dd3508903..9813dcf2e5 100644 > --- a/lisp/emacs-lisp/rmc.el > +++ b/lisp/emacs-lisp/rmc.el > @@ -30,12 +30,11 @@ read-multiple-choice > "Ask user a multiple choice question. > PROMPT should be a string that will be displayed as the prompt. > > -CHOICES is an alist where the first element in each entry is a > -character to be entered, the second element is a short name for > -the entry to be displayed while prompting (if there's room, it > -might be shortened), and the third, optional entry is a longer > -explanation that will be displayed in a help buffer if the user > -requests more help. > +CHOICES is a list of (KEY NAME [DESCRIPTION]). KEY is a character > +to be entered. NAME a short name for the entry to be displayed > +while prompting (if there's room, it might be shortened). > +DESCRIPTION is an optional longer explanation that will be > +displayed in a help buffer if the user requests more help. I think the full stops should be followed by two spaces, as per the default sentence-end-double-space. -- Basil From debbugs-submit-bounces@debbugs.gnu.org Tue May 29 02:04:57 2018 Received: (at 31628) by debbugs.gnu.org; 29 May 2018 06:04:57 +0000 Received: from localhost ([127.0.0.1]:53004 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNXkf-0003MC-3l for submit@debbugs.gnu.org; Tue, 29 May 2018 02:04:57 -0400 Received: from mail.choca.pics ([62.210.108.126]:38908) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNXkd-0003M4-BV for 31628@debbugs.gnu.org; Tue, 29 May 2018 02:04:56 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 5C11423320EE; Tue, 29 May 2018 08:04:54 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id xvNzTzbtH51T; Tue, 29 May 2018 08:04:52 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 8B30023320EF; Tue, 29 May 2018 08:04:52 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.10.3 mail.choca.pics 8B30023320EF DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cassou.me; s=9EA44F5C-DEF4-11E6-A83F-A08DF322D8FB; t=1527573892; bh=Bm4jmIBccidUqHKsN6hCRhUCUioLlEtnNE9J5pjLe8A=; h=From:To:Date:Message-ID:MIME-Version; b=KLfILYBY9JY7kiApwOo6nSrHnWzrsX3c/AWWzm3vpj3jKzyDmzHAJd4UWvj8ZHtll zUo2pTAR/ikcR0l73nuHedzzV6emKXabO4WATjSQm8i9xWNZpFbOCeIWbtSIW+1EcU V7q6h0dC+05N3VzHhJfB0+Gki91E7kNNk37jqrzc+oy+WIxcV4/fLD8UpdcFsVJDbN 0YOIw/1kwKN9ExM2CvPrD1rZpOm8lFpoFxHXgEi5HO41vcboOYbksLVTZElht/XyUX T58w3BLR/Mav7ef8viSKNBRf+uUFac7C4DvI8P9wNGs+d5fKebntUJLqcnn/mPbkJJ gCyppEmb0WqWQ== X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id j-ys14ml65t3; Tue, 29 May 2018 08:04:52 +0200 (CEST) Received: from luz4 (20-44-190-109.dsl.ovh.fr [109.190.44.20]) by mail.choca.pics (Postfix) with ESMTPSA id 3054D23320EE; Tue, 29 May 2018 08:04:52 +0200 (CEST) From: Damien Cassou To: "Basil L. Contovounesios" Subject: Re: bug#31628: 26.1; Problem in read-multiple-choice's docstring In-Reply-To: <877enn64de.fsf@tcd.ie> References: <87lgc3pzxf.fsf@cassou.me> <877enn64de.fsf@tcd.ie> Date: Tue, 29 May 2018 08:04:49 +0200 Message-ID: <87in77hu9q.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31628 Cc: 31628@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 (-) --=-=-= Content-Type: text/plain "Basil L. Contovounesios" writes: > I think the full stops should be followed by two spaces, as per the > default sentence-end-double-space. fixed in attached patch. -- Damien Cassou http://damiencassou.seasidehosting.st "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-lisp-emacs-lisp-rmc.el-read-multiple-choice-Improve-.patch >From bad5de6b568d7730c4b3f48ae255a57eb91af421 Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Mon, 28 May 2018 17:12:34 +0200 Subject: [PATCH] * lisp/emacs-lisp/rmc.el (read-multiple-choice): Improve docstring. --- lisp/emacs-lisp/rmc.el | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/lisp/emacs-lisp/rmc.el b/lisp/emacs-lisp/rmc.el index 3dd3508903..6a0031cc4c 100644 --- a/lisp/emacs-lisp/rmc.el +++ b/lisp/emacs-lisp/rmc.el @@ -30,12 +30,12 @@ read-multiple-choice "Ask user a multiple choice question. PROMPT should be a string that will be displayed as the prompt. -CHOICES is an alist where the first element in each entry is a -character to be entered, the second element is a short name for -the entry to be displayed while prompting (if there's room, it -might be shortened), and the third, optional entry is a longer -explanation that will be displayed in a help buffer if the user -requests more help. +CHOICES is a list of (KEY NAME [DESCRIPTION]). KEY is a +character to be entered. NAME a short name for the entry to be +displayed while prompting (if there's room, it might be +shortened). DESCRIPTION is an optional longer explanation that +will be displayed in a help buffer if the user requests more +help. This function translates user input into responses by consulting the bindings in `query-replace-map'; see the documentation of @@ -46,7 +46,7 @@ read-multiple-choice again. When `use-dialog-box' is t (the default), this function can pop -up a dialog window to collect the user input. That functionality +up a dialog window to collect the user input. That functionality requires `display-popup-menus-p' to return t. Otherwise, a text dialog will be used. -- 2.17.0 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Tue May 29 08:18:50 2018 Received: (at 31628) by debbugs.gnu.org; 29 May 2018 12:18:50 +0000 Received: from localhost ([127.0.0.1]:53239 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNdaU-0001HN-Id for submit@debbugs.gnu.org; Tue, 29 May 2018 08:18:50 -0400 Received: from mail-it0-f41.google.com ([209.85.214.41]:54569) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNdaS-0001H3-Rx; Tue, 29 May 2018 08:18:49 -0400 Received: by mail-it0-f41.google.com with SMTP id 76-v6so2900117itx.4; Tue, 29 May 2018 05:18:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=Prl1D24iyeOwRNN8YSyKT8470D6+Qzki+ayLS2ieWjk=; b=Hh2hFfkaGQkHUlRFbuJyCM/46Jxp9/cnfE5dECTReroqXGPV1q64zx9kp7NBWLl9P9 0hUGo1KfotDw9+TdY284eZGT3atmwzacDQkjRgV27+DWlE2SndA8mqdF5/6/fDngFmqx Xganfurm39xCQ5d/K3ep/cKL8CfEVsCXa19LuTiiB1ngOuaebjVgAPW6t1ifP93igS2K y31wZ84XaidmBfJhltgYa8bRyQ6tyCHnh/CqMbGonSvj/87Tvmg8TVMbKNw72bvsRm1U 4XmH0PSPGi40WIZ3BTM4LzcN+ISTpACrXKkQ7oL7PG18vhQKl5k7hrb9SjXI853uDzV5 1v0g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=Prl1D24iyeOwRNN8YSyKT8470D6+Qzki+ayLS2ieWjk=; b=rNn2eaJm0u1iNqj5/xo4kWEUFWrJ5AsvNhl/tJOBNc2rtq0zHkFezW6oK045umaeJv LcsG3xKuHR4V43Jn4sFEijMhXx9iVOZVDFOSMnxcwKHqwaymCv/eFaBeZUtnzVRQVBwG eiummKzUrXrFsYx+g7JvFm1xSrleVnp9gJLV99UkHZf5wY8mca/4n+GM0iicP3vQtWUe Za8mVf2FqsK+j/f/j+mzl+Y/MFs8SWiAzRvAd0EH+JoT+YbKmQ8NMp6KM0S14cGLKUEN RAaSo6efXTr+wXhURpsmXlEu5hrS3unV/m8UuGEGfMbbcpgJNR18wZY7pWn5pViKUGBL pJAw== X-Gm-Message-State: ALKqPwfzqcP4vmYcx4pEixmU5pAmIfOnWCZRFABv04pZoriHYz9D+B+k d1gwhGVmKPVc/k/buTgHbHnPKg== X-Google-Smtp-Source: ADUXVKL60hrEdxROv2MRUBlVK9eU+5ZOjeqelAbcyup7fqAD+T6fW4LIkvzji9vq2ySbAARQsLsgWw== X-Received: by 2002:a24:dd94:: with SMTP id t142-v6mr13742198itf.81.1527596323269; Tue, 29 May 2018 05:18:43 -0700 (PDT) Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id w79-v6sm7503326itb.6.2018.05.29.05.18.42 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 29 May 2018 05:18:42 -0700 (PDT) From: Noam Postavsky To: Damien Cassou Subject: Re: bug#31628: 26.1; Problem in read-multiple-choice's docstring References: <87lgc3pzxf.fsf@cassou.me> <877enn64de.fsf@tcd.ie> <87in77hu9q.fsf@cassou.me> Date: Tue, 29 May 2018 08:18:41 -0400 In-Reply-To: <87in77hu9q.fsf@cassou.me> (Damien Cassou's message of "Tue, 29 May 2018 08:04:49 +0200") Message-ID: <87lgc2d59a.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31628 Cc: "Basil L. Contovounesios" , 31628@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 (-) severity 31628 minor tags 31628 fixed close 31628 26.2 quit Damien Cassou writes: > "Basil L. Contovounesios" writes: >> I think the full stops should be followed by two spaces, as per the >> default sentence-end-double-space. > > fixed in attached patch. I added a missing "is" after NAME, and pushed to emacs-26. [1: 24ba63314f]: 2018-05-29 08:17:32 -0400 Improve read-multiple-choice docstring (Bug#31628) https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=24ba63314f29fdffa9cfe012927e5efd744c138d From debbugs-submit-bounces@debbugs.gnu.org Tue May 29 09:50:01 2018 Received: (at 31628) by debbugs.gnu.org; 29 May 2018 13:50:02 +0000 Received: from localhost ([127.0.0.1]:53314 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNf0j-0005X6-Gn for submit@debbugs.gnu.org; Tue, 29 May 2018 09:50:01 -0400 Received: from aserp2130.oracle.com ([141.146.126.79]:43616) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNf0h-0005Wt-D1 for 31628@debbugs.gnu.org; Tue, 29 May 2018 09:49:59 -0400 Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w4TDk16p092209; Tue, 29 May 2018 13:49:43 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=yU2xFTtV5R3MqnXiiFDfL7KuBAWtEka99eNoKHykaZw=; b=lQN6V/Vm5Se1Zaranh/8CdEOEYkzMlUFqsHPjhsiw4yQzXQEvzXyXlo4xjf67kbJQo30 Evdf+IctlAC8ciWOQ9v29TxcJO7NpA3wN1gvqKwxy7cgPJ/Cybeg2EYinOCJNUy0B9Xz JLX4kHUnE8E84afKptLX1tY0NlsrfTiFM5KAzWktRODhaZ4W7s4M/W6hCj2che9trkN1 KEQmQD5YtiONfR/J2Y/GpyHbr/QbMBzc1Qa7HYRB7WEALxzWd9wfSwQT93MS0PErFJh3 I1yEppDhm2NMmNcry9KHd7Ed7eO7CAASfislAgf/DEiZ+o68YQ3YjFYblJDvp3BHxyhf Lw== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp2130.oracle.com with ESMTP id 2j6w42hkc9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 29 May 2018 13:49:43 +0000 Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w4TDnfgx025951 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 29 May 2018 13:49:42 GMT Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w4TDne2V012707; Tue, 29 May 2018 13:49:41 GMT MIME-Version: 1.0 Message-ID: <17f558ca-75b4-4787-ad48-b99559598b6a@default> Date: Tue, 29 May 2018 06:49:37 -0700 (PDT) From: Drew Adams To: "Basil L. Contovounesios" , Damien Cassou Subject: RE: bug#31628: 26.1; Problem in read-multiple-choice's docstring References: <87lgc3pzxf.fsf@cassou.me> <877enn64de.fsf@tcd.ie> In-Reply-To: <877enn64de.fsf@tcd.ie> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8907 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=848 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1805290158 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31628 Cc: 31628@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 (---) > Technically, a list of (A B C) is as much an alist as a list of (A . B), > but I agree that the docstring can be clarified a bit. No - assuming you mean that A, B, and C are elements of the list and they are atoms, not cons cells. >From (elisp) `Association Lists': It is a list of cons cells called "associations": the CAR of each cons cell is the "key", and the CDR is the "associated value". Alist elements are cons cells, in Emacs Lisp as in other Lisps. It's true that functions that look up an association do not raise an error if a list element is not a cons. In Emacs Lisp, it is _not_ an error if an element of an association list is not a cons cell. The alist search functions simply ignore such elements. Many other versions of Lisp signal errors in such cases. Ignoring such elements, like raising an error for such an element, does not mean that such an element is an association or that an alist is just any old list. And yes, there is even one function, `assoc-default', that treats an atomic list element as if it were an association. IOW, `assoc-default' works with any list, not just with alists. From debbugs-submit-bounces@debbugs.gnu.org Tue May 29 12:39:53 2018 Received: (at 31628) by debbugs.gnu.org; 29 May 2018 16:39:53 +0000 Received: from localhost ([127.0.0.1]:54229 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNhf6-0001Hz-V9 for submit@debbugs.gnu.org; Tue, 29 May 2018 12:39:53 -0400 Received: from mail-wm0-f47.google.com ([74.125.82.47]:55722) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fNhf5-0001Hl-10 for 31628@debbugs.gnu.org; Tue, 29 May 2018 12:39:51 -0400 Received: by mail-wm0-f47.google.com with SMTP id a8-v6so42423200wmg.5 for <31628@debbugs.gnu.org>; Tue, 29 May 2018 09:39:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=8JpPQBwk+OrlXTMTvMF6H0cxWJyXHVnETTAHv+cZr6w=; b=NO3JE6pVAGNbHlrfAXCAA4lLE/bxTynXNnS1GaOmIMA6DTfhI4r0GMc2FyOuwWwXGp VN/CapVk6tiwkcwppmQ9C9UmlNj3eTezmohVl3JbNli5crxZTU8VGjf/6Jcc1XiS2hjJ E3jSI80BEbUMIJ4xa8ia1wfokDy2o5RmgKhzsZvDHA8LkDExCfSrlH7YUwMhxZoftfL/ zIO2jJylt/xxqpsgEck7+CKaO/R+ZmZpJTYb8WemsuPbp2NNamHqP+dKMF39Ukxn/7iO xHXEKOZS//UtC9SYCr5smGkVQTuVe/w+6lx0PLs9HK/jbAH7rvqXWc0kPU0LS5PBWNEw Pycg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=8JpPQBwk+OrlXTMTvMF6H0cxWJyXHVnETTAHv+cZr6w=; b=Ekz0kl19Ah+g4JcAvqKVieGbjHSX1c71eBisiKaFSborjC/TaeTuuSn8l61u4/7uGG L4VFOTaR0zWjxG4rWZOQtd9FcEvKDYmu6+UaE8u3n01XGuTGaZaaIg+c2Cf+PfhPUKiX hsOrqssIcnurzhB88Up3eg5L2hGis9AMoVUF4cGqMHdsUQ9U1SVE38RMH0wGMnxzeMRE JrvsK+GpfKqSNtZK+jkivEp46HPztlrbHkvKN0NGAfD4fj3Wb+z+QsiEzOxeFtwFTFwU bQQwNvUVRxA+BvxYzGR9v8q/YWZlo8a/qJW0T00BE/+AGHyQJPgJkQTBitkUhbRY/zvX TsyQ== X-Gm-Message-State: ALKqPwcdK2oQb4ndbmKolXf1l/tQgfupYJ7q3kwBSfUm8rWu0DnQradh CeoEm0eP7XA6LKB/7VDOsWGQFw== X-Google-Smtp-Source: AB8JxZoR+Sy0GT3FppnHhrdMra61ASvQ2GfXXoVJMlQ7++lBLrUMgrW3B1u4SlzcdEaDmDf6VXpxrA== X-Received: by 2002:a50:8343:: with SMTP id 61-v6mr19913966edh.48.1527611985223; Tue, 29 May 2018 09:39:45 -0700 (PDT) Received: from localhost ([2a02:8084:4f41:8c80:9c34:da08:a010:edfc]) by smtp.gmail.com with ESMTPSA id c7-v6sm17655822edi.79.2018.05.29.09.39.44 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 29 May 2018 09:39:44 -0700 (PDT) From: "Basil L. Contovounesios" To: Drew Adams Subject: Re: bug#31628: 26.1; Problem in read-multiple-choice's docstring References: <87lgc3pzxf.fsf@cassou.me> <877enn64de.fsf@tcd.ie> <17f558ca-75b4-4787-ad48-b99559598b6a@default> Date: Tue, 29 May 2018 17:39:43 +0100 In-Reply-To: <17f558ca-75b4-4787-ad48-b99559598b6a@default> (Drew Adams's message of "Tue, 29 May 2018 06:49:37 -0700 (PDT)") Message-ID: <87vab6h0vk.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 31628 Cc: Damien Cassou , 31628@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 (-) Drew Adams writes: >> Technically, a list of (A B C) is as much an alist as a list of (A . B), >> but I agree that the docstring can be clarified a bit. > > No - assuming you mean that A, B, and C are elements of the > list and they are atoms, not cons cells. You misunderstood the wording that Damien and I used. We both referred to lists *of elements* (A B C), not lists *of form* (A B C). In other words, (A B C) and (A . B) describe the structure of the list's elements, not that of the list itself. The preposition "of" in "list of (A B C)" totally disambiguates this distinction for me; if the wording is not as clear to others, then perhaps someone will suggest an improvement. -- Basil From unknown Sat Jun 21 10:38:47 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 27 Jun 2018 11:24:05 +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