From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#66147: 28.2; Doc of completion functions: (elisp) `Basic Completion' Date: Fri, 22 Sep 2023 09:06:47 +0300 Message-ID: <837coi91xk.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32564"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 66147@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Sep 22 08:08:08 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1qjZKi-0008An-9H for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 22 Sep 2023 08:08:08 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qjZKV-0000Ps-Gl; Fri, 22 Sep 2023 02:07:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qjZKS-0000PX-HE for bug-gnu-emacs@gnu.org; Fri, 22 Sep 2023 02:07:52 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qjZKS-0003zS-7v for bug-gnu-emacs@gnu.org; Fri, 22 Sep 2023 02:07:52 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qjZKc-0006vY-7J for bug-gnu-emacs@gnu.org; Fri, 22 Sep 2023 02:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 22 Sep 2023 06:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66147 X-GNU-PR-Package: emacs Original-Received: via spool by 66147-submit@debbugs.gnu.org id=B66147.169536283026555 (code B ref 66147); Fri, 22 Sep 2023 06:08:02 +0000 Original-Received: (at 66147) by debbugs.gnu.org; 22 Sep 2023 06:07:10 +0000 Original-Received: from localhost ([127.0.0.1]:35156 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qjZJl-0006uD-Eb for submit@debbugs.gnu.org; Fri, 22 Sep 2023 02:07:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46630) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qjZJe-0006te-RR for 66147@debbugs.gnu.org; Fri, 22 Sep 2023 02:07:06 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qjZJO-0003lm-F1; Fri, 22 Sep 2023 02:06:46 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=wEjQXL1HlLT+CYLdQxaXpy0696RDDc+LbzW2eSg7VRY=; b=IsEgX3jPyZ5d s0XuYErvMgK+hVG9kmCu1pu2lSswEpnYBe7XvDicUmnncB+lPdZmR53gxmNQwCktI2P6zuXiXZJsW GNpDLqiejVkpb1JYkbiBC0eVTYTYgq0CRpjqWr1J8WvmmXng2JzeXW4FnC+00BlEsgebkIEWQ/MCs oLd5s61WXwrATE5NXMQN7x2rJl9vllwYbSKYvwVPZP9sQMxhm40Xt8BZbjGQ6gTUgttgnZLAoXxAZ HSAMuZjGiuGhhM4KbEoLaPdOOVVVYdTYfr0HeTjfFBxug1CS5bmN1orra2KFTsBC7gFv83my/VzGf JU4NaG6EXkPPe6UjtbuQ+w==; In-Reply-To: (message from Drew Adams on Thu, 21 Sep 2023 21:45:32 +0000) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:271036 Archived-At: > From: Drew Adams > Date: Thu, 21 Sep 2023 21:45:32 +0000 > > What seems missing from this doc (and likewise from the relevant doc > strings) is any description of what it means for a string to _match_ > entries in the completion table. "Basic Completion" is a subsection of "Completion". The parent section explains what it means to match, by describing what does it mean to "complete" something. So I think you are looking for a problem where there is none, by taking a single word (which generally has many different meanings in Emacs) and trying to interpret it by looking at the manual through a loophole, instead of taking the broader view by going to the beginning of the section and reading from there. IOW, if someone reads on "Basic Completion", he or she needs to understand the terminology already; otherwise, they should start from the parent section. > In the beginning, Emacs completion used _only_ such literal-prefix > completion, so maybe back then not specifying how an input string is > matched against a completion candidate might not have been so > important. But nowadays users encounter all kinds of matching when > completing: from substring to flex to regexp,... They're familiar with > that interactively, as Emacs users, typically long before they encounter > programming with the completion functions described here. This seems to talk about something other than basic completion, so is not relevant here. And when a completion style does something other than the simple prefix matching, the style's documentation should state that (and it does). So I don't think we should do anything here that we haven't already done.