From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#21644: 24.4; completing-read acts differently on functional collection Date: Thu, 15 Oct 2015 13:28:50 -0700 (PDT) Message-ID: <917e38a9-d74b-4e41-bc7b-90aeee69584c@default> References: <5615A2EA.4@thompsonclan.org> <87vbahmzwd.fsf@gmail.com> <561C5D0B.9070303@yandex.ru> <561C5FB0.6030105@thompsonclan.org> <561C6C12.20803@yandex.ru> <561D54AF.7090701@thompsonclan.org> <561F35AD.8000803@yandex.ru> <561FC52F.1010606@yandex.ru> <4fe19dae-4269-401b-82bd-10f9d368a921@default> <561FDC63.6010609@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1444941011 4769 80.91.229.3 (15 Oct 2015 20:30:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 15 Oct 2015 20:30:11 +0000 (UTC) Cc: 21644@debbugs.gnu.org To: Dmitry Gutov , "Ryan C. Thompson" , Oleh Krehel Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 15 22:29:51 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Zmp9p-0007en-Ed for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 22:29:49 +0200 Original-Received: from localhost ([::1]:49525 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmp9o-0006Ae-OK for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 16:29:48 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57158) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmp98-0005eS-Fm for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 16:29:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zmp94-0006Oa-EG for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 16:29:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33739) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmp94-0006OW-AT for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 16:29:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Zmp93-0000vP-U3 for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 16:29:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 15 Oct 2015 20:29:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21644 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21644-submit@debbugs.gnu.org id=B21644.14449409383546 (code B ref 21644); Thu, 15 Oct 2015 20:29:01 +0000 Original-Received: (at 21644) by debbugs.gnu.org; 15 Oct 2015 20:28:58 +0000 Original-Received: from localhost ([127.0.0.1]:52680 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zmp8z-0000v8-T3 for submit@debbugs.gnu.org; Thu, 15 Oct 2015 16:28:58 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:45991) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zmp8x-0000ux-To for 21644@debbugs.gnu.org; Thu, 15 Oct 2015 16:28:56 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t9FKSpp5019548 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 15 Oct 2015 20:28:52 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t9FKSpfO011094 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 15 Oct 2015 20:28:51 GMT Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t9FKSpY6009783; Thu, 15 Oct 2015 20:28:51 GMT In-Reply-To: <561FDC63.6010609@yandex.ru> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:107659 Archived-At: > > If the bug is that a user will not know the details for a > > function-valued COLLECTION argument to `completing-read' then the > > right place to send a reader for __that information__ is node > > `Programmed Completion'. >=20 > _This_ bug was about that. That doesn't mean we should fix it by > introducing another bug. No one has said anything that would introduce another bug. It's about fixing this bug, by getting users to the information about function-valued COLLECTION. And that info is in node `Programmed Completion'. No one has said that users should not consult `Basic Completion' for info about `all-completions', `try-completion', and `test-completion'. > > And I said, regarding general info about COLLECTION: > > It doesn't hurt to send them to both nodes or to only > > their parent, `Completion'. >=20 > I think that asking the user to read the whole Completion section is too > much.=20 No one is asking users to read the whole `Completion' section. That is the section that covers all of the info about `completing-read', _if_ you insist on pointing to only one section. If you send them to only one section then a section that talks only about the low-level functions `*-completion[s]' is not the right destination. Again: "It doesn't hurt to send them to both nodes". > Basic Completion already contains the necessary information, No, it does not. It says *nothing* about `completing-read'. Doesn't even mention it. > or links to it. As does `Completion'. Really what should be done is to link from the `completing-read' doc string only to node `Minibuffer Completion', which is the node that documents `completing-read'. But that node should document COLLECTION (it does not), and that doc of COLLECTION should point to node `Programmed Completion' for details about function-valued COLLECTION. It is a bug (IMHO) that the node that documents `completing-read' does not specify parameter COLLECTION - which is arguably the *most important* parameter. Fix that bug and link to node `Minibuffer Completion' from the doc string, and you will have fixed this bug as well.