From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 10 17:15:12 2016 Received: (at submit) by debbugs.gnu.org; 10 Oct 2016 21:15:12 +0000 Received: from localhost ([127.0.0.1]:51513 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bthui-0003yT-JB for submit@debbugs.gnu.org; Mon, 10 Oct 2016 17:15:12 -0400 Received: from eggs.gnu.org ([208.118.235.92]:55549) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bthug-0003yF-Ti for submit@debbugs.gnu.org; Mon, 10 Oct 2016 17:15:11 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bthua-0003jj-P5 for submit@debbugs.gnu.org; Mon, 10 Oct 2016 17:15:05 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:55163) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bthua-0003jX-Ly for submit@debbugs.gnu.org; Mon, 10 Oct 2016 17:15:04 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46502) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bthuY-0005QY-HB for bug-gnu-emacs@gnu.org; Mon, 10 Oct 2016 17:15:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bthuU-0003hh-Ft for bug-gnu-emacs@gnu.org; Mon, 10 Oct 2016 17:15:02 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:32206) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bthuT-0003gd-Tl for bug-gnu-emacs@gnu.org; Mon, 10 Oct 2016 17:14:58 -0400 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 u9ALEsf3012327 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 10 Oct 2016 21:14:55 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u9ALEsUb025537 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 10 Oct 2016 21:14:54 GMT Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u9ALErb7014621 for ; Mon, 10 Oct 2016 21:14:54 GMT MIME-Version: 1.0 Message-ID: <2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> Date: Mon, 10 Oct 2016 14:14:52 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.5; doc string of `completion-at-point-functions' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) 1. Some lines are too long. Please use fill-column=3D70 for ordinary paragraphs. 2. Typo: "in turns" should be ", in turn," (no "s"). 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. 4. Add a comma after "nil". 5. Typo: "function of no argument" should be "function of no arguments". 6. " where" should be ", where:" (and that sentence is run-on (too long). 7. "responsible to preserve" should be "responsible for preserving". In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32' From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 13:19:06 2016 Received: (at 24663-done) by debbugs.gnu.org; 13 Oct 2016 17:19:06 +0000 Received: from localhost ([127.0.0.1]:54448 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bujes-0003SG-4m for submit@debbugs.gnu.org; Thu, 13 Oct 2016 13:19:06 -0400 Received: from eggs.gnu.org ([208.118.235.92]:35572) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bujer-0003Rm-0A for 24663-done@debbugs.gnu.org; Thu, 13 Oct 2016 13:19:05 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bujei-0006xG-Ig for 24663-done@debbugs.gnu.org; Thu, 13 Oct 2016 13:18:59 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.4 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:51980) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bujei-0006wv-Ep; Thu, 13 Oct 2016 13:18:56 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4745 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bujeg-0006km-O4; Thu, 13 Oct 2016 13:18:55 -0400 Date: Thu, 13 Oct 2016 20:18:45 +0300 Message-Id: <83fuo088wa.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> (message from Drew Adams on Mon, 10 Oct 2016 14:14:52 -0700 (PDT)) Subject: Re: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.4 (-----) X-Debbugs-Envelope-To: 24663-done Cc: 24663-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.4 (-----) > Date: Mon, 10 Oct 2016 14:14:52 -0700 (PDT) > From: Drew Adams > > 1. Some lines are too long. Please use fill-column=70 for ordinary > paragraphs. Done. > 2. Typo: "in turns" should be ", in turn," (no "s"). This was already fixed in Emacs 25.1. > 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. 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. I changed that to say "the entity at point" because the rest of the doc string refers to that. > 4. Add a comma after "nil". Added. > 5. Typo: "function of no argument" should be "function of no arguments". Fixed. > 6. " where" should be ", where:" (and that sentence is run-on (too > long). Done. > 7. "responsible to preserve" should be "responsible for preserving". Done. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 15:46:33 2016 Received: (at 24663-done) by debbugs.gnu.org; 13 Oct 2016 19:46:33 +0000 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 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 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 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 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 MIME-Version: 1.0 Message-ID: <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> Date: Thu, 13 Oct 2016 12:46:19 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default>> <<83fuo088wa.fsf@gnu.org>> 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)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 24663-done Cc: 24663-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) > > 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. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 16:06:46 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 20:06:46 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.4 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 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 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 Date: Thu, 13 Oct 2016 23:06:09 +0300 Message-Id: <83eg3k815a.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> (message from Drew Adams on Thu, 13 Oct 2016 12:46:19 -0700 (PDT)) Subject: Re: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default>> <<83fuo088wa.fsf@gnu.org>> <225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.4 (-----) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.4 (-----) > 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. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 16:33:48 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 20:33:48 +0000 Received: from localhost ([127.0.0.1]:54534 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumhI-0008Dc-8a for submit@debbugs.gnu.org; Thu, 13 Oct 2016 16:33:48 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:38565) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumhG-0008DO-EK for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 16:33:47 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u9DKXcHL024860 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 13 Oct 2016 20:33:40 GMT 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 u9DKXcxn012207 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 13 Oct 2016 20:33:38 GMT 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 u9DKXaAE008288; Thu, 13 Oct 2016 20:33:37 GMT MIME-Version: 1.0 Message-ID: <30cc62fc-abee-4f28-9677-82c610b841c5@default> Date: Thu, 13 Oct 2016 13:33:34 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <<<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default>>> <<<83fuo088wa.fsf@gnu.org>>> <<225e9a9e-eaa2-4c6a-96f8-7106a9817491@default>> <<83eg3k815a.fsf@gnu.org>> In-Reply-To: <<83eg3k815a.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)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) > > > 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? >=20 > The one at point. The symbol? word? file name? URL? ... (yes, ... - there are any number of kinds of things, most of which - nay, all of which -=20 could be completed. > > You can get different kinds of thing at point. You must provide > > the desired THING type, for "thing at point" to mean anything. >=20 > My understanding is that it's up to the hooks. Then them most that the doc can & should say is that SOMETHING (some text) BEFORE point, is susceptible to completion. > > 2. I don't see how/why saying "entity" changes anything, here. > > "THE" entity? What is that? >=20 > Then I guess I will say that I don't want to fix that part. I got 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. >=20 > The doc string doesn't say "text", it says "entity". IOW, it doesn't > talk about characters. What else is before point, besides characters? What else gets completed, besides text? OK, presumably a face or other text or overlay property, or a marker, before point could perhaps lead to some kind of completion. What that might amount to is anyone's guess. I don't think non-text completion is really what `completion-at-point-functions' is about (or has been about). It certainly isn't something that the doc string should imagine. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 16:36:11 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 20:36:11 +0000 Received: from localhost ([127.0.0.1]:54538 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumjb-0008HF-LJ for submit@debbugs.gnu.org; Thu, 13 Oct 2016 16:36:11 -0400 Received: from mail-lf0-f47.google.com ([209.85.215.47]:32889) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bumja-0008Gz-0R for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 16:36:10 -0400 Received: by mail-lf0-f47.google.com with SMTP id x79so158774162lff.0 for <24663@debbugs.gnu.org>; Thu, 13 Oct 2016 13:36:09 -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-language:content-transfer-encoding; bh=uyA8Dwz753h2CqaggRPC4mHvVmq8fWLxpTivxrMquGA=; b=PINKIoz5xZEGJyfnPXfk2ASpb+ODUqg3ghzwoKnFneBMD5RSV3qX1RjR4yy+Dp0/py ZCMygX8Xsh05QbFLaAJ5b2YRXDNbeTY98Cj/x2/Xj5YxkTbauXl+J0Leyi9oYmS66FYv PljvffcdSEkDNa6eMgvf3X1IfDWM4sueFJgrP0vNH4Iv8Bkxg4HNXRHv9tFikC4rulUc Qk7En0tKutOX56A9O0ZIzqlPlPvgfLERdRqSRHeMK1xiZcO4hTstQDdjZdk/FP9OxfVd qP+T+s3r5iMMP9juIYyiSgPUFJUB1v4vnZ7WUCSxPOg3lNnKfy4ReydPFdykcL6C6lDL FPUQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:subject:to:references:cc:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=uyA8Dwz753h2CqaggRPC4mHvVmq8fWLxpTivxrMquGA=; b=E29xKLOE7a9qoqsG4sjFW9DS0UeDfxul6EeQYpXavDpMduXwfiSMl1t1uydbyYK71l Korfx49kmDA//fS1IIO1DGP9BkmSeRz/Fo9zU1ZN3fk4brUphqt267fYSSvojf7sEQIq k9zM6DvMp0f3Mh40wvDEgIZuZ3ysTYAjaf3MLHQnVK+mczGtGp9nDFtu0ami0D4Q8p7w u27PIMacqY9dYZko2eOiVzsDn29ha6ptwZCcDeeAfDNjwqvjBVDTBX3LRQJBBtb0Q5NX iXh/xELqDsyDA3UXOCdj5IS3ltd2+SzA+NxvfK7qROUHdJAg7ob6wi0rjS84yDMIvxNE 19hg== X-Gm-Message-State: AA6/9RlYSym/4yEZGwX2DPGNRXD9G8Cprn/z+69XTpGcyVNyB572x/svK1ODl1G7HWdgfA== X-Received: by 10.28.55.203 with SMTP id e194mr3317484wma.97.1476390963507; Thu, 13 Oct 2016 13:36:03 -0700 (PDT) Received: from [192.168.1.3] ([185.105.173.41]) by smtp.googlemail.com with ESMTPSA id g6sm25496326wjy.3.2016.10.13.13.35.59 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 13 Oct 2016 13:36:01 -0700 (PDT) Subject: Re: bug#24663: 24.5; doc string of `completion-at-point-functions' To: Drew Adams , Eli Zaretskii References: <<<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> <<<83fuo088wa.fsf@gnu.org> <<225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> <<83eg3k815a.fsf@gnu.org> <30cc62fc-abee-4f28-9677-82c610b841c5@default> From: Dmitry Gutov Message-ID: <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> Date: Thu, 13 Oct 2016 23:35:58 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:50.0) Gecko/20100101 Thunderbird/50.0 MIME-Version: 1.0 In-Reply-To: <30cc62fc-abee-4f28-9677-82c610b841c5@default> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.5 (/) On 13.10.2016 23:33, Drew Adams wrote: >>> 1. It cannot be "THE" thing (or THE entity) at point. Which one? >> >> The one at point. > > The symbol? word? file name? URL? ... (yes, ... - there are any > number of kinds of things, most of which - nay, all of which - > could be completed. The code in the hooks decides that. In practice, it's a part of a major or a minor mode. >> My understanding is that it's up to the hooks. > > Then them most that the doc can & should say is that SOMETHING What does that mean? > (some text) BEFORE point, is susceptible to completion. AROUND point. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 17:19:06 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 21:19:06 +0000 Received: from localhost ([127.0.0.1]:54546 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunP8-0000p4-0o for submit@debbugs.gnu.org; Thu, 13 Oct 2016 17:19:06 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:26978) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunP5-0000oZ-DD for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 17:19:03 -0400 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 u9DLIvYf013952 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 13 Oct 2016 21:18:57 GMT 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 u9DLIu8Y007828 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 13 Oct 2016 21:18:56 GMT 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 u9DLIsTq029828; Thu, 13 Oct 2016 21:18:55 GMT MIME-Version: 1.0 Message-ID: <1efe9646-66d2-4d9b-b557-9911e148cb63@default> Date: Thu, 13 Oct 2016 14:18:53 -0700 (PDT) From: Drew Adams To: Dmitry Gutov , Eli Zaretskii Subject: RE: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <<<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> <<<83fuo088wa.fsf@gnu.org> <<225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> <<83eg3k815a.fsf@gnu.org> <30cc62fc-abee-4f28-9677-82c610b841c5@default> <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> In-Reply-To: <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) > >>> 1. It cannot be "THE" thing (or THE entity) at point. Which one? > >> > >> The one at point. > > > > The symbol? word? file name? URL? ... (yes, ... - there are any > > number of kinds of things, most of which - nay, all of which - > > could be completed. >=20 > The code in the hooks decides that. In practice, it's a part of a major > or a minor mode. Exactly. That's what should be said. Some text before point can get completed. The completing code decides (1) WHICH text before point (what kind of thing, if you want to think of it that way) and (2) what the possible COMPLETIONS of it are. > >> My understanding is that it's up to the hooks. > > > > Then them most that the doc can & should say is that SOMETHING >=20 > What does that mean? >=20 > > (some text) BEFORE point, is susceptible to completion. >=20 > AROUND point. Really? In that case, that's what needs to be said in the doc. Of course, if it is AROUND point then presumably any text in the buffer can be used to determine what's to be completed (and in turn what the possible completions are). It could use only the first two or last six characters of the buffer, ignoring the text immediately surrounding point. It sounds like the real point (sic) is this: The completion functions (1) are passed point, and (2) they can do anything they want, to complete any bits of text existing anywhere in the buffer (or even perhaps ignoring all text in the buffer). And presumably, after the user chooses one of the completion candidates, that candidate is inserted at point. If this (or similar0 is the behavior then it is what should be said in the doc. There should be nothing additional and gratuitous, that implies that the text immediately preceding or following (or both) point is what gets completed. And it certainly should not speak in terms of any "thing" or "entity" at (or before or after or around) point. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 17:26:23 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 21:26:24 +0000 Received: from localhost ([127.0.0.1]:54556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunWB-0000zj-QL for submit@debbugs.gnu.org; Thu, 13 Oct 2016 17:26:23 -0400 Received: from mail-qk0-f171.google.com ([209.85.220.171]:35533) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunWA-0000zW-EL for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 17:26:23 -0400 Received: by mail-qk0-f171.google.com with SMTP id z190so116818328qkc.2 for <24663@debbugs.gnu.org>; Thu, 13 Oct 2016 14:26:22 -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-language:content-transfer-encoding; bh=zR3lIbb4sLezezxjBnM9ojCWgm2tDTCyqUsijBVmuPE=; b=Dvod4VpCVgxLB3keCixjnW+7ecnigEqxrV+SUgcO39F5nQhTf/cIgm78q8rYXGDNbZ GkY+z8ZkjN19g4PQpSt0vfuvEgtt/1BETPTaLx7bVf3abHDcXPHMzR/OsKsdV9Ks14UG 4I5sgRqLdkKTNvhnRCCU1CSsSGAwEAjummmL/tD+/eLj0+x5uBMMiWhbm5Rh3DW8ZLT9 LWf6xS1OB9I6N3TJq5ZFjkZLN/aZvrrWwubKQarG+mdFkmPm0+Jz9UUcVbPskf7Hx6If CEZwjlV8GdMFGQZmilj0w0Cw8Bzz3x7+WortSEdlRBNAfCLuIQvDMN6IoYv4gRI21NP+ 8KMQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:subject:to:references:cc:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=zR3lIbb4sLezezxjBnM9ojCWgm2tDTCyqUsijBVmuPE=; b=fUvITT+4ImX4uk7Gs4d/ospXuanl+ZC8aEBG66p0pG2rOrGvQeeLrQwNVDvLfoPz1J pQnWJFu4Rv+U5t28wJpe80thshGlyedIYe8IThSWBJtMlPrTKGykpF9ZuPbAdjW7cKf1 erXlFTXi6DpW9oLr34qmJISV8uBbLUoBLRp5zHpLS9mDYUPOK2AfJsy04tRljtXhih3z oejgv5PCnd4b8XOuJOl0jFhriN9GBpCpb2/qY/aDb4j0CdRv7wD77R9KlyLLdsBUynBi sZp+PHCahUhn1m3zqq31p3gmQYXt62TUEcEcQAUI9xOUeJiuZOjdSkwbK3DrJ3bStjjU F1iA== X-Gm-Message-State: AA6/9RlWYLZzAYEMKUx+LMX5BJ/51pwUoTeK2nMe+bTfWTwCBqlSJe0Ifsl1RezR4W9LJQ== X-Received: by 10.194.123.197 with SMTP id mc5mr8035383wjb.231.1476393975752; Thu, 13 Oct 2016 14:26:15 -0700 (PDT) Received: from [192.168.1.3] ([185.105.173.41]) by smtp.googlemail.com with ESMTPSA id hb5sm25793025wjc.5.2016.10.13.14.26.13 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 13 Oct 2016 14:26:15 -0700 (PDT) Subject: Re: bug#24663: 24.5; doc string of `completion-at-point-functions' To: Drew Adams , Eli Zaretskii References: <<<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> <<<83fuo088wa.fsf@gnu.org> <<225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> <<83eg3k815a.fsf@gnu.org> <30cc62fc-abee-4f28-9677-82c610b841c5@default> <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> <1efe9646-66d2-4d9b-b557-9911e148cb63@default> From: Dmitry Gutov Message-ID: <4009a3e5-1fd4-fa68-a48d-48dacb181e96@yandex.ru> Date: Fri, 14 Oct 2016 00:26:11 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:50.0) Gecko/20100101 Thunderbird/50.0 MIME-Version: 1.0 In-Reply-To: <1efe9646-66d2-4d9b-b557-9911e148cb63@default> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.5 (/) On 14.10.2016 00:18, Drew Adams wrote: >> AROUND point. > > Really? In that case, that's what needs to be said in the doc. > > Of course, if it is AROUND point then presumably any text in the > buffer can be used to determine what's to be completed (and in > turn what the possible completions are). It could use only the > first two or last six characters of the buffer, ignoring the > text immediately surrounding point. Not really. The region to complete has to include the point. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 13 17:29:23 2016 Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 21:29:23 +0000 Received: from localhost ([127.0.0.1]:54560 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunZ5-00013m-78 for submit@debbugs.gnu.org; Thu, 13 Oct 2016 17:29:23 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:31229) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bunZ3-00013Z-MI for 24663@debbugs.gnu.org; Thu, 13 Oct 2016 17:29:22 -0400 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u9DLTFDL024445 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 13 Oct 2016 21:29:15 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id u9DLTE86010185 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 13 Oct 2016 21:29:15 GMT 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 u9DLTCi3001736; Thu, 13 Oct 2016 21:29:13 GMT MIME-Version: 1.0 Message-ID: Date: Thu, 13 Oct 2016 14:29:11 -0700 (PDT) From: Drew Adams To: Dmitry Gutov , Eli Zaretskii Subject: RE: bug#24663: 24.5; doc string of `completion-at-point-functions' References: <<<2178d9e1-fd5c-4045-9a10-d0c45b0de591@default> <<<83fuo088wa.fsf@gnu.org> <<225e9a9e-eaa2-4c6a-96f8-7106a9817491@default> <<83eg3k815a.fsf@gnu.org> <30cc62fc-abee-4f28-9677-82c610b841c5@default> <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> <1efe9646-66d2-4d9b-b557-9911e148cb63@default> <4009a3e5-1fd4-fa68-a48d-48dacb181e96@yandex.ru> In-Reply-To: <4009a3e5-1fd4-fa68-a48d-48dacb181e96@yandex.ru> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 24663 Cc: 24663@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) > >> AROUND point. > > > > Really? In that case, that's what needs to be said in the doc. > > > > Of course, if it is AROUND point then presumably any text in the > > buffer can be used to determine what's to be completed (and in > > turn what the possible completions are). It could use only the > > first two or last six characters of the buffer, ignoring the > > text immediately surrounding point. >=20 > Not really. The region to complete has to include the point. The entire text in the buffer is AROUND point and includes point. But maybe you are mentioning another part of the behavior: some text around point is REPLACED by one of the completion candidates. If that is part of the behavior then that too should be mentioned in the doc. From unknown Tue Aug 19 05:26:26 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 11 Nov 2016 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator