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: [External] : Re: bug#52901: 26.3; (emacs) `Completion Styles': provide more guidance Date: Thu, 30 Dec 2021 18:53:31 +0000 Message-ID: References: <835yr6hsq4.fsf@gnu.org> 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="7527"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "52901@debbugs.gnu.org" <52901@debbugs.gnu.org> To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 30 19:54:16 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 1n30Z5-0001op-9j for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 19:54:15 +0100 Original-Received: from localhost ([::1]:54404 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n30Z4-0001hd-0A for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 30 Dec 2021 13:54:14 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:51778) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n30Ys-0001hG-Hk for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:54:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42927) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n30Ys-0005Z8-7g for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:54:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n30Yr-0006wW-UR for bug-gnu-emacs@gnu.org; Thu, 30 Dec 2021 13:54: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 18:54: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.164089041926626 (code B ref 52901); Thu, 30 Dec 2021 18:54:01 +0000 Original-Received: (at 52901) by debbugs.gnu.org; 30 Dec 2021 18:53:39 +0000 Original-Received: from localhost ([127.0.0.1]:54473 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n30YU-0006vO-IY for submit@debbugs.gnu.org; Thu, 30 Dec 2021 13:53:38 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:22252) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n30YS-0006vA-4E for 52901@debbugs.gnu.org; Thu, 30 Dec 2021 13:53:37 -0500 Original-Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1BUFLtYA023316; Thu, 30 Dec 2021 18:53:34 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=muWwKnoHBVTL4O6oaxBbQK7TYCmWKOxNQ4oPhk4EA8A=; b=uHl82Q3UjmoJNERO90bgZTfnwkpft5nWSF1fceN7vaa5ibwjzB626nTRVqH+Kqbfumz9 48K9mmcbaS4mI1ox4W1fWxnNsBhx+tV7XyNltW2bGdBqCa96LbHUPs81kJrBWkJ/JSD5 Az3/ateua7LA/+Ph+MLg9AkccLlBSlLOd6dOGNhb/QnBR+hQZtlDTbSe5ZJurkkbio8G 1ixFKPe0Cfj8QdBvojSTmHj2mKoCCT66hlUPPJZ7mNDTAn+A9oYcwkqUbSWFodMrrYTB dygxakYDjD38Q6r4GwBk1+Rj4ILiHr+b9GmFDTi3x/xVg3M8+nvsjg/QEBJPmxM8E4TQ 6A== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by mx0b-00069f02.pphosted.com with ESMTP id 3d9fba0am1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 30 Dec 2021 18:53:34 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1BUIjlhM120338; Thu, 30 Dec 2021 18:53:33 GMT Original-Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2177.outbound.protection.outlook.com [104.47.59.177]) by aserp3030.oracle.com with ESMTP id 3d5sbfctb4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 30 Dec 2021 18:53:33 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DXP6/dqkmnvyGztcXlQZ3N14DTc+fSvoF1OM+xaFtLUYUO/FHVduILRCihpOZvF6AspkxiUvtjfZFiWeahv8AydJdDwxUxnm0Ok/3kJqfg504Oke9KnyWUUD6cZSDAku9Vk0bxOaYjIrTuX4WXakn8se4xoR4nPCZESnAsinSkUDobGZzVbvXgfAsTv5epxIF7q9rf7UTrifh4OynUe3nc9Hdj291La7FoSKm0g1A/iVcTpxnuvj0KsoNUrpIk3aiGzld7pcM9YM/VmQhdGE5rEjpOdd5r0BlhICCPR49SQFgwddn8X/zB5wFOSIFLVNAQi6zw6ZlEVY03KVGqJVIQ== 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=muWwKnoHBVTL4O6oaxBbQK7TYCmWKOxNQ4oPhk4EA8A=; b=XJKMuNmxlx+PQ7L8AZ+fd7IGrEyEqT1/luqiMryn20OIWJNa6JcbtUx7+H7LnNeCBrNzGRMCdjICOOn3Vho+b4RuFFqNQTj2wzP/hZ15NI9GBdmHjjLVfwxESqgWJ9zdC92df1KB7Pv2MIn78k4CJsKK04o03MgcGgBUIMff1qNbRmeqgiPqXMyVdM6VvIKlcztiePBXS1ee8QoD4IgACDMR+8mwhWwzuAEiq0Pau/aIJTlnsZKA48RC+91RatwMeMNKqJWivS+QVwf58hmA44AFsCqjdl/1+XIhfMiJ0FlgenT+IzCopcvB67T88jkvP54Il2w99gThFsychW1XNg== 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=muWwKnoHBVTL4O6oaxBbQK7TYCmWKOxNQ4oPhk4EA8A=; b=cy+EgxA9KIRGvttPuwdTxNO++BEUOBF6SJMYbVfHA4mlYqeQ5MImI3D5p/VnTPTQGimLF9Px+FGMQXQLlI8AxnoFo2VHmTTk37WYE1znBCx3sTeIXJLkAE/LlnPbr7PoUsXuTkymfhaJMOrzsKvyvmkmWEoRs6Ye+bKuvCWzRiU= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BY5PR10MB4386.namprd10.prod.outlook.com (2603:10b6:a03:20d::11) 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 18:53:32 +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 18:53:32 +0000 Thread-Topic: [External] : Re: bug#52901: 26.3; (emacs) `Completion Styles': provide more guidance Thread-Index: Adf9ogzKzf9t+DkXTyWPTjkF8LEcAQABgb2sAADgg+A= In-Reply-To: <835yr6hsq4.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 16355965-9582-4163-22aa-08d9cbc5acf6 x-ms-traffictypediagnostic: BY5PR10MB4386:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: EGhPO8cRB3VkK533zK+QoDCpeWBDOE6O6Ye53dGYrSJR73v1biiRBgJ8e2wuKraHdiyh7xqJa5x1wrUyp2BOB9cY8PhOwCFVW9Ie6FLIvTmFh9TSyWm+SkGQBvg3VXHRNAqnO9wdn8PeeGwU3tljSwbmHquXgd07TJxRFPf6MsH+8Usf9N4u0/GWv+7TXlVROx7Luz03Gs4nFhfKGFYqv1JmwwGNz4DUyIOIX5s5mmfzWy123b1MQDC6RiCQzbszhlTWkHb3/44bHL75Q8hEN4lbKQIICWN2Z+SUdjjfybtSUTu93NU62BbFOslra3bajOZte94MZf1cnJ7IhRY4QGUW+LOUMaSMgGodF3iYKpbD8PEveODrvbo2oiu8Ra9Kumw+Qo4wdb5HkyRq9Y7b917+5AK2B+0XSRG60+18Ua+KkkbqrjU/DaMq0Tn1dLBLLAdDYkSDbYbJxibsFrmtdK/pQQKEUERyh6fD+gxmJjv2K6kndVZoGt3HR5W/TGxqcLqGPn2sGqTxsbQMK/TkooJniFuM1WW7UhCkF9N8Y+IDoLa+7sc6BKBTDgSfGkfoLbW6bfVnVHtoMKtLaxvFaTeigKYFDcHjwHZpC96f4jOYJzBW1kLAxyTr7BG5xa0mODyhWobevBvHqciWJqkRIkz5bvOeUhOLNlFlg1W63q8UbrJpJjUZ76VPUPvxdKO+45G79uX2zhrjCt80qikKLnKNiMS4E83nHxJf8D7mGHw= 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)(66476007)(9686003)(66946007)(7696005)(86362001)(38070700005)(66446008)(52536014)(316002)(83380400001)(2906002)(55016003)(71200400001)(38100700002)(26005)(508600001)(33656002)(76116006)(8676002)(4326008)(6506007)(44832011)(66556008)(5660300002)(122000001)(64756008)(8936002)(6916009)(186003)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: 36az3bnnLLAETQ/bSmI4gU6FRyzsPeeMiVyT2jW3BZQqsjmHJHat5QtQYSFWOMukSf+cNVFlZioY3fPQ+fu/1g5/ZO8GRFyAMUmz//0yKzZ95gNDmHWST7dikWVIGHzQhgl1lZcekohBxI5gL9rbLLbelS/eSLeeoocTTIbeUGdB/XFFhrL/eubC6l77rzEb+fzMjNN5xe9O+5jp17eplLilGqDcCbXmvtQZEbj3W5GhGDXcy5MD+Wc4M9Tfai1enpyeF/cnL7akbTh0NgUTn5xoNeLU3F5TTbRj7qOnTyyOpYuJGsBYHJiPHzFhk4BVw9zI/qw/rkk2/UfGuDEkr9kwLeYPjW9z0V3An+x95pt3waTUteZcZ5xFYMgwwZ77wtVU0xQQAamZSH/mjoj2ysRe4ZVHujSp1wsEZlakny0Y3TA3/bOikgtUqjYeCx5Vmhdh9FqmFOnozebBCDq4F8WiIuNOkDlago03QFwWUdC+EbKPDPmoo9q3WZwqDaBSQZzCFHj6HmCqJlvcjIJop3i1nxknJy+681F63m8ymNVbKwV0//7qTwV46OxdpZRs4zG6IGMdzAG4EZRXV+WCVA54os1DkBi9LTAdgv1lpvtGbEuqlwb/r+WwU09TDqRDjrJzR7BbIvjHAfDtJwGM8alPl8yGrkl5ulFyQwNrKkgEe0E08NrFBKVfClY01Ux44CRrXhjIil/LULUc0loNtYeTzT2ZBCsbIX/6ptbgVfjh5mYYs3rrefqWqI xz8s5TI/qvOWe1vg3HpgNJFCdrUWtn8RELwsJIl0DIbwrasWX2rdCxR25oyBmLhcX+2Mn7bQCrrei4d2pUCzHIvyeXgEjzemsA 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: 16355965-9582-4163-22aa-08d9cbc5acf6 X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Dec 2021 18:53:31.9193 (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: k6IrqAykUI+8sGTAnAqhJR6/jZXgK+g0Dm1+s7Eit7TqTtrr2n7I1LA4W9haSzbrEKgxkk9Hxmsxt/sHGwinPA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR10MB4386 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10213 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 bulkscore=0 mlxscore=0 spamscore=0 mlxlogscore=999 adultscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112300108 X-Proofpoint-ORIG-GUID: WJ1doLmddr1Lkv92M_du5cTl8R54Dtu0 X-Proofpoint-GUID: WJ1doLmddr1Lkv92M_du5cTl8R54Dtu0 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:223442 Archived-At: > > 1. Mention `completion-styles-alist', as does the doc string of > > `completion-styles'. (We do mention `completion-category-overrides'= , > > at least.) >=20 > The alist variable is documented in the ELisp manual, since it is not > of interest to users. I added a cross-reference to there. That's fine, thanks. > > 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 tha= t > > other. > > > > In general, a little more guidance for users, please. >=20 > 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. Everything I said applies to the latest Emacs release also (Emacs 27.2). (There's no MS Windows binary for the Emacs 28 pretest.) Based on your saying that "the text already says quite a lot" about what's requested, I nevertheless downloaded the latest (master) *.texi doc for this node. Unfortunately it, like prior versions, says _nothing_ about the relations among the (predefined) styles. It just says that they're tried in sequence till one finds completions, and it describes each predefined style individually. That's always been said. That's needed info, but it's not sufficient help. It's too bad, if those who currently could provide this guidance aren't willing to do so. But that's not, IMO, a reason to close the bug report. Perhaps at some point someone who understands the style relations well enough will offer to fix this. A _start_ might be to say whether there are some styles that are useless to specify when a particular other style precedes them in the list.