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#52901: 26.3; (emacs) `Completion Styles': provide more guidance Date: Thu, 30 Dec 2021 20:07:15 +0200 Message-ID: <835yr6hsq4.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32210"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 52901@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 30 19:08:10 2021 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 1n2zqU-00089v-5Z for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 19:08:10 +0100 Original-Received: from localhost ([::1]:34608 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n2zqS-0002Bb-2G for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 13:08:08 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:41212) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zqM-0002BK-Db for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:08:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42867) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n2zqM-0001nQ-3u for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:08:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n2zqL-0003Db-Vv for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:08:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 30 Dec 2021 18:08:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52901 X-GNU-PR-Package: emacs Original-Received: via spool by 52901-submit@debbugs.gnu.org id=B52901.164088763712278 (code B ref 52901); Thu, 30 Dec 2021 18:08:01 +0000 Original-Received: (at 52901) by debbugs.gnu.org; 30 Dec 2021 18:07:17 +0000 Original-Received: from localhost ([127.0.0.1]:54413 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n2zpc-0003By-M8 for submit@debbugs.gnu.org; Thu, 30 Dec 2021 13:07:16 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40224) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n2zpb-0003Bb-Cp for 52901@debbugs.gnu.org; Thu, 30 Dec 2021 13:07:15 -0500 Original-Received: from [2001:470:142:3::e] (port=49832 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zpW-0001hY-7e; Thu, 30 Dec 2021 13:07:10 -0500 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=RtBSW3EDpcEBIoS1MdVjLQ/Mf04/Gijwp4J/76YNPIo=; b=g8SByEENNGjn PXrqQDROq6SXJPhglV/IGyCXpbPGHXsxEq1k3S6x8xNhMEAjKoQb4yERZ77gXsby3MC4qotQnulYW jMncfa/3OEITAHUxZResUWz3K6hVvancY2NczBJxl4gNBLzgDgva9H5BPBW/kdLZcB6uzVp6BVISl G6NpLXBSqnu8Mjwk62fBE3DYAyIOyTDdmJVKqEqUn+Ub3Vdw79r4dLVgi+WLjZEBag/3etMJ8QHR5 rLc8v361N5qtWmniDCBIGqrfqALSSOitqRY3TmZz7VudiA+wd5IUi0Bgu+Z3+J7HhwXGwXKxbOKgJ 8Qz54f1S1MfzJnsUQRs6bw==; Original-Received: from [87.69.77.57] (port=3314 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zpW-0005l1-BW; Thu, 30 Dec 2021 13:07:10 -0500 In-Reply-To: (message from Drew Adams on Thu, 30 Dec 2021 17:25:01 +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" Xref: news.gmane.io gmane.emacs.bugs:223437 Archived-At: > From: Drew Adams > Date: Thu, 30 Dec 2021 17:25:01 +0000 > > 1. Mention `completion-styles-alist', as does the doc string of > `completion-styles'. (We do mention `completion-category-overrides', > at least.) The alist variable is documented in the ELisp manual, since it is not of interest to users. I added a cross-reference to there. > 2. Say something about combinations of the styles. The completion > behavior depends on the combination that's the value of option > `completion-styles'. > > It's not enough to describe each predefined style individually, and > say that they are tried in order. Please consider providing some > comparison of the predefined styles: which of them in some sense > include or subsume (or partially so) which others. Give users an > idea of which they don't need to include if they include this or that > other. > > In general, a little more guidance for users, please. The text already says quite a lot about that (it is not clear to me whether you reviewed the latest text, since you don't tell, and the Emacs version from which you reported this is quite old). If you have specific suggestions for more detailed descriptions, please present them. Otherwise I see no candidates for picking up the gauntlet, and we should just close this bug report, because people who work the most on completion are generally reluctant to document more of their work in terms that would be understandable by users.