From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.ciao.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Documentation about the completion framework Date: Tue, 22 Jan 2019 07:11:22 -0500 Message-ID: References: <62c8a43a-16f4-cd86-da24-df3dcbe68537@grinta.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.org; posting-host="ciao.gmane.org:195.159.176.228"; logging-data="1213"; mail-complaints-to="usenet@ciao.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 22 20:41:46 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 1gm1ve-0000BR-EX for ged-emacs-devel@m.gmane.org; Tue, 22 Jan 2019 20:41:46 +0100 Original-Received: from localhost ([127.0.0.1]:48086 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gm1vd-0006eZ-5b for ged-emacs-devel@m.gmane.org; Tue, 22 Jan 2019 14:41:45 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:55153) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gm1EV-0004Ud-0Q for emacs-devel@gnu.org; Tue, 22 Jan 2019 13:57:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gm1ER-0002oF-3O for emacs-devel@gnu.org; Tue, 22 Jan 2019 13:57:09 -0500 Original-Received: from [195.159.176.228] (port=34742 helo=ciao.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gm1EQ-0002ib-Qj for emacs-devel@gnu.org; Tue, 22 Jan 2019 13:57:06 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.89) (envelope-from ) id 1glutx-0000d4-R2 for emacs-devel@gnu.org; Tue, 22 Jan 2019 13:11:33 +0100 X-Injected-Via-Gmane: http://gmane.org/ Cancel-Lock: sha1:vMi/h7FgSyYYMnJEkpNhgzsCh+k= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 195.159.176.228 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:232608 Archived-At: > I see. Unfortunately I didn't find any documentation of this mechanism. I'm not sure what that would look like. To me it's just an obvious consequence of the difference between returning a list and returning a function that returns a list. > Did I overlook it, or should I think about submitting a patch improving > the docstrings? If you can provide some sample wording that would have helped you, that'd be great. Stefan