From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jean Louis Newsgroups: gmane.emacs.devel Subject: Requires better docstring: icomplete-completions function Date: Fri, 23 Oct 2020 19:01:13 +0300 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1687"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: klm@nist.gov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 23 18:56:04 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kW0MF-0000Jq-3z for ged-emacs-devel@m.gmane-mx.org; Fri, 23 Oct 2020 18:56:03 +0200 Original-Received: from localhost ([::1]:42716 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kW0MD-0006Yf-Bx for ged-emacs-devel@m.gmane-mx.org; Fri, 23 Oct 2020 12:56:02 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41952) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kVzVH-0007XE-Vb for emacs-devel@gnu.org; Fri, 23 Oct 2020 12:01:20 -0400 Original-Received: from static.rcdrun.com ([95.85.24.50]:56925) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kVzVG-0005z7-6G for emacs-devel@gnu.org; Fri, 23 Oct 2020 12:01:19 -0400 Original-Received: from localhost ([::ffff:41.202.241.51]) (AUTH: PLAIN admin, TLS: TLS1.2,256bits,ECDHE_RSA_AES_256_GCM_SHA384) by static.rcdrun.com with ESMTPSA id 00000000002A0B38.000000005F92FE4B.000067F5; Fri, 23 Oct 2020 16:01:15 +0000 Received-SPF: pass client-ip=95.85.24.50; envelope-from=support1@rcdrun.com; helo=static.rcdrun.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/23 10:17:50 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.25, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:258367 Archived-At: This function is not well defined, I would like to use some built-in Emacs completion that could replace packages that are not built-in. But this function description does not tell me how candidates structure looks like or what should be predicate. icomplete-completions is a compiled Lisp function in ‘icomplete.el’. (icomplete-completions NAME CANDIDATES PREDICATE REQUIRE-MATCH) Identify prospective candidates for minibuffer completion. The display is updated with each minibuffer keystroke during minibuffer completion. Prospective completion suffixes (if any) are displayed, bracketed by one of (), [], or {} pairs. The choice of brackets is as follows: (...) - a single prospect is identified and matching is enforced, [...] - a single prospect is identified but matching is optional, or {...} - multiple prospects, separated by commas, are indicated, and further input is required to distinguish a single one. If there are multiple possibilities, ‘icomplete-separator’ separates them. The displays for unambiguous matches have ‘ [Matched]’ appended (whether complete or not), or ‘ [No matches]’, if no eligible matches exist.