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.devel Subject: RE: [External] : Doc of deprecated INITIAL-INPUT arg of completing-read Date: Tue, 28 Jun 2022 16:40:30 +0000 Message-ID: References: <87v8smt9lp.fsf@web.de> <87mtdw4v6h.fsf@web.de> 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="11578"; mail-complaints-to="usenet@ciao.gmane.io" To: Michael Heerdegen , "emacs-devel@gnu.org" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jun 28 18:41:57 2022 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 1o6EHl-0002sE-3S for ged-emacs-devel@m.gmane-mx.org; Tue, 28 Jun 2022 18:41:57 +0200 Original-Received: from localhost ([::1]:37358 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o6EHj-0006QI-Ia for ged-emacs-devel@m.gmane-mx.org; Tue, 28 Jun 2022 12:41:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43436) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o6EGb-0005cA-Hh for emacs-devel@gnu.org; Tue, 28 Jun 2022 12:40:46 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:31664) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o6EGY-0001xU-17 for emacs-devel@gnu.org; Tue, 28 Jun 2022 12:40:45 -0400 Original-Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 25SGJKYp024735; Tue, 28 Jun 2022 16:40:34 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=j6BX6P14DODxcGAuuLfLAEJcRlQB4rsdLpaee3wZkj4=; b=xmFRoNbCFO/fdRP2NvLd3SsVIwcaQYcJINGaAGJyDU0Uq/CtuoTtse6AVMjrwezg8aS6 Fs2/iyciyISgzRsoEUn/NeCCfSC5YdlRS/KnKjKeiucubGZOzFM9Tc+sdYRJx7nbvtnL TiD6u/vCQc6gmgfkCZi5xyQlVtO6XrlLGSKYZ0zTUu406m6fx9BHG5r6drJogh1Pm4+T vhALcdANGMzu4FvDeqI0VytdlCm6Ip9UQM95sSnj/widJMnBJAmntAzkQqTOpUpHtNDX N8KbaFaOy3/dwXmPZN1hziikev6q/1hNrPv/T00GMqWa3Bl+u4xSClmZUJ3OEOi4DLj3 6g== Original-Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3gwt89xjhg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 28 Jun 2022 16:40:33 +0000 Original-Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 25SGKLb4002555; Tue, 28 Jun 2022 16:40:32 GMT Original-Received: from nam02-dm3-obe.outbound.protection.outlook.com (mail-dm3nam02lp2045.outbound.protection.outlook.com [104.47.56.45]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com with ESMTP id 3gwrt2cbjb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 28 Jun 2022 16:40:32 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZMajtyeC2or1dSMLLHrFs0tBLc11TrFIk2agMN0yQGTY4Q0XteAX26vHuk89lKTlU4NwotPl7LKCNsyPDmYUTNGOT9sLJxKR6ZCyY0xxba0twNPyq3GyZau73cMGcAtfCvUrkBJifHfv0Pnv9s19TeJLmZDqL/bz5lWvncxehLW+N40ZVEsnoIpqDHxedp0QpexPvh3FeXWx8kDSfT2mZtSsiMGJEI4Qgxv00DmUi1fDxpS2Q/Yj61ULonV99qrswORD6TnRKSm6l3XuvAQ+GWEkaORPcExMsMYiZPwZS/Dz5z2J32V/4h0B5EZB6rjfQeEnmwfwIB4x1+f4L5gOWw== 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=j6BX6P14DODxcGAuuLfLAEJcRlQB4rsdLpaee3wZkj4=; b=npUdrkq75j+pw+eu0jlkbWV2FfH3DEF/IU608/9T2oCs2FQmOXnHaxx7dyHNq5nDSlChNAd9gjxuy7e5Q2K8T7lOBm+W9cbcTEk15cqtLKSeQvcVnJBd4e42yVV2dP7X1JQ8TkJX8bg4mERgGiTohWeIYAuYNcDP1EO807IdDufnN5LKojMe/7LovpHSStdaG/psrVzlJqRLq4ZdZ/qtxCet7tCbRG+hgBM1rwHgapT6yAShYiLY2PC/WnjD/NGkSs0ZNxIH1x9MiM3vr258J1QwRIW0//2eTkjqHrQaHfY5kt8KMWCuAj0SaX86zn58pcMgOe61SOjDmToW6mtdew== 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=j6BX6P14DODxcGAuuLfLAEJcRlQB4rsdLpaee3wZkj4=; b=lXgf3KOcODPqvFkpuVPhwxdSLhivLNOSp5mw6j1y21zjPVse8nhAu4tKdJYhdtH9icWLMmhToGQ6wJHXHlL6EjlxyZxU7E8oD2L45kojCQ2tXgMcjdsWfc6SPuSPh28SpWxLZ9hlUsor6a1o+uC0aFxI3BXxrD/GtGWi6+XWIjU= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BYAPR10MB3495.namprd10.prod.outlook.com (2603:10b6:a03:11a::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.17; Tue, 28 Jun 2022 16:40:30 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::581b:ae2f:16b9:80fb]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::581b:ae2f:16b9:80fb%6]) with mapi id 15.20.5373.018; Tue, 28 Jun 2022 16:40:30 +0000 Thread-Topic: [External] : Doc of deprecated INITIAL-INPUT arg of completing-read Thread-Index: AQHYiwr7l6va9MKR2EaOFX9OplCa761lAZVQ In-Reply-To: <87mtdw4v6h.fsf@web.de> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 66ecca11-7320-433e-569b-08da5924e9eb x-ms-traffictypediagnostic: BYAPR10MB3495:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: YpOA9hJMmUV0v4nKz/0l2sUPQ0xI5WPaQuwj5JSxurHXdO4tHNm4F+bztSvVLf8v5YkqF8aZy0Xieup7O4cxvQfh/j8lzTxM59+fo0hfRocnoQAra5yMew/U449tuLpz+526yoFO6kWE7tslhQ/RUSPFAs+KA0tGO1XTSP9SA4rUcgBduLC/ZCI2g41bcjyvJ4NHYfkkkeNVOdstLENMJalP/lpaWCTdIyNIuJDLNgjnXLJ+Q73m0t1BaBqH6zSXsBE91M0WWiStCmhxeW+ATy4Lick6i01chmr8dgw2ZM3a0I0crJYsY6aJkn+jCiCkfLhLkJgx0GU9jQKJ0SsIPdrjlUzhFkkc3EwdBfpfXwMXTHqr50v04oe2Nmx5TXjC+DekFd+lhP5F1NFOZQahwyPVe3D4N0UrfyoAJ/CK6zwBkXMlOIxCtP3Cx+p13CY7JhhUUO62f6uOpfXiRjVrdVdRWqcyN4javXWbjWD7B/+VNQSiwanktrE4oSh/p45IdhNHK13s/klnJnwitvSQWaS6k7d+Nbgy/Bomk3I6y+sM47bYHocwwwY4TzAlIFC/lo0JsTO+OKDNkJo6HGNz98qkvfDAxsYN92ZFt5xYQn0XCNm9ZH4lFAKzgEdt9B/VnbvhGKkbGSi/7+cnro7SOIvrWPr05+4YxP8xO/7UaigcMRA+es7CmUwwxM/wnWiMOd9WMEUIYbWc5yvehsvQL9ZEhntnqqg1xw1TcCT+v6T0ygemON0g3s2usnOlH YvLQYYNp0kFmPcP2lom7MoPOwFIV99vPkzxHZMpXjRTuMI= 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:(13230016)(346002)(39860400002)(136003)(366004)(376002)(396003)(66946007)(76116006)(66446008)(41300700001)(66476007)(66556008)(2906002)(26005)(52536014)(478600001)(8676002)(64756008)(44832011)(8936002)(33656002)(86362001)(5660300002)(9686003)(6506007)(71200400001)(7696005)(38070700005)(55016003)(122000001)(38100700002)(110136005)(186003)(316002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?DyKe46yzfRinOwsC0wDsbuUnMHLcCw7/bJQT7EKX0CdvcXXYkmgZiSHJsomY?= =?us-ascii?Q?4iH9rczmVfOlzt1TG2vUHD0VEPqJRHHgi0EZ6jHtUcWZl5ezoEMYD4Ihao8K?= =?us-ascii?Q?fsSXwS0zsw9wmsTf2IYVtWIVeCc3lCLWykY3kxhY4lfPPqya373ejryUbK09?= =?us-ascii?Q?aJEhpjjOciV6mhhCrzSv77ztB05/2Ab2xc3OZe9JXINuUXWtIwC5CqizdamL?= =?us-ascii?Q?FMD3XTM4sa3hE1B4DyicnYcGBdJLojhOT8a6EBqIwxxq1ES5VURAv+CMEVYU?= =?us-ascii?Q?cVtVNVFY+a8ybAIoYsnnJ1i88C5acNQ5QNvtSwKz1Q2z3IJszGCka3xYq7vY?= =?us-ascii?Q?E1+1VTY99ZQusnmVhbboIEcDjVrzr1Zd5DCHWvKJIxCsgc02jAkr5fkLRMhL?= =?us-ascii?Q?xD7ktXFsTiEBcODsT5LnODI8AVvbxAdEsqyyO30QsPz9nwiXyn6GpTrLqgr+?= =?us-ascii?Q?g/380CwQIEd0TxqU0vNiRLrGLoSmrnDMaaML1QMYqSSytkm2J18zTypNiBFS?= =?us-ascii?Q?JwpEcyxME/39FVaxjS0/xAscrH9VIYV6RPnUJr1vUw5JcSgIR4EYaqqx2Lot?= =?us-ascii?Q?j1vIxl8wUlCzBFJjjE2Km8RuVsjKSrJFpLU/tGrw33GIfHVLOeHufet3LkrR?= =?us-ascii?Q?A3 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: 66ecca11-7320-433e-569b-08da5924e9eb X-MS-Exchange-CrossTenant-originalarrivaltime: 28 Jun 2022 16:40:30.3930 (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: WGF0F3bLUEuDWVSdM+1M5X79W+hcl1qhk9g7kQOtW6cEjIq+YoJs4uALZAnR0PWM8xqhf7avFePddYCElEcpdA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB3495 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.517, 18.0.883 definitions=2022-06-28_09:2022-06-28, 2022-06-28 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 mlxscore=0 phishscore=0 malwarescore=0 mlxlogscore=999 spamscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2204290000 definitions=main-2206280065 X-Proofpoint-ORIG-GUID: ATFva6VlaLmaL_W3YFVcxXeQ4FLa5fd7 X-Proofpoint-GUID: ATFva6VlaLmaL_W3YFVcxXeQ4FLa5fd7 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_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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:291689 Archived-At: > > All that's needed is to make clear that INIT > > isn't intended as a _substitute_ for a default > > value - and vice versa. That's really the point > > (IMO). The use cases of INIT are different from > > those of DEF. That's what should be made clear. > > Then leave it up to coders to use each as they > > see fit. >=20 > Mostly agreed. But as I said, I only intend to describe the current > coding recommendations better, and these don't regard INITIAL-INPUT and > DEF as equivalent alternatives. >=20 > As a compromise, here is a reworded version: Don't use this argument to insert a default--pass nil for INITIAL-INPUT and supply the default value DEF except in cases like inserting a prefix common to all completions or an initial part of a file name. The user can yank the default value into the minibuffer easily using M-n. Mostly agreed. ;-) Suggestion: Don't use this argument to insert a default value -- use DEF for that. You can use INITIAL-INPUT, for example, to insert a prefix common to all completion candidates. 1. "default value" instead of "default". 2. INIT is independent of DEF. Don't say not to use it except for XYZ. Instead, just say not to use it as a substitute for providing a default value. That was my point. 3. Give the example of inserting a common prefix as just that: an example. Don't suggest it's the only use case. 4. A filename prefix is just a prefix, no? 5. The doc already says that users can yank DEF with `M-n'. (Or if it doesn't then that should be said where DEF is described, not where INIT is described. ___ (The "prefix" insertion case is only particularly relevant when `completion-styles' favors prefix completion. With other styles the common text you insert isn't necessarily a prefix.)