From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.ciao.gmane.org!not-for-mail From: Daniele Nicolodi Newsgroups: gmane.emacs.devel Subject: Re: Documentation about the completion framework Date: Mon, 21 Jan 2019 20:53:06 -0700 Message-ID: References: <62c8a43a-16f4-cd86-da24-df3dcbe68537@grinta.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.org; posting-host="ciao.gmane.org:195.159.176.228"; logging-data="15339"; mail-complaints-to="usenet@ciao.gmane.org" User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:60.0) Gecko/20100101 Thunderbird/60.4.0 To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 22 04:53:52 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gln8I-0003vi-Rr for ged-emacs-devel@m.gmane.org; Tue, 22 Jan 2019 04:53:50 +0100 Original-Received: from localhost ([127.0.0.1]:38023 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gln8H-0006nr-SO for ged-emacs-devel@m.gmane.org; Mon, 21 Jan 2019 22:53:49 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56737) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gln7g-0006na-Bm for emacs-devel@gnu.org; Mon, 21 Jan 2019 22:53:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gln7f-0008SZ-Ex for emacs-devel@gnu.org; Mon, 21 Jan 2019 22:53:12 -0500 Original-Received: from zed.grinta.net ([109.74.203.128]:51524) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gln7e-0008Ry-Ok for emacs-devel@gnu.org; Mon, 21 Jan 2019 22:53:11 -0500 Original-Received: from black.hsd1.co.comcast.net (c-98-245-163-4.hsd1.co.comcast.net [98.245.163.4]) (Authenticated sender: daniele) by zed.grinta.net (Postfix) with ESMTPSA id 36E2EE8EC2 for ; Tue, 22 Jan 2019 03:53:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=grinta.net; s=mail; t=1548129189; bh=a4y1vPX1OQMmVcUTgeaHrP/PyUDn+eFovvYiOWWAdt0=; h=Subject:To:References:From:Date:In-Reply-To:From; b=t7VtSWnJUe3ylah70C3eYoDPyoiEZeTk6Uu9lZtJpsbVbrdBV1Nyf1OeVrBa2yg1t Ck3Eqflt0UPeDBdbP0DLNhbXFskz5nJbqZ2/scXWwiOWuIWm/+vglZr9AlIFW+WMKG sMwVctpQUBI2UzG+PESS75tsHaWaHc0Ekbrk25LU= Openpgp: preference=signencrypt In-Reply-To: Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 109.74.203.128 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:232599 Archived-At: On 21/01/2019 20:37, Stefan Monnier wrote: >> Trying to understand this code: how is this different from computing >> candidates directly in my-completion-at-point-function and passing it down? > > The completion function is not always called. > The completion-in-region-mode for example just calls > completion-at-point-function after each command (without looking up the > completion-table) just to see if we're still within the same field. I see. Unfortunately I didn't find any documentation of this mechanism. Did I overlook it, or should I think about submitting a patch improving the docstrings? Thansk! Cheers, Dan