From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#24663: 24.5; doc string of `completion-at-point-functions' Date: Thu, 13 Oct 2016 12:46:19 -0700 (PDT) Message-ID: <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> References: <<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default>> <<83fuo088wa.fsf@gnu.org>> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1476388054 5696 195.159.176.226 (13 Oct 2016 19:47:34 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 13 Oct 2016 19:47:34 +0000 (UTC) Cc: 24663-done@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 13 21:47:30 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bulyF-0007U5-14 for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 21:47:15 +0200 Original-Received: from localhost ([::1]:42714 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bulyD-0000bZ-Hp for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 15:47:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36482) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1buly7-0000bT-5p for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 15:47:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1buly2-0004H9-Uu for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 15:47:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48320) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1buly2-0004H1-SM for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 15:47:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1buly2-00078P-IB for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 15:47: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, 13 Oct 2016 19:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24663 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24663-done@debbugs.gnu.org id=D24663.147638799327388 (code D ref 24663); Thu, 13 Oct 2016 19:47:02 +0000 Original-Received: (at 24663-done) by debbugs.gnu.org; 13 Oct 2016 19:46:33 +0000 Original-Received: from localhost ([127.0.0.1]:54510 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bulxY-00077g-VC for submit@debbugs.gnu.org; Thu, 13 Oct 2016 15:46:33 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:41517) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bulxW-00077R-W1 for 24663-done@debbugs.gnu.org; Thu, 13 Oct 2016 15:46:31 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u9DJkOHM022455 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 13 Oct 2016 19:46:24 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u9DJkNTK012425 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 13 Oct 2016 19:46:24 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u9DJkKhc016517; Thu, 13 Oct 2016 19:46:21 GMT In-Reply-To: <<83fuo088wa.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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" Xref: news.gmane.org gmane.emacs.bugs:124446 Archived-At: > > 3. "the thing at point" means nothing. Thing at point means something > > only for a given type of THING. There is not just one ("the") thing > > at point. > > > > Presumably what is meant here is not a thing at point but some text > > preceding point. It is some text before point that is completed. >=20 > I don't understand what are you saying here. Sure, it's some text at > point, but the form of that text might describe a symbol, an > expression, a string, etc. >=20 > I changed that to say "the entity at point" because the rest of the > doc string refers to that. 1. It cannot be "THE" thing (or THE entity) at point. Which one? You can get different kinds of thing at point. You must provide the desired THING type, for "thing at point" to mean anything. How is the type of thing (or entity) decided, here? If the user is not specifying it (which I think is the case) then the doc should say something about how the type is chosen. 2. I don't see how/why saying "entity" changes anything, here. "THE" entity? What is that? 3. It is not text AT point that is completed. It is text BEFORE point that is completed. AT can only refer to characters after point, not before.