From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#24663: 24.5; doc string of `completion-at-point-functions' Date: Thu, 13 Oct 2016 23:35:58 +0300 Message-ID: <94371f44-4d03-64f2-ed88-edff3546a399@yandex.ru> 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> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1476391068 3485 195.159.176.226 (13 Oct 2016 20:37:48 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 13 Oct 2016 20:37:48 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:50.0) Gecko/20100101 Thunderbird/50.0 Cc: 24663@debbugs.gnu.org To: Drew Adams , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 13 22:37:44 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 1bumkc-0005al-Cm for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 22:37:14 +0200 Original-Received: from localhost ([::1]:42860 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumka-00048t-Rj for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Oct 2016 16:37:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46646) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumkU-00047r-QH for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:37:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bumkQ-0002yn-Ll for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:37:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48348) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bumkQ-0002yj-Hq for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bumkQ-0008IM-BJ for bug-gnu-emacs@gnu.org; Thu, 13 Oct 2016 16:37: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, 13 Oct 2016 20:37: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.147639097131825 (code B ref 24663); Thu, 13 Oct 2016 20:37:02 +0000 Original-Received: (at 24663) by debbugs.gnu.org; 13 Oct 2016 20:36:11 +0000 Original-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 Original-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 Original-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) Original-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) In-Reply-To: <30cc62fc-abee-4f28-9677-82c610b841c5@default> Content-Language: en-US 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:124449 Archived-At: 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.