From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#24663: 24.5; doc string of `completion-at-point-functions' Date: Thu, 13 Oct 2016 23:06:09 +0300 Message-ID: <83eg3k815a.fsf@gnu.org> References: <<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default>> <<83fuo088wa.fsf@gnu.org>> <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1476389247 10323 195.159.176.226 (13 Oct 2016 20:07:27 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 13 Oct 2016 20:07:27 +0000 (UTC) Cc: 24663@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 13 22:07:23 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 1bumHf-0001Xa-4L for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 22:07:19 +0200 Original-Received: from localhost ([::1]:42767 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumHd-0004KE-IG for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 16:07:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39902) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumHS-0004JS-QS for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:07:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bumHO-0001lV-IY for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:07:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48329) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumHO-0001lR-Fc for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:07:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bumHO-0007b8-BM for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:07:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 13 Oct 2016 20:07: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-submit@debbugs.gnu.org id=B24663.147638920629183 (code B ref 24663); Thu, 13 Oct 2016 20:07:02 +0000 Original-Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 20:06:46 +0000 Original-Received: from localhost ([127.0.0.1]:54519 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumH7-0007ac-TA for submit@debbugs.gnu.org; Thu, 13 Oct 2016 16:06:46 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:48740) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumH5-0007aQ-Tr for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 16:06:44 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bumGx-0001bL-OX for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 16:06:38 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53957) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumGx-0001bF-LX; Thu, 13 Oct 2016 16:06:35 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1261 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bumGt-0004J1-Qi; Thu, 13 Oct 2016 16:06:34 -0400 In-reply-to: <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> (message from Drew Adams on Thu, 13 Oct 2016 12:46:19 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:124447 Archived-At: > Date: Thu, 13 Oct 2016 12:46:19 -0700 (PDT) > From: Drew Adams > Cc: 24663-done@debbugs.gnu.org > > > 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? The one at point. > You can get different kinds of thing at point. You must provide > the desired THING type, for "thing at point" to mean anything. My understanding is that it's up to the hooks. > 2. I don't see how/why saying "entity" changes anything, here. > "THE" entity? What is that? Then I guess I will say that I don't want to fix that part. > 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. The doc string doesn't say "text", it says "entity". IOW, it doesn't talk about characters.