Received: (at 76199-done) by debbugs.gnu.org; 11 Feb 2025 14:44:49 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 09:44:49 2025 Received: from localhost ([127.0.0.1]:55423 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thrVJ-0000bX-D8 for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:49 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:52530) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thrVG-0000bE-SQ for 76199-done <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:47 -0500 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 <eliz@HIDDEN>) id 1thrV2-0005o4-PH; Tue, 11 Feb 2025 09:44:40 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=DWPMLcJkC+ATHDoV+y4EL1K1oQtefTJwfmzi9ycJKKo=; b=Ir3vfaIDFUN0 UC4eq/FMLMckv4Nq9Dw0igfdUv2g6j89oeYjxEFvWNTk7gdJjP6VEQf/+khQqB4jto40dsQmfdXgj VkI065xN7u2+K9X0C57Zj6di8N9U9cp3AZX04r2/KE0ummEH8p5tjqj4f/hqeYy6NrfrnVCwoboGJ 5gtUQhDe8yjYSRtG6UF8o/iLanKUFl6hfEqh1uHGM1VI9NUH/J/Ye/uZZCcQenmXp9DEs86W/We5S q0YuMv1yVT7DJsau2tpjDsmDy6Ww/wFG8JpQj9T/a+4F6swTWZXm4rDoEPMXY4gGjWvpXkMlLxCJX 3TGX4To1XhzzgM/eGdKO7Q==; Date: Tue, 11 Feb 2025 16:44:22 +0200 Message-Id: <86o6z8wng9.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Daniel Mendler <mail@HIDDEN> In-Reply-To: <87lduch96e.fsf@HIDDEN> (message from Daniel Mendler on Tue, 11 Feb 2025 15:01:45 +0100) Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN> <87lduch96e.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 76199-done Cc: 76199-done <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Daniel Mendler <mail@HIDDEN> > Cc: 76199 <at> debbugs.gnu.org > Date: Tue, 11 Feb 2025 15:01:45 +0100 > > Eli Zaretskii <eliz@HIDDEN> writes: > > > We could also compromise: mention the function's existence in the > > manual, but leave out its description (if that will just repeat what's > > in the doc string, it's just redundant). > > This sounds like a good compromise. A short notice mentioning > `completing-read-multiple' below the documentation of `completing-read' > should suffice. Thanks, now done on the emacs-30 branch (with the wrong bug number, sorry), and closing the bug.
Daniel Mendler <mail@HIDDEN>
:Eli Zaretskii <eliz@HIDDEN>
:Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:22:25 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 09:22:25 2025 Received: from localhost ([127.0.0.1]:55283 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thr9d-0007mh-61 for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:22:25 -0500 Received: from mout.gmx.net ([212.227.15.18]:43971) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <dimech@HIDDEN>) id 1thr9a-0007mQ-DH for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:22:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.com; s=s31663417; t=1739283716; x=1739888516; i=dimech@HIDDEN; bh=UHJpxMq+MoksfJHs3RiDP7456C4pAMvUhvHBVLMMNRM=; h=X-UI-Sender-Class:MIME-Version:Message-ID:From:To:Cc:Subject: Content-Type:Date:In-Reply-To:References: Content-Transfer-Encoding:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=D/jlr5Gs3w7yrfB58bUF7NOO7Liwp3hR+UpdhATAQWktgRJn3XU20FDsltKFVGoJ qfKb8JasG7sv6zFgkaVcZDGICsx3JonJ1eC6vBdPAcAJAuBUU9Sb5LBwFhF9XKApA 7E7EOUlpT6G568D9LbZw+WncAaWQ+gFQ7+vVzM+X1wYeu+X08ZFbfoY1f3UPMlzjE vSEcL9iRw7fVsZVC17f76qQJzH4L+oWDR5ujaxZ5ncAar50HBdQ3z2Meoaie+np6g /K8SmfIAwCbwKMIMUCJN0nRo1yuTj08ZjbqXgPdJI6N46eenYxPr3ANiKBw6JiLYl w7DazkEmTUfPtPGf+g== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from [77.71.252.27] ([77.71.252.27]) by web-mail.gmx.net (3c-app-mailcom-bs11.server.lan [172.19.170.179]) (via HTTP); Tue, 11 Feb 2025 15:21:55 +0100 MIME-Version: 1.0 Message-ID: <trinity-f0052c23-5534-40fc-921d-1c9cfd6d6613-1739283715807@3c-app-mailcom-bs11> From: Christopher Dimech <dimech@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual Content-Type: text/plain; charset=UTF-8 Date: Tue, 11 Feb 2025 15:21:55 +0100 Importance: normal Sensitivity: Normal In-Reply-To: <86pljowprv.fsf@HIDDEN> References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com> <86pljowprv.fsf@HIDDEN> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:eoNgbQCBD/UMZVCc0Ddg7BAhSNiMUQkZ/f8qE8kjkigkuEn51FdbU9HzRMluRd29+QW9x jHn3gyqTMcCu2HXMptOJrJnf4PaOOZtdJ06ADsEZEboB0Qz3sXw/ZrMfWoTYsDD8u6Gv0zyv0eHM aEMAhNUv0r/K2y0zvhWnljaOBr91H12aXMOZ9WZCIveYoZx/zL53jNSyzP2V5bopfSF1p0T9xaFP wh5wZEr39AE8XJjcIVG80ZwWDRlAI6cYOEP6rhw05wlWDXoXHRto5r8iKJGAgz8k+Wt/VjM9gLH9 /4= X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:5jqqCP1SFxM=;6Tix5iVUmo6bcOAFAFFw15Tk9yn ztEJk5dVOqoE9r3Hg6TdL168k5I6W0B2bvCyMg6FGku3Fc1a3QVMgSI1KVpRQHnPSkvBiN3dx qYd6rKT6sUaK+7lAOLY5JjDDx/mmdajLsUuPkMAE8rwt93cffGIeMgscPfMiDg8dF9qOOCEbu XZwsaulp1RqZzhLxgGrgx1fm+R3b04yl1K4IolrbTRYoxacQ9XbMLP/1nZI2uZCvCqVcum8ij e1fWdavlhUSTt0vB9MM4bHms7iMdd1RNfTx5wPb0PUv7Kn9zSYpYsQ23rI2COEMI5epISa57w Ai5Ghe6QCU7I/k3b/zGfsrZgNFYOzwS/I5pdF/PoSftu+UDNczSfS0i5oBnaY9A5yEO0B7iNb ZyUqTVsma4EZvLlgw7Xy/WzX6dHVCKsq6ZMfB+IFwns/6mWKhVdF9Y9HPWQqbKudM0j4WMwsc chxRxO8cuUeMKTwZ+1l+yuRys4tYr6BP6QRcsKR6ucql2IXKOoyR28O98YQKeZUFv2Wx+MvjT 3y8v2BBlWCVcsv8slKGNlrbj6HtasaxnXyFd9wuGVmaopxGKGaqrQNARUtElkUQ4micbhHGY2 TfmdxSeDrng2VA/g20L51SVeUiJSsjpJz2o7yIEoqih0HF1wF5X22Pqf3Y5jUGCz1YNH+AI6V N30I2ZtWOupVJ4P3jBGKSfflpliUdu+qIEmtLUDhQr+K8jFi/i+LG0bNu7WvSKRyrJygkBpX4 nkDNAdCPao/EPPl50b4174fle1qDkM4lBG4mn4gUGZXvjm2AEa49htIyptV++IVzRbrBMmd0Z lv+mHpyv2hcZyYJ3KKBWfVgdaaQ6jPvoc0iRAnyd2KO7BIfkqCCL5ucacIEc2J+lmlOBU4hEc PBuCwBOt5rELIaqKkIuwnaRIakjSiAi6efrgfxyuV2267vdHVaaI8ZC2CzmDPfmT2iGlH9Jpg rwncSpH3pIX0BciqFESBkmLC91Z5B/w5AhjFyf74IogXIGbUeQtetT5qLXRg5wVx/4BLoIKe3 Ls578CAVR3b23MzZJLdJjY3OLmBMlRQuT6NUfg4NLDaO9fULXXNBQihBKyLOXs3599kIGvtjb zcC1B8olUOeqsMkoLBS9gnQ86wZOwDAFz+AFKkmQGJ6IUTXYE6PQWED1NWz1U6lAFOM8hVgvA qcs6OpA8SOL5GXPP2WI1q3KCXGxaRkCuNu+et1H62N1BFPA+q25gGfADW3CgZSqoCakcEE+/t S9e71HMVI3KotXVsdUCCzX4mFLobhMA0iQ== Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 76199 Cc: mail@HIDDEN, Heime <heimeborgia@HIDDEN>, 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.7 (-) > Sent: Wednesday, February 12, 2025 at 1:54 AM > From: "Eli Zaretskii" <eliz@HIDDEN> > To: "Heime" <heimeborgia@HIDDEN> > Cc: mail@HIDDEN, 76199 <at> debbugs.gnu.org > Subject: bug#76199: 30.0.93; completing-read-multiple is not documented = in the manual > > > Date: Tue, 11 Feb 2025 13:40:23 +0000 > > From: Heime <heimeborgia@HIDDEN> > > Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org > > > > > We don't necessarily document every function. Is this one important > > > enough to be in the manual? > > > > I have used it, and would like it to be in the manual. > > That's not a sufficient reason to add it, sorry. > > You need to realize that the ELisp manual is already too large: it > prints in 2 volumes, each volume weighing in at hundreds of pages. So > we must be judicial in our decisions to add new stuff there. The manual is not being read as a book but to get information about some specific feature that makes it easier to use than looking at docstrings. The trend is towards a good automatic query search. The only thing that should happen is for the manual to increase in volume rather than reduce. One suggestion would be to have the manual categorised, so one does not ha= ve to search through its entirety to look at information on same aspect.
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:07:16 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 09:07:15 2025 Received: from localhost ([127.0.0.1]:55255 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqux-00073c-HM for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:07:15 -0500 Received: from mout.gmx.net ([212.227.15.15]:45319) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <dimech@HIDDEN>) id 1thquv-00073N-85 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:07:14 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.com; s=s31663417; t=1739282805; x=1739887605; i=dimech@HIDDEN; bh=8Of/xAysZC3CbPI0M4My1JGWEfkQexEAdRo/o9sniug=; h=X-UI-Sender-Class:MIME-Version:Message-ID:From:To:Cc:Subject: Content-Type:Date:In-Reply-To:References: Content-Transfer-Encoding:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=QA6uT3QPly+sdhJ5FQ6WglH8d0QtdxTIJP1+lZaAaNemFvVcxRibc1NA/VrVS/LM Pob36praeSdDCx7nYt4vhfiOxpKsnxO7XtR6AXJ6sDj/DjzmrtzRN7b9pvm/6+3ZX 4MliRNKHj3M033OL0hNpsmtZK6vzE8/9gelqGCVxXSaoWVz6dZEyinSsQC2WRnkNe 4gYbBx/ERY5NIqjm3Rmvq5RAMwQRDUsONclx73mkPB4RRCuA3baBtJWnVpZ+DmZJZ RqodyR7J1vcXJ/p29PdUUo2u5QLE11G9a1FYjoGgLiciEBqfLIMJgTUrLTOXLHe28 FYm5wEMXJsHQJzix3w== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from [77.71.252.27] ([77.71.252.27]) by web-mail.gmx.net (3c-app-mailcom-bs11.server.lan [172.19.170.179]) (via HTTP); Tue, 11 Feb 2025 15:06:45 +0100 MIME-Version: 1.0 Message-ID: <trinity-8754233d-a709-42fc-867f-52976a2b4347-1739282805622@3c-app-mailcom-bs11> From: Christopher Dimech <dimech@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual Content-Type: text/plain; charset=UTF-8 Date: Tue, 11 Feb 2025 15:06:45 +0100 Importance: normal Sensitivity: Normal In-Reply-To: <86r044wpvw.fsf@HIDDEN> References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:g1q5WdV9zFvU2HbwtDGV4Z8OBZOMkDFzkRIYjQ8cbiWVme+Zym/szx+q+fvcEJJui+CI9 hdnptoC2kLgyR1yja+IFP2pxJ5+AApY0likOHwI6twPdorFsPscqTybNIRh0BCIiP+HmS79JvApY 0DCWPbDlleG8WMDRoK6W5fwKvzXnMB+7YJcVZczDRePntjh802RMDmgjNaPEqgliYwURkhRRgXvQ FjFmD8lfaerFjmIBKhBuzeHIMfSMKT4miUoEbZfj0JmGq3z5Bu+ellVtlXraK/LhsJWeEB1mfxqk 54= X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:pd7tVBbE8S8=;3vjqoijMoH7WjWfmkrB3pC8kgUT n5Oq3V8v0RbxqUJjNulmH5w5TDnbXawtCuJ+fsqsUgmsa2BJoBBLepzS2Bws1yn3s8MyPAgvi w1go6L0Ttve28W5RZFtms0JVneQ+Inj3RxbPyomeOR9RQ105F6xgwKgaHuTZuiuuE9JXV4T1z fTYDysWffXR+s8vXdJABxNcJsO7eY4mb4w5lyweVv3D2lDVeQyND7yJtfbASTapACrj0YCGoE DPVJ73gi7zYlz7qVwYuv68H8vMBQB2bmk+NH/lGl2eyqjsdR68kvlGQSnzeJqbqD+GE1pFLFq jh8gUvEWrtb1zPwmrtmY4I97zKRxYZPydJDDulaboSfQB5Q7ZcJJz6CHfcRbTuW7tTnrBn9Qq 3NLBcbNzqWOcvd7YGHSIz6PoGufW/99luS7lWLoJxJBFQl1/gIYBOo2z96NoekodpK50bA+g0 I9YG+1X1Pyd7NGngXCBDMLElEnICi/kHLZ4Go6ZXHzOOEsUWKDB49kZE65pQXvcAP98Pz3RHK 92q5KQrja3ycuyRe+5tAwzLizsuyJx+i+vzDd/UgrA2JxkpjbaaxLZgCnfGL6uNV82ldGKOWC FVV1+sBvBZaX5spB0zzOSGBCu1K50Jyxo7d8ms0t7tFpe88e5ZeSWY7GWPy4Vyc9kM+J6AJ+p Q+Q1/PKfKFZmVA3bStp98BTi3mJfk/orO2NVJwVpbobdJfARJNMFWPk7GDy9xqNlE4UFTnnqS Kay4la+pybmUY8eKo8EUZ7vhRcAu5kp4kjP9E8eAzo7zd7XUJJRXp9/hnPaUnoYIF72Z0y9MB +J9ESbA9AEdYrBgJSSF7k+G3BPNEQBAZARDkpdAWElFjBwS4VieY/ntBRRheOnw+1t+9iZQvl a6gV7r+CINgZwwntPl+XohX5sHtcm4quGez2ATz7fhUNJF9/fKN6j16KpqWizll5z658tfp1w EH/6mxH/8Lb35QDzTILb3h+QrGnH7HEVEq3S+EsdAVQzWnbMAuNhd1FXrc5yGEZgS4G/Cx/Zx Grqt+i6dbyRYh2D7Fb3p3UWiV2qqIHP/lBnCcoDNVPrjVF6KBcnJXjXtQFIdZJPFV9xYtgb1W toi+qNXb1dcuBQQ6z8Kn7F9/U1iJpQZtiqF/0gdOr/fVYldMj7D13T9vzlkdzpWsSub8dDRXE JptQGPCoZHqTBt00S+77yFQey5w4Z3CDr2h19a/XbMHB+FSmtrekmje6kNetQDI4n9FeTzth9 S3NC8uX0mmdK9q6UECSSsHoEp9IjskirxA== Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 76199 Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.7 (-) > Sent: Wednesday, February 12, 2025 at 1:51 AM > From: "Eli Zaretskii" <eliz@HIDDEN> > To: "Daniel Mendler" <mail@HIDDEN> > Cc: 76199 <at> debbugs.gnu.org > Subject: bug#76199: 30.0.93; completing-read-multiple is not documented = in the manual > > > From: Daniel Mendler <mail@HIDDEN> > > Cc: 76199 <at> debbugs.gnu.org > > Date: Tue, 11 Feb 2025 14:37:56 +0100 > > > > Eli Zaretskii <eliz@HIDDEN> writes: > > > > >> Date: Tue, 11 Feb 2025 11:25:24 +0100 > > >> From: Daniel Mendler via "Bug reports for GNU Emacs, > > >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > > >> > > >> Since documentation came up in bug#76028, it seems that > > >> `completing-read-multiple' is not documented in the Elisp > > >> manual, in particular in doc/lispref/minibuf.texi. > > > > > > We don't necessarily document every function. Is this one important > > > enough to be in the manual? > > > > I think so. > > Can you tell why? > > The function is documented in its doc string, so adding it to the > manual needs a reason, like extreme popularity (doesn't seem to be the > case here), or some important aspects of its use that cannot be > easily described in the doc string. > > We could also compromise: mention the function's existence in the > manual, but leave out its description (if that will just repeat what's > in the doc string, it's just redundant). Reference to it in the manual would assist users in discovering additional functionality than figuring them out for themselves. Some information is better than having nothing. Some summary of additiona= l things that go beyond the realm of the manual would be of assistance to us= ers. What do you think about something like the Introduction to Emacs Lisp, but that discusses things that go beyond the manual like new features, popular ways of using things, and so on.
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:01:56 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 09:01:56 2025 Received: from localhost ([127.0.0.1]:55227 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqpn-0006n0-Pg for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:01:56 -0500 Received: from server.qxqx.de ([2a01:4f8:c012:9177::1]:42457 helo=mail.qxqx.de) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <mail@HIDDEN>) id 1thqpk-0006mh-Pz for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:01:53 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date: References:In-Reply-To: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=xjS2rBZBWvSKCOhLVvQD2pwwz5e9QQ0oVtkFpYT6iPI=; b=N0DPwqt/RziYFdqSp7Dc5WAsuC gcqMiqVXLFNCsLbIBvUWaC6UJWwcOZ/YiNsZPrJGxCG/ikh9AwCai+9moTzVRUmC+Tq3cllM9Ig4y 5tuUJO1XNAZgXbC6LwuieZILXsluuzIm7DwkCVNKJok4w5Clss/Lmiro/JDB7vJFZpvw=; From: Daniel Mendler <mail@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual In-Reply-To: <86r044wpvw.fsf@HIDDEN> (Eli Zaretskii's message of "Tue, 11 Feb 2025 15:51:47 +0200") References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN> Date: Tue, 11 Feb 2025 15:01:45 +0100 Message-ID: <87lduch96e.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 76199 Cc: 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.7 (-) Eli Zaretskii <eliz@HIDDEN> writes: >> From: Daniel Mendler <mail@HIDDEN> >> Cc: 76199 <at> debbugs.gnu.org >> Date: Tue, 11 Feb 2025 14:37:56 +0100 >> >> Eli Zaretskii <eliz@HIDDEN> writes: >> >> >> Date: Tue, 11 Feb 2025 11:25:24 +0100 >> >> From: Daniel Mendler via "Bug reports for GNU Emacs, >> >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >> >> >> >> Since documentation came up in bug#76028, it seems that >> >> `completing-read-multiple' is not documented in the Elisp >> >> manual, in particular in doc/lispref/minibuf.texi. >> > >> > We don't necessarily document every function. Is this one important >> > enough to be in the manual? >> >> I think so. > > Can you tell why? It is sometimes useful to complete multiple strings and `completing-read-multiple' is a good tool to do that. So it may be helpful to tell developers about this function. Alternatively one can use `completing-read' in a loop, which I have also seen multiple times in the Emacs code base or external packages. > We could also compromise: mention the function's existence in the > manual, but leave out its description (if that will just repeat what's > in the doc string, it's just redundant). This sounds like a good compromise. A short notice mentioning `completing-read-multiple' below the documentation of `completing-read' should suffice. Daniel
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:54:24 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 08:54:24 2025 Received: from localhost ([127.0.0.1]:55210 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqiV-0006MN-UO for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:54:24 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39134) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thqiS-0006M4-Ra for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:54:21 -0500 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 <eliz@HIDDEN>) id 1thqiN-00042G-9y; Tue, 11 Feb 2025 08:54:15 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=eBcAXh7bMB5bnqMwNVG7QELk8zBpMtKjW0dFODB4PBw=; b=TtyDcpK67DHU ntvZAKaKBkCCQxY6NKwBvVOwNzHeN6KdQ+OndXlaTa/hH3m1n/+KZ0f/u9xrgm7vqGWbspz8v+b1X UcmDcJ+qzpmSap2li54F+99AzUT5wuSpEQAdlUoxOQJ+6AgWr+Kl9QxdZXoZYpJ2R4YkeJ4Yp/BDJ XlYolK5PMA0TLDQo+myWCZPo66bWVrecaT5nassWYhRaBA4bzusOJdPjn41U5Be4g6aWYwtprStCe ZeYoLdRhrXNQ0cyBPduhKpdgszrgbce1pld6HHCPrpofEtzJqqMjDV/ZhYC7WJ2xN7Xwg9sMzKj6H FOjbg7/FOb8m13fSp96fOA==; Date: Tue, 11 Feb 2025 15:54:12 +0200 Message-Id: <86pljowprv.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Heime <heimeborgia@HIDDEN> In-Reply-To: <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com> (message from Heime on Tue, 11 Feb 2025 13:40:23 +0000) Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 76199 Cc: mail@HIDDEN, 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Date: Tue, 11 Feb 2025 13:40:23 +0000 > From: Heime <heimeborgia@HIDDEN> > Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org > > > We don't necessarily document every function. Is this one important > > enough to be in the manual? > > I have used it, and would like it to be in the manual. That's not a sufficient reason to add it, sorry. You need to realize that the ELisp manual is already too large: it prints in 2 volumes, each volume weighing in at hundreds of pages. So we must be judicial in our decisions to add new stuff there.
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:52:16 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 08:52:16 2025 Received: from localhost ([127.0.0.1]:55205 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqgR-0006IQ-K6 for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:52:16 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:45624) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thqgO-0006I0-CG for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:52:13 -0500 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 <eliz@HIDDEN>) id 1thqgH-0003Xj-Iv; Tue, 11 Feb 2025 08:52:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=yQ2DPH9S3HeAr94xHBTRjKKo+58ltwEzQBGFTUZvJZY=; b=Jluy7usPFc2J sr8UYiFIu2vAfSZ5dQZBtPwXQpcyRxANIwU7ZD7JfJp9S86Z7Efou01rl2nxBPkycQjIlpJtrPgL8 C2k1nAOfsd/qilEy+8tKo+65O9f0tk910Lcc5hEfPzOPxJfWrhckPUAgkHitqojGJ5vt0nvP0JmrW l7u5kSztiv+/1tTU/RJTjvPlfdo2oCSUGlchSvLdMIiPfMaApoN/roKsLjzvbzzeyjMYNAGbukvLg JZybpX6uiiVbcd5FmcLRmtfCqHqMzwYJh6SLI2UqJV/wYMLBTjbBSeE6cuFG0lJEgiyNDz7sj5aG7 BC64qJkyJd0o9rUIoe2lqw==; Date: Tue, 11 Feb 2025 15:51:47 +0200 Message-Id: <86r044wpvw.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Daniel Mendler <mail@HIDDEN> In-Reply-To: <87pljohaa3.fsf@HIDDEN> (message from Daniel Mendler on Tue, 11 Feb 2025 14:37:56 +0100) Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> <87pljohaa3.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 76199 Cc: 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Daniel Mendler <mail@HIDDEN> > Cc: 76199 <at> debbugs.gnu.org > Date: Tue, 11 Feb 2025 14:37:56 +0100 > > Eli Zaretskii <eliz@HIDDEN> writes: > > >> Date: Tue, 11 Feb 2025 11:25:24 +0100 > >> From: Daniel Mendler via "Bug reports for GNU Emacs, > >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > >> > >> Since documentation came up in bug#76028, it seems that > >> `completing-read-multiple' is not documented in the Elisp > >> manual, in particular in doc/lispref/minibuf.texi. > > > > We don't necessarily document every function. Is this one important > > enough to be in the manual? > > I think so. Can you tell why? The function is documented in its doc string, so adding it to the manual needs a reason, like extreme popularity (doesn't seem to be the case here), or some important aspects of its use that cannot be easily described in the doc string. We could also compromise: mention the function's existence in the manual, but leave out its description (if that will just repeat what's in the doc string, it's just redundant).
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:40:38 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 08:40:38 2025 Received: from localhost ([127.0.0.1]:55142 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqVB-0005jE-WC for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:40:38 -0500 Received: from mail-4325.protonmail.ch ([185.70.43.25]:46095) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <heimeborgia@HIDDEN>) id 1thqV8-0005is-T1 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:40:36 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1739281228; x=1739540428; bh=l8jCQ+0ratvI8UT8Ql6q0xQjelguD6esJKc1JJ9Yn64=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector:List-Unsubscribe:List-Unsubscribe-Post; b=VIwi+p+moS2tGAtBwpEy7bh03xHBA1DMsSPKG7wx+1m2mF02bpY98xqkLhxSxsaQt LKuQsS7R8UYkXAuqb2k8aBXUhqzg7N9CJ8nM0cAjd2sW/rMPiN0cW6oR1hjUm3kX43 qY2LjN2N/x1kEruMRMtUkY5ptX4jU/0/LFEZVdq/9qtyeEit3/xbnvI3W1WFi1Wz32 WojB10RUk3s0+uSWAEVRoXIvKzTWuKpizsddk/udcq/Po2hAR4y+H0k7atJBbyPEs0 m/u/FvEBPKzzugHhVmpNXRwac4pr5fFwNC5/H7stwcJM/eEH2SHUVqC6ftvQLgamj6 kJEFiWBvKoXVA== Date: Tue, 11 Feb 2025 13:40:23 +0000 To: Eli Zaretskii <eliz@HIDDEN> From: Heime <heimeborgia@HIDDEN> Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual Message-ID: <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com> In-Reply-To: <86tt90wqvn.fsf@HIDDEN> References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> Feedback-ID: 57735886:user:proton X-Pm-Message-ID: 1471094b25952fb9d048c0bb8fefa3c13d84a860 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 76199 Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Sent with Proton Mail secure email. On Wednesday, February 12th, 2025 at 1:30 AM, Eli Zaretskii <eliz@HIDDEN> = wrote: > > Date: Tue, 11 Feb 2025 11:25:24 +0100 > > From: Daniel Mendler via "Bug reports for GNU Emacs, > > the Swiss army knife of text editors" bug-gnu-emacs@HIDDEN > >=20 > > Since documentation came up in bug#76028, it seems that > > `completing-read-multiple' is not documented in the Elisp > > manual, in particular in doc/lispref/minibuf.texi. >=20 >=20 > We don't necessarily document every function. Is this one important > enough to be in the manual? I have used it, and would like it to be in the manual.
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:38:08 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 08:38:08 2025 Received: from localhost ([127.0.0.1]:55125 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqSl-0005Yn-Ox for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:38:08 -0500 Received: from server.qxqx.de ([2a01:4f8:c012:9177::1]:39163 helo=mail.qxqx.de) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <mail@HIDDEN>) id 1thqSj-0005YD-0y for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:38:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date: References:In-Reply-To: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=VbiHzEuqQDcNLEHN94rQD13zrfiI17bpTTsHJPugxCw=; b=BpHZZGpaARDg13DuMqGqRYbaGa mm+nFedjSPTA+sway1zO+0kyO2eEpGgX9vubr0tCVvMmSPv1HHZw5/qJT2yc/zbhpYmrTlqRMtTpi /HfUBHtUGKErMDQMx8shk9I27ElbOMWz/RsAQhut6Hq3rBn8f9qc72yTjjWBR4murPuQ=; From: Daniel Mendler <mail@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual In-Reply-To: <86tt90wqvn.fsf@HIDDEN> (Eli Zaretskii's message of "Tue, 11 Feb 2025 15:30:20 +0200") References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN> Date: Tue, 11 Feb 2025 14:37:56 +0100 Message-ID: <87pljohaa3.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 76199 Cc: 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.7 (-) Eli Zaretskii <eliz@HIDDEN> writes: >> Date: Tue, 11 Feb 2025 11:25:24 +0100 >> From: Daniel Mendler via "Bug reports for GNU Emacs, >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >> >> Since documentation came up in bug#76028, it seems that >> `completing-read-multiple' is not documented in the Elisp >> manual, in particular in doc/lispref/minibuf.texi. > > We don't necessarily document every function. Is this one important > enough to be in the manual? I think so. It is not as important as `completing-read' but still useful in scenarios where multiple strings should be read via completion. I can send a patch for the manual if there is interest. Daniel
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:30:33 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 08:30:32 2025 Received: from localhost ([127.0.0.1]:55108 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thqLQ-0005Ez-Ia for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:30:32 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:44748) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thqLO-0005Ec-7D for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:30:30 -0500 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 <eliz@HIDDEN>) id 1thqLI-0005uj-52; Tue, 11 Feb 2025 08:30:24 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=LwZO1Quoe+Pp8Ov252otd8F5ddkDMbGvbv7fuCxT8xU=; b=PjsTGCZvz6eB sK1F9p/BT+q2QnPl4L+qcPLWxBiZKD3d6ZHRXGz7UrJsXfgWmcA645CfHW0gFvrzxjZMYggROrGXz qIlk9jK5XR1rq8PngB+kf88YO6Nk16x2PbLQBztjIcDjKktiiIsh6rRozFTFoxieRpVtLEVY/8kTW GPnm64ciU/W4bVWoX2OUaltcaNpCkKSs5I0Pw5tv3qi/bbwNzYnuWryZYzOHmc9ne+M4RBP9sSYWS TeWb7BCAaZOG4qjaYx4gjaJUbENypM2wGCa9dAS3EMoB1TqpxHboeF8H3Vq8j7U8rO3SWNIDI/XAB djNddTMAyzyx1GNeBCZDqQ==; Date: Tue, 11 Feb 2025 15:30:20 +0200 Message-Id: <86tt90wqvn.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Daniel Mendler <mail@HIDDEN> In-Reply-To: <87seokhj6z.fsf@HIDDEN> (bug-gnu-emacs@HIDDEN) Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual References: <87seokhj6z.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 76199 Cc: 76199 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Date: Tue, 11 Feb 2025 11:25:24 +0100 > From: Daniel Mendler via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > > Since documentation came up in bug#76028, it seems that > `completing-read-multiple' is not documented in the Elisp > manual, in particular in doc/lispref/minibuf.texi. We don't necessarily document every function. Is this one important enough to be in the manual?
bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.Received: (at submit) by debbugs.gnu.org; 11 Feb 2025 10:26:05 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 11 05:26:05 2025 Received: from localhost ([127.0.0.1]:54484 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1thnSv-0006ci-3a for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:05 -0500 Received: from lists.gnu.org ([2001:470:142::17]:34988) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <mail@HIDDEN>) id 1thnSr-0006c6-Oq for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:02 -0500 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 <mail@HIDDEN>) id 1thnSl-0003rc-6y for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:55 -0500 Received: from server.qxqx.de ([2a01:4f8:c012:9177::1] helo=mail.qxqx.de) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <mail@HIDDEN>) id 1thnSh-00007T-SN for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:54 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date: Subject:To:From:Sender:Reply-To:Cc: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=IP7HFaISDGWLdDCbLk7PGWZmBKZdH/2mG7SqaJuizqM=; b=oWV/AhLu1IhVLf/3Bd8ckqgoyZ 81iwCIZKXfgT5UH0dWAfoW2aUfW+Iihd9Q+b7MCCBEirj1Os+ldvZhTTSxbO3OAwdIUP9YjAyrPYq YWvpvwnUCpRSHwL0fT/feQPAkz54fRNMbAtPTLsqatMiJ/7GKnnktFMSHs9Oo+kK5ty8=; From: Daniel Mendler <mail@HIDDEN> To: bug-gnu-emacs@HIDDEN Subject: 30.0.93; completing-read-multiple is not documented in the manual X-Debbugs-Cc: Date: Tue, 11 Feb 2025 11:25:24 +0100 Message-ID: <87seokhj6z.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2a01:4f8:c012:9177::1; envelope-from=mail@HIDDEN; helo=mail.qxqx.de X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -0.1 (/) Since documentation came up in bug#76028, it seems that `completing-read-multiple' is not documented in the Elisp manual, in particular in doc/lispref/minibuf.texi.
Daniel Mendler <mail@HIDDEN>
:bug-gnu-emacs@HIDDEN
.
Full text available.bug-gnu-emacs@HIDDEN
:bug#76199
; Package emacs
.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.