From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#21644: 24.4; completing-read acts differently on functional collection Date: Fri, 16 Oct 2015 00:07:40 +0300 Message-ID: <5620159C.3060401@yandex.ru> 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> <917e38a9-d74b-4e41-bc7b-90aeee69584c@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1444943334 8788 80.91.229.3 (15 Oct 2015 21:08:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 15 Oct 2015 21:08:54 +0000 (UTC) Cc: 21644@debbugs.gnu.org To: Drew Adams , "Ryan C. Thompson" , Oleh Krehel Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 15 23:08:42 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 1ZmplR-00056M-K1 for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 23:08:41 +0200 Original-Received: from localhost ([::1]:49659 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZmplQ-0006dg-RX for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2015 17:08:40 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39005) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmpkt-0006cj-7O for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 17:08:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zmpkp-0003Wl-5j for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 17:08:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33759) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zmpko-0003Wh-VU for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 17:08:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Zmpko-0001pp-ES for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2015 17:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 15 Oct 2015 21:08: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.14449432667025 (code B ref 21644); Thu, 15 Oct 2015 21:08:02 +0000 Original-Received: (at 21644) by debbugs.gnu.org; 15 Oct 2015 21:07:46 +0000 Original-Received: from localhost ([127.0.0.1]:52700 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZmpkX-0001pE-Iw for submit@debbugs.gnu.org; Thu, 15 Oct 2015 17:07:45 -0400 Original-Received: from mail-lf0-f47.google.com ([209.85.215.47]:36252) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZmpkU-0001p5-U5 for 21644@debbugs.gnu.org; Thu, 15 Oct 2015 17:07:43 -0400 Original-Received: by lfeh64 with SMTP id h64so46809756lfe.3 for <21644@debbugs.gnu.org>; Thu, 15 Oct 2015 14:07:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-type:content-transfer-encoding; bh=SUV8YlCYyZuQguHYCKU9SGu/j6CfkntyG4758QWxSTY=; b=ajOSZokONOCTWkzrJwZil2+tIuBcvEAh5dHOL9IAoYuMH7s8fo8TWOfpdhqLN3AO8h D+aCd30y+JtArHd0w2FkmJbTXXZjsIDGlTnecY0dVJTvEHWY19l8sT+NR7RKj7h1h5bE q0E0/4dk4uCqshZKelEsFqNmiHp/gTD+GZgL0OP0Ks2JcbiihaGKM52KULUsNfCQKvKs C0y2YWjefSQflveUsRWPXrIgQpZdGK1mIoRAOG8AU0EvqMlSvXNUx48+VrunWJqmbHZn peuVXRTcXoZ42OvDEgWS2SmiEF7tGbzFqaCtyLT54QVlv1/ao2SNlpdaxe9G8JHNDQd2 e6+Q== X-Received: by 10.180.102.230 with SMTP id fr6mr804545wib.66.1444943262080; Thu, 15 Oct 2015 14:07:42 -0700 (PDT) Original-Received: from [192.168.1.2] ([185.105.175.24]) by smtp.googlemail.com with ESMTPSA id gt4sm578266wib.21.2015.10.15.14.07.40 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 15 Oct 2015 14:07:41 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:42.0) Gecko/20100101 Thunderbird/42.0 In-Reply-To: <917e38a9-d74b-4e41-bc7b-90aeee69584c@default> 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:107660 Archived-At: On 10/15/2015 11:28 PM, Drew Adams wrote: > 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'. The current sentence that refers to the Info node would become wrong. But I suppose an alternative wording might escape that problem. Patch welcome. > 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 link to Completion as a whole, the user might not know better than to read it all. > 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'. I don't know about that: that page basically re-tells the docstring of completing-read. Sending to it from that docstring seems redundant. > It is a bug (IMHO) that the node that documents `completing-read' > does not specify parameter COLLECTION - which is arguably the > *most important* parameter. You're probably right. Please send a patch.