From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#52901: 26.3; (emacs) `Completion Styles': provide more guidance Date: Thu, 30 Dec 2021 17:25:01 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31083"; mail-complaints-to="usenet@ciao.gmane.io" To: 52901@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 30 18:26:11 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 1n2zBq-0007tu-81 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 18:26:10 +0100 Original-Received: from localhost ([::1]:52588 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n2zBo-00015L-R6 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 12:26:08 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:59842) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zBi-00014P-AZ for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 12:26:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42791) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n2zBi-0008DY-0W for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 12:26:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n2zBh-0001XP-TX for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 12:26:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 30 Dec 2021 17:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52901 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.16408851245827 (code B ref -1); Thu, 30 Dec 2021 17:26:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 30 Dec 2021 17:25:24 +0000 Original-Received: from localhost ([127.0.0.1]:54337 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n2zB0-0001Vi-R5 for submit@debbugs.gnu.org; Thu, 30 Dec 2021 12:25:24 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:53038) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n2zAz-0001Va-5r for submit@debbugs.gnu.org; Thu, 30 Dec 2021 12:25:17 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:59698) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zAx-0000AH-6o for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 12:25:16 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:65298) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2zAu-00087F-W9 for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 12:25:14 -0500 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1BUFLSUf029405 for ; Thu, 30 Dec 2021 17:25:05 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=fscKcsP2Ka3IfjoJkLlZ9zdVzamMk6FgDrZYBRA8sC8=; b=JtTl8mx5n1/IgL+2wkVX03eWK/lJvexM/ECFpIMpaDE5bqi5H0t7eP/UpYyn2g6RLggN J8R5iNh+Qmd+9zV0eoYIzMI5GXrLTOogpZu7UzghSOGIgoQVwpjfSjtQoIR12T3NR+aA gpOSFRuxp8SC5/EuVDszakAbHn84XPxEiFSAYHFAHxTLXIku52T7y5iF2aQaRwHu/71s vQZAywO64yaZjp6d0D5CTeP82WOyStWk6IS5w5rROQ8OJJVEwxlacq7RMBLXV5OGuZju sdtx4yNXSjLslKaRFBy+yiGOiJHYNXHUIBm5NAiux1fdc53E2Akfxil2Ttf6cwSnlcqq bA== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3d9fbag50x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 30 Dec 2021 17:25:05 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1BUHEvAR058876 for ; Thu, 30 Dec 2021 17:25:04 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by userp3020.oracle.com with ESMTP id 3d5vrrg0pc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 30 Dec 2021 17:25:03 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=nmiUOVfvpZ+dADxFS9ULuaCxphAMJ+oCcUpk8i6BQQsjiSeqNZd0wWfH+nJmnQSKmgIhIQMosCkvxw/8Bh3cZ5/ucRPNqIJ4aEVIXSzRybDD2ubbHbseMeRXMuTj2Vmy2O6mC7oaPuwZLMFvOBJAd9/lblNLM5HnCEBkMs5D6DWljvqPhyNzAEUTdv3cXjA25Rq0F91MW0kWZX+q4cx53JrFsvdHoxqNBn6Q648e2D8P7MybUoinUhrRBEeyEiZfqvdYOwDzVqaOAab9a8fDplGRTGyx0J+ABJze0Wf5qXqLf+4lVu+qiIHRQxwtd1+L4a/vMf4KtCKLEzg7FGPb1g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=fscKcsP2Ka3IfjoJkLlZ9zdVzamMk6FgDrZYBRA8sC8=; b=e6y96ttsm+EogP8nPAbFLjGqHMx5Uo4u7zG8eUKim2BhwsGDjlLsnP9hERwaEJ3h8Z8h6DD9leNrPQd+Evf36yy/NlhBTVKT+3GaBqBnWm4ZLH1UsYOvCJMPFAqQS2ka69knpovi9j1wlXGnwUrJoJq0e3UVWnFnXnapDI4tHHQl5j4dfWq2M/hDYEPHSleISz/WcumKHH2cuZaIdrR4sUhxxKndOlTNfQ+OgClFr0wyVyEZEJJhX56ZD9P8g2zfjLZFeiCsKikqteRRNurUxnPfQJsNKXHcJjUbkMlAnofdc8/EPJa3Lo/c8RIykfKE312Bf6S6lvMHM08OAyL/lQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=fscKcsP2Ka3IfjoJkLlZ9zdVzamMk6FgDrZYBRA8sC8=; b=pXc+fMJt3nQiH/2Re5Lekue2BEOnJj6XWRpPGrKOe/8vOJD4p0s6a4ZyuuJbdeRZkWQMIpCjjuqqhQncSQ255ax6BmxKnmo1XYJ5StcBO/iM0ZrZLVfXyMbzpRgfy+adUTnuqkWTsi+/qRZUNXGrBu9KBej7YeJQjTkc3S9RkLw= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BYAPR10MB2567.namprd10.prod.outlook.com (2603:10b6:a02:ab::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4823.19; Thu, 30 Dec 2021 17:25:02 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::99a4:696f:5f30:36b3]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::99a4:696f:5f30:36b3%7]) with mapi id 15.20.4844.014; Thu, 30 Dec 2021 17:25:01 +0000 Thread-Topic: 26.3; (emacs) `Completion Styles': provide more guidance Thread-Index: Adf9ogzKzf9t+DkXTyWPTjkF8LEcAQ== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 9ba295bb-bf5d-4869-c999-08d9cbb94fea x-ms-traffictypediagnostic: BYAPR10MB2567:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: qx5GuvjW7Vk6XiRkKdwZaWVruEdafR8esHRORyn+SpyvlnsPOgEcVxI11i+vIQGRuhFQkGaUGhQ4/dyCxCfip03r3PfdZSUg3PZXe1RPLN9lx1123AT1w6t3vR+Gk+rtDhlUJzjg/D+Hsi6YijPaFjspuF2B7QstfB1nCt8ZHzImwmwB6tmaAMnO0ao6xm+HoSgk77SBE/OFFY20V8fIFX8oib3PnjdHwS9GLVugLQcib1dK+hyq8WOc9nnEUPjSQgx6xe9QtYzt5jBAEQYYFR5Q6+FffKSpWt0dJYIXLgRPfs3mJKS0JPF0k77xuSCij6vX+lWC65D7wdFsk50v0IlgrarZfdM/lIphFW/qOfieu7RkaRkTMYcu2jOYFH85g8KU/hxb+Y8lApM4Nqw0ZMfixz9gHMGiB6ZMUYY+44TvxdWUo3J5nXUhrgDvgHVDsQN/WnD/SxCk3k1can/8bdYa9+EuT+fDL/tjpeQwXm8VwR6Yac2AboHfXp86nfjEM9ayP+ie6PI1qvFl4g529U4whL6nWVNcwehLgBL6vimOfD9MK1OWulQa4GIj13w1oLihir4IrP64uM6BpA6pzPUXOQiMWomi8TvTP92lg+hfc1Q4DwaZ/2q1AI87FEkT4mJ2dNcT2eZ9S4ZGyBAaCJ3x0YIAYfrP24Br3r/LLS6RIhjI+WyKWz0+qyqwhl/hG1X0EdvONhDr6qV9yPSUWfRNm1OQ8fNoZJRBqANfBpQ= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(66946007)(45080400002)(6506007)(33656002)(55016003)(186003)(38070700005)(86362001)(44832011)(64756008)(76116006)(38100700002)(7696005)(122000001)(26005)(316002)(66476007)(9686003)(83380400001)(66556008)(66446008)(508600001)(5660300002)(8676002)(71200400001)(2906002)(6916009)(52536014)(8936002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: btO/A4vSPtGY/LbzMKaafwaZr9zKyeuslP3/hyUEqmWnDYAMYdJmOVXhF0hELCNd9VitZZHoq/NxhZRVTNsZgPqTldRSc5PiqdG0hX/s1vXOPO04zH8EIU1dduSjXpxslFqiKC5/88uFKos5rJy28IlKBXGBrt4UIVSgXXptD1XMJV54EpBonv/JSINM4i60nsak4vxTpn2J1SMoMuTSYvVumHqll50ZDAYaC7PCiOPjKIs5IZ3Mc2eMK5G+zxLzYjLZKFqKJDYujlLmbV0kQntl/p1qBYzRmPz9QiVGAyiVhCvx2+Oa8KGg8GRZ/KmZsDbHOWmBfr7PfaTqtCdg9ACk7eqN428+V6DkQ+hhHObCkinNaoUSOb6IdpKiQvKpcjPVzqdfk56RJ7tG+y07SqZs4Jd17GTr2d20KXnpEGfScZoZhGBsbAbDXp3jtJx9VHd1qy9LE9UtBb9anR+W09MiB44TWfuPr3Z2pEJcE0xS8sq8v313vLUL38PvthMbQe6GMqbA6j2Ok73gXlTdadzpOMP7V5ILOqYYxrEcp/BxSPigx1Z6nEkq25KeK21ZNLrpJ6srU4ZAPML64oph2fBBm9EDsVyPW5hYUlrUumX7PhmDCeGYgPRx5/LPgVlwkn5HdzrprYghgS+yGkNx5IL8GXIsKhZmqqFCVafLyaxKI0Jd4LxwEy0Ng0CFQP3BaKSBLDOgwz+QiGJ3ueLdpcFjQ+UWamua75BBeLLgZNuZvXGpf7fZkd2+mY lD4QhVUXv26epLmGM/Vf9rG8U4MEn0uajsPOWm0NL9QzRBFB6c9lWSkU7yESOmeISD/IyEVwIcZqTe9KG2WLQlOGDTjCTbH3hT X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 9ba295bb-bf5d-4869-c999-08d9cbb94fea X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Dec 2021 17:25:01.9030 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: hzMWLi9pyxl0mwUiq3SrFBKHKi+bFbBUGgwHciUulke9SHllA+QGUfRejGG03Rf0uh1HIyNjp+IaQo8ynZlpuA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB2567 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10213 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 bulkscore=0 adultscore=0 malwarescore=0 mlxscore=0 suspectscore=0 spamscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112300100 X-Proofpoint-GUID: uoRAHqF9hpO7XS-VXYpdZWDV6O-wP-MF X-Proofpoint-ORIG-GUID: uoRAHqF9hpO7XS-VXYpdZWDV6O-wP-MF Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:223434 Archived-At: In this node each predefined completion style is described. But these two bits of guidance are missing - please consider adding them: 1. Mention `completion-styles-alist', as does the doc string of `completion-styles'. (We do mention `completion-category-overrides', at least.) 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. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19042 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''