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 09:47:41 -0700 (PDT) Message-ID: <4fe19dae-4269-401b-82bd-10f9d368a921@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> 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 1444927761 13134 80.91.229.3 (15 Oct 2015 16:49:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 15 Oct 2015 16:49:21 +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 18:49:06 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 1Zmli8-0000C7-NO for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 18:49:00 +0200 Original-Received: from localhost ([::1]:48662 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmli7-0004N4-Vh for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 12:48:59 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48941) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZmlhF-0004Jd-3u for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 12:48:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZmlhC-0000wO-Dk for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 12:48:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33609) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZmlhC-0000wK-AO for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 12:48:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZmlhC-0004Bb-2T for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 12:48: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 16:48:02 +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.144492766816072 (code B ref 21644); Thu, 15 Oct 2015 16:48:02 +0000 Original-Received: (at 21644) by debbugs.gnu.org; 15 Oct 2015 16:47:48 +0000 Original-Received: from localhost ([127.0.0.1]:52550 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zmlgy-0004B9-1X for submit@debbugs.gnu.org; Thu, 15 Oct 2015 12:47:48 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:18256) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zmlgv-0004B0-F9 for 21644@debbugs.gnu.org; Thu, 15 Oct 2015 12:47:46 -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 t9FGlgAX023689 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 15 Oct 2015 16:47:43 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t9FGlgcQ006510 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 15 Oct 2015 16:47:42 GMT Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t9FGlgXG023515; Thu, 15 Oct 2015 16:47:42 GMT In-Reply-To: <561FC52F.1010606@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:107649 Archived-At: > > Yes and no, IMO. `Basic Completion' certainly provides > > some information about "completion, COLLECTION, and > > PREDICATE." But for 3 other functions, not explicitly > > for `completing-read' - it is not even mentioned there. >=20 > What's not mentioned? Basic Completion mentions the three key functions. Please reread what I wrote. I said that `completing-read' is not mentioned in node `Basic Completion'. And it is not. > > As was suggested earlier (see above), node `Programmed > > Completion' is where we should send someone for information > > about a function-valued COLLECTION argument. >=20 > Basic Completion references Programmed Completion, twice. So what? 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'. That is specifically the purpose of that node. And that is the _only_ place that info is provided. > On the other hand, Programmed Completion assumes that the collection is > a function from the outset. This is not necessarily true in completing-re= ad. No one said that that is true. This bug is about that particular case. The point is that mention of a function-valued COLLECTION in the doc string should get readers to `Programmed Completion'. Read what I said. I did not say that we should send users to `P. C.' for general info about COLLECTION. I said: `Programmed Completion' is where we should send someone for information about a function-valued COLLECTION argument. ^^^^^^^^^^^^^^^ And I said, regarding general info about COLLECTION: It doesn't hurt to send them to both nodes or to only their parent, `Completion'. What is inadequate for the function-valued COLLECTION case, is to send readers __only__ to `Basic Completion'. Especially with no indication that they need to consult not only `all-completions' and `try-completion' there, but also `test-completion'. That's the missing info, if you send them only to `B. C.': no info that `test-completion' is relevant to the function-valued COLLECTION case for `completing-read'.