GNU bug report logs - #78021
30.1; Unclear sentence in (emacs)Matching

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Reported by: Drew Adams <drew.adams@HIDDEN>; dated Wed, 23 Apr 2025 22:44:03 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 29 Apr 2025 17:16:58 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Apr 29 13:16:58 2025
Received: from localhost ([127.0.0.1]:60010 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u9oZm-0005Zp-9N
	for submit <at> debbugs.gnu.org; Tue, 29 Apr 2025 13:16:58 -0400
Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:28130)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew.adams@HIDDEN>)
 id 1u9oZj-0005Zc-F2
 for 78021 <at> debbugs.gnu.org; Tue, 29 Apr 2025 13:16:56 -0400
Received: from pps.filterd (m0333521.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53TH7RLA032091;
 Tue, 29 Apr 2025 17:16:54 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc
 :content-transfer-encoding:content-type:date:from:in-reply-to
 :message-id:mime-version:references:subject:to; s=
 corp-2023-11-20; bh=4mIgalYCnR5QR3297T//j/8CGhhi1ym125Wyq1cxLEo=; b=
 avAjL5twYis0Sps5ldRlCbE68L3txlKARebRrInSrAqcgcRemGN0mjIPCb50FMIc
 TkWtUCRKTxJ3UEvP0HiDhu17m6EyC77sclzkor6ZJGZF74MEDSxqCTocPdKqRKYq
 oL9SHU9KVXcSH6XimTru1fhCfyFAJu0Lw04jhmE/+r2v7I+bYK1hj3R5kf+fg+FB
 erd/EubckWOspcInhNhaZMBs/O73MjMS17+0/WO+tneDJkXa4oHCGhIfnqH4bj95
 l2Ab4AhUlWc43Iwq1OFXXvfJoom2NO6KThciXMNsZqtL56KZf4WtW+cHI1Ui/qKI
 WfnIDZJU4ndKqQvf2pGJIg==
Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com
 (iadpaimrmta01.appoci.oracle.com [130.35.100.223])
 by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 46b2vwg0rn-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Tue, 29 Apr 2025 17:16:53 +0000 (GMT)
Received: from pps.filterd
 (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1])
 by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2)
 with ESMTP id 53TGlZS3001309; Tue, 29 Apr 2025 17:16:52 GMT
Received: from nam10-mw2-obe.outbound.protection.outlook.com
 (mail-mw2nam10lp2045.outbound.protection.outlook.com [104.47.55.45])
 by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id
 468nxa6em4-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Tue, 29 Apr 2025 17:16:52 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=N9PTDLtI2n6mjTHYYV/vDJTX9A2VwuYc6vmSWh9RVVJdGSLnXCUdimk5laSSKF392mrd5497U4ZPJ4nlWWOTe62yrQcv+CIgGnZD5AmkAajiK0OrwV2GTXwTlMd+yNwhfYyazdwxEEM7AQk9q18nqo63xgn1rXTJl8mSkLp603oIjEK+VqBVmeflEFF0PJgwPVnSmiEkA2fpjRGNnoTncuRWl3i44ZZO2dEG7s5UhWDA8SXFAHKhuk4vc70yjDXCYhPbxQo7LyyYsmQRXO9j9jJ4AxzSP1EkA0oytiHXptQdPKnMeRNKhmUdA5gymBVtdE+1ccsgkD8/CB2S/1Zs8Q==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=4mIgalYCnR5QR3297T//j/8CGhhi1ym125Wyq1cxLEo=;
 b=gLx/JhtQOoDkZwLWUc8LaXNHPzYyW1TA3HayBO5zKYCdnP/o8PBvyeVE5413zO1+B3lj+4GnaGs8+n6cfD5z2FaJnTPD4vrc1MrkGcYAJ2YR464vRZJR3EwCQaY8KAOR/kxu1PWOkK3yv5N1iw6qwIb4Xce3akDIz5+XwUfsgleZ4srEDo1U3LscxkTVhCxs23qdNmwixks5EaAZ0d2TrWSkcHsrvZhVOPZRdW78x1yrod7xrk6CAJKkmx/rNurC6dyRudAPh3D1GNZGpnNQe7nTP74zuXlrXtrpqq1e1dik6FYKcj770aj/YpJbnh4h9VjgPvEgmvO9NqidezT7uQ==
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=4mIgalYCnR5QR3297T//j/8CGhhi1ym125Wyq1cxLEo=;
 b=CV2ADLhxbrcuRGL1Y3qs2oMlN1JizEgnCHsVUlagWF+UDrQvsXN/GUEoaLBT8+r8pEEBgrixupRrwkJZkOVKIhPE/+B2UQknUoJPteXjWUdZnIP4GUlUMuNmOYqfKKNhiMAlroETTsUBBcAKVmJpsVFLEWH5h+vRssFYbhe2qrQ=
Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24)
 by MN2PR10MB4399.namprd10.prod.outlook.com (2603:10b6:208:1d9::24) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8678.33; Tue, 29 Apr
 2025 17:16:47 +0000
Received: from DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.040; Tue, 29 Apr 2025
 17:16:47 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
Subject: RE: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Topic: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Index: AQHbuO9vZd2t05verUGbwKyqXimbq7O64leg
Date: Tue, 29 Apr 2025 17:16:47 +0000
Message-ID: <DS7PR10MB5232DB563372E27B97EBADE1F3802@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <87h62c6w63.fsf@HIDDEN>
 <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
 <87cyd06qhe.fsf@HIDDEN>
 <DS7PR10MB5232D0A02C54EB8DA10DF314F3842@HIDDEN>
 <874iy7qnri.fsf@HIDDEN>
In-Reply-To: <874iy7qnri.fsf@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|MN2PR10MB4399:EE_
x-ms-office365-filtering-correlation-id: ab83aa72-e120-4c79-67d0-08dd87419f6a
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0; ARA:13230040|1800799024|376014|366016|38070700018;
x-microsoft-antispam-message-info: =?us-ascii?Q?QsX5Yq/XLg8VUJTMqV7RTqHvTbdwKfft7p9vqcvwQl7E+/WG0qhQpuzjLZ9m?=
 =?us-ascii?Q?FWtC3wdrTkXighYMqfSrhq3yGOlile+Sha2MVV/CnD5N2h84Ury+EksUgAWb?=
 =?us-ascii?Q?jTag/WPN0Q7QAwDMPNfP9K9Pl65HDPIAEmcaupJMNHEiRnZeqynczlWvHG+f?=
 =?us-ascii?Q?wg/FZdCbPawSzvgOLtrZEkHkpDC3MaMDMKkBiW/Q5XV4Zo5CVw/EsJ8CXcfD?=
 =?us-ascii?Q?dADs5uglIewal4zcGnODgXnaKi96cu6tPHdoSM1BbH9zCWV+wbeUvbfJZQM1?=
 =?us-ascii?Q?9eE+j3eiG2LyYmJBVNOQ7BOp3aODzrTlvvGpppqoOqY2RoY4Fq/pN3Euyxzq?=
 =?us-ascii?Q?1Yio+RaS8JfqBv3jEt10/uOudptv4ztbeNJpvoXIP3ShfSBtxfcDlIqfo2HO?=
 =?us-ascii?Q?CMFztUsup9GyabDP6Z7EaBzonE4GQYRrvz4EsEUPBYwaMVOAck4hVph1VwjR?=
 =?us-ascii?Q?hlRx+qVLclIFhC/eQaWibo+S4O2EFkYogIi9aYX4q2dIPfvfGBgGf7269GVt?=
 =?us-ascii?Q?7GxgHiYsJKCt2Iphyc35lSKLHvLPQ3XN/tXo+vVTM9F25rvCE/iY6BltKP/j?=
 =?us-ascii?Q?HvXn0mxoE30qS8DHd8dsUehfQUsPmd9qY7hqUjMFXWMXjjQOoGdVcAybVHMJ?=
 =?us-ascii?Q?wsR6m6UxlX/ncnxH4LpQhJiyptm8uK9de9JMkbJyK+ANn+kKUHLqOWArLedE?=
 =?us-ascii?Q?5Qm7A/vhOgBHjx2926rFU1HBGhDTpKfQaWh44jPo+EOzxqifWw+lZGA/N5Zx?=
 =?us-ascii?Q?AoqMkSQ14Tb6D24z5gVsx+kzpyQAm6+r+8EN+Y4r7/bGO3y52aEcnN2XomaG?=
 =?us-ascii?Q?J7InGkme3hm6A3507jLPOpFJyuDVfFAQdX2Ycextk0oMf/2b7Iumdq8GRz7h?=
 =?us-ascii?Q?oNMoa9oanCDzPZHdMJqKfeB4Ghj9JhNj0lxerozeUFnfUQl78OrkASx8S2MA?=
 =?us-ascii?Q?usVF9/MwwGZKUmiH/2Yu4FUuRKU89PtmotvXya9nXHzvaXX9zRJbY3sLaLDC?=
 =?us-ascii?Q?exwELLNSHIPb5SZNBys6mBtVN/TrAzDfPUD4VzQiE/fDMAU0bJEW4LqY8+0v?=
 =?us-ascii?Q?GVAPqe+IEkKKLeyUZrdTrCPBDtHS/v4inznkqwDUPmwxOorVuaVbZzkNnBjs?=
 =?us-ascii?Q?p7lY+K6H8V1GeeS+lXLoBJvgHwPuxR9sfBxVUbmmQ8/+2jfpzAghn6NkQBsp?=
 =?us-ascii?Q?nnLWujaRnQ7WRajNHM95HJb12WmlAPvcTlXxcCx5eipgrs/nyRri4PRB3Eih?=
 =?us-ascii?Q?6UVZ6eGHtYjfVBl8zjpOu9KZ3tzWkkRgp2BUBbncxrVWubaCiRA/t2AKVOqL?=
 =?us-ascii?Q?ZnNYfSvBtZLqzV6OJhhR2RffFB92TabdI3RsuOmTCLlw6O78UGOat0zhLMz2?=
 =?us-ascii?Q?N2Rf6nMqRxbD0oRMzD+X66m4C1XKEwtDFlQoazH6TgIuBW1OJuXtSVWdSUbL?=
 =?us-ascii?Q?oijKm/RwPyu0X/XOxKcHucA0VptlgumgJoPLZLY64ZrbtW4ZZCj67w=3D=3D?=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(13230040)(1800799024)(376014)(366016)(38070700018); DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?37JZr4wojYuYQZPJvKKSa7wqjdy1UZoeqIlmx6rn9RPYUHottfdzoiKhqu+q?=
 =?us-ascii?Q?92oLYyFjat/Gw6LIou0CCf+UFzREwnVnAVoyXr+ZlGvIujSywpK7JWz0gmIO?=
 =?us-ascii?Q?Fw3XA3Ti8w8uo9AsPBqo5fxswhn1KWcn4QgprKDPk09ucXO0TC6bknDuUSVr?=
 =?us-ascii?Q?tzAxppKePDC8KiBPqlP4azra4b8KMti11cu4PtTg0Q0NOgPqyYIUyxiOskYM?=
 =?us-ascii?Q?JiGicw4OG3Cc7Op000YT4fGVls1cnTHdpwhLCMtv4ehf9q8S786UTPgWkfRX?=
 =?us-ascii?Q?awrU8gZ/tSiQ3EFWaF29n2OlI13sqm2Yhf5LHV03/1dX2Vm9L/1dWK+NfzYD?=
 =?us-ascii?Q?Uk/iIKUALlGrXQqG9IVFvjEkLdPoHNiZrDJvPNJMBcnLxqDH4CbNJUO4w/Xt?=
 =?us-ascii?Q?Dr2apjGcNH/wPrT5sLOtuVq8RGQ61VwJz8wtaWOF9b4yDdVlvVfXW3mPX5JH?=
 =?us-ascii?Q?0PaJDg1piKvPxjS0jE4u9ylvG8E55zA7I46vt6XLIzVfUDDe83mNUNzLuJiq?=
 =?us-ascii?Q?na4+m2kaovWCrkKc9uJLy73LOp6diUrRMBiwutHFozqeEl1Nc1fRHshRknaI?=
 =?us-ascii?Q?1iifIAP9GMeR+oR2tXtwNiwpgFxVUGSA5WhzaFuvEcr3OkZKS2rvH9qH+uUV?=
 =?us-ascii?Q?+QhfXrvubnsVeqXVAroXruAYRBOiGkaIkasm2xxJvFYOR5BIhMhqkIdBpGoX?=
 =?us-ascii?Q?EXoXbjo/e3GLsnx/qATHpWF3T1+6VVc67IV6R+0WEo52rM+uB5R070NltZwc?=
 =?us-ascii?Q?3moMT1L+Y5eWc1rEqLxzckivKy6vQXIDLBOpJ+m375OXJrtkYAw9iHAyfmGm?=
 =?us-ascii?Q?OXBRqmZ+03v/9Um1BQuRz+0rx1av8dv5CZ+Qm3kRgv8tRY1GjjkTK1g6xYYf?=
 =?us-ascii?Q?0fB7PPz9ksRACAKxp/o8u92uRTmWIx6WiyFUS6hfrpsivx2Im0pF4v60GOhd?=
 =?us-ascii?Q?9OX8AkYKcCiBsFV7qRagSagg2t7voWKaVptrjeQVHfgwlMqNYU7EmYXMwWWA?=
 =?us-ascii?Q?NWjEKyyfUk6m31RJNI+ZPV7Mf0IoSCVGtNY5xZvKIM9XlSFTfdrlXT1XDkoF?=
 =?us-ascii?Q?l1BKHHucmfyoVOHu4LvsZvBj4FM/eEkFT2cGk3gRwcW5CFYYfGH+u4KN14Jx?=
 =?us-ascii?Q?+M4eTIq1/apszJPLk14EtxqQRWfJRQ8HDdlJCOpGc3bFISuH0JcZ5VxTmQuz?=
 =?us-ascii?Q?ShqrjC9KQDk9cm2j2ILxV1XQ3Fjzl2V6mmFC5Gu7WD/NzlowxYDcNP3XqGMp?=
 =?us-ascii?Q?8C/+xULns/KZ5YGeM2wudTJ1Y4OcjGj7eAx2DTyb4yACuGtZKOWvbNdlvDAE?=
 =?us-ascii?Q?d3BGS/SBbIIeseqR0uljYtn4R+pal79CLdXYK+SI9qYUSUbyaNGFB2aX+uua?=
 =?us-ascii?Q?Di5pX5NYU9GTfuuaPk3YYFMG8WlgJ6vSo1Y3ck0yAFJtohF3/6yaQgwMY+Yq?=
 =?us-ascii?Q?WrKwIRg7jDGRpUqvnmfwEy0DdJfiC9PgN+8dU9SgmgWrIays4vcTkJZE8Urp?=
 =?us-ascii?Q?bMpbBRldhKKm27Q5caRdOwei4iWK8yqhKG0gNtPr48U1xOg3WJT3Bxp62sv7?=
 =?us-ascii?Q?PCWMZ8KznfvPepB7XrPzJeWuSvxf5wRovgFdaGq7?=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: WmTSjW2iAkghHVOJJW0+ZtNcUBe+8NG9simDS6fDoFHJV1IxOT4XUZ/rRjbZoxnA57fnZqD45L6StIr3ES79Bqid2ncxQUpqlPue8VgH5nusY3BFoiRG7nNUJnf81M08L9JcqjLISr18Z3MwmLzBP1RzRdaYnC2qEuOYJ8q/4mb5RBMnlEsr+xcsnvcQwRkZ+i76Tp06B9wkIIaNie9KasSMlUhe/In0qSMZgOu3A1mwztycYJM4qTPEV8T8ky9oeInIsEulChINkA7i6BLxFtJOEFT9sm/oNaEplB1RNYtyQahPVVb1cCgxCJtsJ/H+kNb4AWePVRrzlDXgRb+afwHOvK6X116ZsY6zrVd7nnLnU4vCdWT7P3ZQ5OZYRxVUUHINi/Zmw7LGwxRI18TZtsXsH3iFTFap7GeaUEiW8pXd8J92m1l/yq1daJgNh4fp7UjiVT3NURW5qo3Gt739e6ChqKdgQHKij+tTKCNMCfvAFn40WUhAOC+MjTwEHs9VLm7cMpbHburBj4wACiKrExVGPxICRM4Sh4ZHKFRQiUiVi8tI280fhOofSariRQkV1SAl9xQRmBixm5JdQSKNFfHzIFxYpX57bcN/PhL3trU=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: ab83aa72-e120-4c79-67d0-08dd87419f6a
X-MS-Exchange-CrossTenant-originalarrivaltime: 29 Apr 2025 17:16:47.3604 (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: 5Fqj9ne9PQdGcp8zEDMByq7TWzS2xQ7yMlI++KqCMmAQRZJtIDBJCsymH89Z2x1p607Xj8cZvCMuaQ20bzNnYA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR10MB4399
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40
 definitions=2025-04-29_06,2025-04-24_02,2025-02-21_01
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0
 spamscore=0 bulkscore=0
 mlxlogscore=999 adultscore=0 suspectscore=0 malwarescore=0 phishscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2504070000
 definitions=main-2504290127
X-Proofpoint-GUID: -BDq945DpqgtOjxEmTl6_JFC3st7p6Np
X-Proofpoint-ORIG-GUID: -BDq945DpqgtOjxEmTl6_JFC3st7p6Np
X-Authority-Analysis: v=2.4 cv=XJcwSRhE c=1 sm=1 tr=0 ts=68110985 b=1 cx=c_pps
 a=zPCbziy225d3KhSqZt3L1A==:117 a=zPCbziy225d3KhSqZt3L1A==:17
 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=wKuvFiaSGQ0qltdbU6+NXLB8nM8=:19
 a=Ol13hO9ccFRV9qXi2t6ftBPywas=:19
 a=xqWC_Br6kY4A:10 a=kj9zAlcOel0A:10 a=XR8D0OoHHMoA:10 a=GoEa3M9JfhUA:10
 a=vPRSdNVDNuyt9Fit6mQA:9 a=CjuIK1q_8ugA:10 cc=ntf awl=host:13129
X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDI5MDEyNyBTYWx0ZWRfX2EbTLKNQyee0
 jKTsDlIhNHKSvtxbkuXOPMJoSppOkN0FAOADUnvL1sBYt/c20NU9bYKOQzJEWe1uj7PgsmVK8AP
 IhvulXknIulv45Ws09iweJEJ4erd4jeG6mPv8LUa7Cr/KARHO3U3uQWpAEkl8kGIDrlPaIiz3ci
 eb2qdKqXBxl19CK8GO28F+YuDg+MvY8nRur2G58gPeiVxNkyICCzmkWmkDNEjxUsBNR4zf7r1fT
 Cq6SldrScJXnRQp4OXONjUzR+OEKRtO4+ccHzrEzTO9YepNWcZWMPA86x/lQy3EPnVKVKL4AMRE
 VfgT3zX/sJu159BQl5n20mScNLWEdd0uYXq1DxNaG1veiFN/RblfFtli9XPjsvLJmsCo5JpdiLd
 reaKxGt2
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

> > I do think so.  Ordinary users of all stripes are encouraged
> > to file bug reports and enhancement requests.  They shouldn't
> > need to access texi sources or be familiar with diffs or
> > patches.  Especially for doc changes.  Just tossing them a
> > patch discourages such participation.
> >
> > I write technical docs.  There's no way we would expect our
> > reviewers to fiddle with source input (XML) to the doc process
> > or diffs/patches, even though they're all competent software
> > people.  Reviewing doc is about reading text, and preferably
> > doing so in context.
> >
> > Think about this: Surely you didn't _write_ your improved
> > text in the form of a diff.  You wrote it as ordinary text,
> > and you probably did so reading the surrounding context as
> > ordinary text.  And even if you didn't, mere mortals would.
>=20
> Of course I didn't write the diff by hand, but I did make changes
> directly in the .texi file and then the easiest and quickest way (for
> me) to see the changes in context, and present them to others, is to
> generate a diff.  To extract plain text out that is an added burden for
> me (granted, probably in most cases only a small one).  But I shouldn't
> have presumed to judge what is burdensome for others.

Too burdensome for me, to deal with the diff.  And I don't
want to have to track down the current doc state that it
applies against, and use the patch to create the new doc
state from that, to be reviewed.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 29 Apr 2025 10:13:56 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Apr 29 06:13:56 2025
Received: from localhost ([127.0.0.1]:50135 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u9hyO-0005Oq-40
	for submit <at> debbugs.gnu.org; Tue, 29 Apr 2025 06:13:56 -0400
Received: from mout.gmx.net ([212.227.17.22]:57131)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u9hyD-0005N8-En
 for 78021 <at> debbugs.gnu.org; Tue, 29 Apr 2025 06:13:51 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745921610; x=1746526410; i=stephen.berman@HIDDEN;
 bh=adOeED0FX4pdBDmMxdV6REW658WjRQ7tDWAZl2y2tto=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:cc:content-transfer-encoding:
 content-type:date:from:message-id:mime-version:reply-to:subject:
 to;
 b=NQ0rvFEUyVfZvGkU5O2VFKIUzX/5B7hZi9b4gf6cezvw5RT99eEnGUMiAmB/8dv/
 reNKHNcjMoNMBYl+IXdfFXE0GuJSrIK8304cIbv2kCE8OERxerJm0V1fWIjw7mhOr
 CVxyW05JG8FbVDK/drtw1i3FCpF7gMgBvqAeqHELLf1NwymkvYoTmid8mEeBHaqp0
 6tl8+n8Bj94AAwg4nwlcZQ/czmcWuW1m0bCnqTyGYaqJPhzBm+Db2+V8VW0i0MkDg
 wGrguBG1iAr+JUiGl95/0PajhIta4EzbzhzpgV0xR+i0REz/U5mCxwvwMKb9LkDt8
 uR810mj3GWcYja21yg==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.126]) by mail.gmx.net (mrgmx105
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MZCbB-1uW2Bc42pl-00Odet; Tue, 29
 Apr 2025 12:13:30 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#78021: 30.1; Unclear sentence in (emacs)Matching
In-Reply-To: <86wmb7uy04.fsf@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <86wmb7uy04.fsf@HIDDEN>
Date: Tue, 29 Apr 2025 12:13:28 +0200
Message-ID: <8734drqnqv.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:LAS7clWcHZHPyoFzy/9OwE60yJgP58LomaAvWFSh83JUHkK/kJn
 G6s94Vey3kUTF6lCJ5sTOeP3RUBC0GS4fqwz9JqoZBR1wjXmdpd1X5+OFeTeaatkQ6Whu3r
 NWizT1CoLVh2py+ZTar09Rz+n9QrmNle4knJSg5cIw0gW8kZHTROw+w3LVGl3rKVpmMMIcA
 9l/UmKlnSysOuGZN6q05A==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:YIZ3Q4McU6s=;hzowjx6+81FKogfq1zkVDOb44we
 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
X-Spam-Score: 2.9 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  (Sorry for the delayed reply.) On Sat, 26 Apr 2025 11:29:15
 +0300 Eli Zaretskii wrote: >> From: Stephen Berman >> Cc: eliz@HIDDEN,
 drew.adams@HIDDEN
 >> Date: Fri, 25 Apr 2025 15:48:54 +0200 >> >> I've attached a patch for
 emacs-30 and have several remarks concerning >> it. First, [...] 
 Content analysis details:   (2.9 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 0.0 RCVD_IN_VALIDITY_SAFE_BLOCKED RBL: ADMINISTRATOR NOTICE: The
 query to Validity was blocked.  See
 https://knowledge.validity.com/hc/en-us/articles/20961730681243
 for more information.
 [212.227.17.22 listed in sa-accredit.habeas.com]
 3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
 [94.134.95.126 listed in zen.spamhaus.org]
 0.0 RCVD_IN_VALIDITY_RPBL_BLOCKED RBL: ADMINISTRATOR NOTICE: The
 query to Validity was blocked.  See
 https://knowledge.validity.com/hc/en-us/articles/20961730681243
 for more information.
 [212.227.17.22 listed in bl.score.senderscore.com]
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
 low trust [212.227.17.22 listed in list.dnswl.org]
 0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
 provider (stephen.berman[at]gmx.net)
 -0.0 SPF_PASS               SPF: sender matches SPF record
X-Debbugs-Envelope-To: 78021
Cc: 78021 <at> debbugs.gnu.org, drew.adams@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.9 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  (Sorry for the delayed reply.) On Sat, 26 Apr 2025 11:29:15
    +0300 Eli Zaretskii wrote: >> From: Stephen Berman >> Cc: eliz@HIDDEN, drew.adams@HIDDEN
    >> Date: Fri, 25 Apr 2025 15:48:54 +0200 >> >> I've attached a patch for
   emacs-30 and have several remarks concerning >> it. First, [...] 
 
 Content analysis details:   (1.9 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
  3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
                             [94.134.95.126 listed in zen.spamhaus.org]
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
                             low trust
                             [212.227.17.22 listed in list.dnswl.org]
  0.0 RCVD_IN_VALIDITY_SAFE_BLOCKED RBL: ADMINISTRATOR NOTICE: The
                             query to Validity was blocked.  See
                             https://knowledge.validity.com/hc/en-us/articles/20961730681243
                              for more information.
                             [212.227.17.22 listed in sa-accredit.habeas.com]
  0.0 RCVD_IN_VALIDITY_RPBL_BLOCKED RBL: ADMINISTRATOR NOTICE: The
                             query to Validity was blocked.  See
                             https://knowledge.validity.com/hc/en-us/articles/20961730681243
                              for more information.
                             [212.227.17.22 listed in bl.score.senderscore.com]
  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (stephen.berman[at]gmx.net)
 -0.0 SPF_PASS               SPF: sender matches SPF record
 -1.0 MAILING_LIST_MULTI     Multiple indicators imply a widely-seen list
                             manager

--=-=-=
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

(Sorry for the delayed reply.)

On Sat, 26 Apr 2025 11:29:15 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Stephen Berman <stephen.berman@HIDDEN>
>> Cc: eliz@HIDDEN,  drew.adams@HIDDEN
>> Date: Fri, 25 Apr 2025 15:48:54 +0200
>>=20
>> I've attached a patch for emacs-30 and have several remarks concerning
>> it.  First, regarding my first point above, since the parent node
>> already says "The major mode controls which delimiters are significant
>> [...]", I now think there is no need to reiterate it here.
>
> I think it is still a good idea to mention that.  The manual is not
> always read in the logical order of the chapters and sections.  In
> fact, in most cases people are supposed to use Info-index to land
> directly on this text and read it without reading the parent section.
[...]

Thanks for you're detailed critique of my patch; I agree with almost all
of your points, and in the attached patch tried to take them into
account.  I also spent some time trying to better understand the effect
of the user options mentioned in this node (there are other user options
in electric-pair.el but they require writing Lisp, which I suppose is
why weren't documented in the Emacs manual, and I don't think they
should be added).  This has resulted in (I hope) more accurate and
clearer, but also longer, descriptions.  If you find them too long or
still not clear enough, I welcome suggestions to improve them.  For this
reason I haven't yet tried to improve the doc strings of the options,
and would also welcome suggestions for these (in particular, for the
first line of each option).

Steve Berman

--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: programs.texi patch
Content-Transfer-Encoding: quoted-printable

diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 820a772104e..7cd57584061 100644
=2D-- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -1063,52 +1063,96 @@ Matching
 @cindex Electric Pair mode
 @cindex inserting matching parentheses
 @findex electric-pair-mode
-  Electric Pair mode, a global minor mode, provides a way to easily
-insert matching delimiters: parentheses, braces, brackets, etc.
-Whenever you insert an opening delimiter, the matching closing delimiter
-is automatically inserted as well, leaving point between the two.
-However, if you insert a closing delimiter where one already exists
-(probably a mistake, since typing the opening delimiter inserted the
-closing one for you), Emacs simply moves point to after the closing
-delimiter, skipping the insertion.  If the region is active
-(@pxref{Mark}), insertion of a delimiter operates on the region: the
-characters in the region are enclosed in a pair of matching delimiters,
-leaving point after the delimiter you typed.  If you provide a prefix
-argument when inserting a delimiter, the numeric value of that prefix
-argument specifies the number of pairs to insert.
-
-These variables control additional features of Electric Pair mode:
+  Electric Pair mode is a minor mode that provides a way to easily
+insert pairs of matching delimiters: parentheses, braces, brackets,
+quotes, etc. (what counts as matching delimiters depends on the major
+mode).  To toggle Electric Pair mode globally, type @kbd{M-x
+electric-pair-mode}.  To toggle it only in the current buffer, type
+@kbd{M-x electric-pair-local-mode}.
+
+  When this mode is enabled, typing an opening delimiter inserts both
+that character and, immediately following it, the matching closing
+delimiter, leaving point between the two.  This makes it unnecessary to
+type a matching closing delimiter in most cases.  If you type one
+nonetheless, Emacs simply inserts that character, unless point is
+immediately before a closing delimiter of the same type; in that case,
+point moves to immediately after the closing delimiter and no additional
+closing delimiter is inserted.  Thus, typing the sequence <opening
+delimiter>, <matching closing delimiter> is a perhaps more convenient
+alternative to the sequence <opening delimiter>, @kbd{C-f}.
+
+  With an active region (@pxref{Mark}), Electric Pair mode operates
+differently: inserting either an opening or a closing delimiter encloses
+the characters in the region within the resulting pair of matching
+delimiters, leaving point after the delimiter you typed (this
+facilitates continuing to type either before the text following the
+opening delimiter or after the closing delimiter).
+
+  There are several user options for modifying the behavior of Electric
+Pair mode:
=20
 @itemize @bullet
 @item
 @vindex electric-pair-preserve-balance
-@code{electric-pair-preserve-balance}, when non-@code{nil}, makes the
-default pairing logic balance out the number of opening and closing
-delimiters.
+@code{electric-pair-preserve-balance}, when non-@code{nil} (the
+default), makes typing a delimiter preserve the balance between opening
+and closing delimiters.  Thus, if there is an unmatched closing
+delimiter of the same type later in the buffer, then only the opening
+delimiter gets inserted (and not a matching closing delimiter
+immediately following it); likewise, if there is an unmatched opening
+delimiter, then typing a closing delimiter of the same type later in the
+buffer inserts this character even when the following character is
+another closing delimiter of the same type.
+
+  When set to @code{nil}, typing an opening delimiter inserts only this
+character, but only when point is either immediately before or
+immediately after an opening delimiter of the same type, or immediately
+before a letter or digit; in all other positions inserting an opening
+delimiter automatically inserts a matching closing delimiter immediately
+following it, even if there is an unmatched closing delimiter of the
+same type later in the buffer.  And typing a closing delimiter
+immediately before another closing delimiter of the same type does not
+insert that character but moves point as described above, even when
+there is an unmatched opening delimiter of the same type earlier in the
+buffer.
+
+  With an active region, the effect of inserting a delimiter is as
+described above regardless of the value of this variable.
=20
 @item
 @vindex electric-pair-delete-adjacent-pairs
-@code{electric-pair-delete-adjacent-pairs}, when non-@code{nil}, makes
-backspacing between two adjacent delimiters also automatically delete
-the closing delimiter.
+@code{electric-pair-delete-adjacent-pairs}, when non-@code{nil} (the
+default), makes deleting an opening delimiter by typing the @key{DEL}
+key (which is normally the @key{BACKSPACE} key) automatically also
+delete an immediately following closing delimiter (but not if there are
+any characters---including just whitespace---between the matching
+delimiters).  When set to @code{nil}, typing @key{BACKSPACE} deletes
+only the opening delimiter.  (Typing @key{BACKSPACE} to delete a closing
+delimiter always deletes only this character.)
=20
 @item
 @vindex electric-pair-open-newline-between-pairs
-@code{electric-pair-open-newline-between-pairs}, when non-@code{nil},
-makes inserting a newline between two adjacent pairs also
-automatically open an extra newline after point.
+When @code{electric-pair-open-newline-between-pairs} is non-@code{nil}
+(the default) and point is between an opening delimiter and an
+immediately following closing delimiter, then typing a newline
+automatically inserts an extra newline after point (possibly indenting
+the empty line point is on, depending on the major mode).  When set to
+@code{nil}, typing a newline insert only one newline before point, as
+usual.
=20
 @item
 @vindex electric-pair-skip-whitespace
-@code{electric-pair-skip-whitespace}, when non-@code{nil}, causes the min=
or
-mode to skip whitespace forward before deciding whether to skip over
-the closing delimiter.
+When @code{electric-pair-skip-whitespace} has its default non-@code{nil}
+value and point is separated from a closing delimiter only by
+whitespace, then typing a closing delimiter of the same type does not
+insert that character but instead moves point to immediately after the
+already present closing delimiter.  You can also set this option to
+additionally delete any white space that point moves over.  When set to
+@code{nil}, typing a closing delimiter simply inserts that character
+(thus making the following closing delimiter of the same type
+unbalanced).
 @end itemize
=20
-To toggle Electric Pair mode, type @kbd{M-x electric-pair-mode}.  To
-toggle the mode in a single buffer, use @kbd{M-x
-electric-pair-local-mode}.
-
 @node Comments
 @section Manipulating Comments
 @cindex comments

--=-=-=--




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 29 Apr 2025 10:13:22 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Apr 29 06:13:21 2025
Received: from localhost ([127.0.0.1]:50123 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u9hxp-0005L7-Bi
	for submit <at> debbugs.gnu.org; Tue, 29 Apr 2025 06:13:21 -0400
Received: from mout.gmx.net ([212.227.17.20]:38909)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u9hxn-0005K9-5K
 for 78021 <at> debbugs.gnu.org; Tue, 29 Apr 2025 06:13:19 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745921587; x=1746526387; i=stephen.berman@HIDDEN;
 bh=QSuPVSdmsqIicO/S9kLoFETpzlWS43lzcq52sRaX0rc=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=SdcRiRJi26MnXfWcHw+E1z/b/gNDpDerIG5Jc/BdEnueMPk0CAsFGQHMh+WZ9/j5
 TFHqr0vCYj+w5vkemC5Rix55OcJuap7od2vE24RnX9zjAPuNhBn7kAE5xpIwSOkGM
 33nqOVj+ymAkZaez4EkMVlPYsw3CJeD9cYs7C9byZ4FC6PWiNPE0VBnITbhk4Eg4q
 68DUppRUrEhlNRJClSWZKa2b2eOLcH/Znw76HB5PRkt65aJ5xtrTwTC7Q8nqIUNzB
 l2mbDoBdHFDI1AzYAbdLtRgV/YExR8Gf6OYEIrVmkttmPvtONzgA8mFNQdv6TQDPc
 6x1/kQ8Ycp+2JEd/dw==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.126]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MQvD5-1uOuer3O0F-00WFEI; Tue, 29
 Apr 2025 12:13:06 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
Subject: Re: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
In-Reply-To: <DS7PR10MB5232D0A02C54EB8DA10DF314F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <87h62c6w63.fsf@HIDDEN>
 <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
 <87cyd06qhe.fsf@HIDDEN>
 <DS7PR10MB5232D0A02C54EB8DA10DF314F3842@HIDDEN>
Date: Tue, 29 Apr 2025 12:13:05 +0200
Message-ID: <874iy7qnri.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:lYUDL8Mnua3wZFOa16DZqR3gjE0cIWtrrYKre2C2g9a3T8MbuC7
 lehKRQs0vyaSd2XQweL5cUBSEmL707YLYUoq77aOb+G9WM6CAhAK1gMi0OLGrtIwhBpaazH
 NZ7fQ/KuNBmfB62GO3+VD2icv6XKzFNJfKfet+Ae2v9Vi9Rul0NffFnsgq/Hu4ciYOnUIfX
 vaumYbhwIMUxycdH9Xnkw==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:FY5932XcwhA=;vlITKkslIP06JLeYBacD1/rNc2A
 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
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 2.9 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  (Sorry for the delayed reply.) On Fri, 25 Apr 2025 20:23:34
 +0000 Drew Adams wrote: >> > Not clear enough: >> > "with only white space
 between the delimiters". >> > Only whitespace between which delimiters? There
 are >> > presumably at least 3 delimiters in this scenario, one >> > op [...]
 Content analysis details:   (2.9 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
 [94.134.95.126 listed in zen.spamhaus.org]
 0.0 RCVD_IN_VALIDITY_SAFE_BLOCKED RBL: ADMINISTRATOR NOTICE: The
 query to Validity was blocked.  See
 https://knowledge.validity.com/hc/en-us/articles/20961730681243
 for more information.
 [212.227.17.20 listed in sa-accredit.habeas.com]
 0.0 RCVD_IN_VALIDITY_RPBL_BLOCKED RBL: ADMINISTRATOR NOTICE: The
 query to Validity was blocked.  See
 https://knowledge.validity.com/hc/en-us/articles/20961730681243
 for more information.
 [212.227.17.20 listed in bl.score.senderscore.com]
 0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
 provider (stephen.berman[at]gmx.net)
 -0.0 SPF_PASS               SPF: sender matches SPF record
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
 low trust [212.227.17.20 listed in list.dnswl.org]
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.9 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  (Sorry for the delayed reply.) On Fri, 25 Apr 2025 20:23:34
    +0000 Drew Adams wrote: >> > Not clear enough: >> > "with only white space
    between the delimiters". >> > Only whitespace between which delimiters? There
    are >> > presumably at least 3 delimiters in this scenario, one >> > op [...]
    
 
 Content analysis details:   (1.9 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
  0.0 RCVD_IN_VALIDITY_SAFE_BLOCKED RBL: ADMINISTRATOR NOTICE: The
                             query to Validity was blocked.  See
                             https://knowledge.validity.com/hc/en-us/articles/20961730681243
                              for more information.
                             [212.227.17.20 listed in sa-accredit.habeas.com]
  3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
                             [94.134.95.126 listed in zen.spamhaus.org]
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
                             low trust
                             [212.227.17.20 listed in list.dnswl.org]
  0.0 RCVD_IN_VALIDITY_RPBL_BLOCKED RBL: ADMINISTRATOR NOTICE: The
                             query to Validity was blocked.  See
                             https://knowledge.validity.com/hc/en-us/articles/20961730681243
                              for more information.
                             [212.227.17.20 listed in bl.score.senderscore.com]
  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (stephen.berman[at]gmx.net)
 -0.0 SPF_PASS               SPF: sender matches SPF record
 -1.0 MAILING_LIST_MULTI     Multiple indicators imply a widely-seen list
                             manager

(Sorry for the delayed reply.)

On Fri, 25 Apr 2025 20:23:34 +0000 Drew Adams <drew.adams@HIDDEN> wrot=
e:

>> > Not clear enough:
>> > "with only white space between the delimiters".
>> > Only whitespace between which delimiters?  There are
>> > presumably at least 3 delimiters in this scenario, one
>> > opening and two closing.
>>=20
>> The scenario is like this: "some text (     ) more text", and the user
>> types ")" somewhere between the pair of parens.  If you can think of a
>> clearer way of describing this just as briefly, I would be grateful (El=
i
>> requested that the node should not become much longer).
>>=20
>> > Not clear enough:
>> > "to after the closing delimiter".
>> > Which closing delimiter?
>>=20
>> The one in the text scenario given above, which is the only actual
>> closing delimiter character in the text -- the "other closing delimiter=
"
>> is still just the key being typed, but the character is not inserted (a=
s
>> the description says).  Here, too, I would welcome a clearer but just a=
s
>> brief description.
>>=20
>> >                           Immediately after it?
>> > If not, where after it?
>>=20
>> Yes, immediately or directly after it.  Perhaps adding one of those
>> words would be acceptable.
>
> Quite complicated.  Maybe should include an illustration.
>
>   However, if you try to insert a closing delimiter between
>   a matching pair of the same type, which are not separated
>   or are separated only by whitespace, then there's no
>   insertion and point is moved immediately after the closing
>   delimiter.  For example, if you try to insert `)' at | then
>   for `(|)' the result is `()|', and for `(    |  )' the
>   result is `(      )|'.
>
> Or maybe:
>
>   However, if only whitespace (or nothing) is delimited, and
>   you try to insert a closing delimiter of the same type
>   between the delimiters, it's not inserted.  Instead, point
>   is put immediately after the closing delimiter.  For example...=20
>
> But a reasonable question is why?  Why is that the chosen
> behavior?  And why is delimited whitespace special here?
> Explaining _why_ would itself take readers a long way toward
> understanding _what_ the behavior is.  IOW, start by saying
> what the problem is that this behavior tries to solve.

Thanks for the suggestions, which in principle I agree with.  However,
this is starting to sound like a project more appropriate for a separate
Info manual for Electric Pair mode, which I don't want to undertake,
because I have neither enough familiarity with the code nor the time to
familiarize myself with it and then satisfactorily document it.  I'm
already finding it hard than I thought it would be to make the necessary
relatively small doc changes suitable for the Emacs manual.

[...]
>> > Thanks for working on this.  And thank you for
>> > providing the proposed text (for the part concerning
>> > this bug).  When reviewing doc changes we shouldn't
>> > have to decipher a diff or apply it.
>>=20
>> Since dealing with diffs is standard fare here, and they are generally
>> required by those who decide whether to accept the changes, and those
>> who install the changes to the source repository, I don't think it's
>> unduly burdensome on other interested participants to expect them to be
>> able to deal with them too.
>
> I do think so.  Ordinary users of all stripes are encouraged
> to file bug reports and enhancement requests.  They shouldn't
> need to access texi sources or be familiar with diffs or
> patches.  Especially for doc changes.  Just tossing them a
> patch discourages such participation.
>
> I write technical docs.  There's no way we would expect our
> reviewers to fiddle with source input (XML) to the doc process
> or diffs/patches, even though they're all competent software
> people.  Reviewing doc is about reading text, and preferably
> doing so in context.
>
> Think about this: Surely you didn't _write_ your improved
> text in the form of a diff.  You wrote it as ordinary text,
> and you probably did so reading the surrounding context as
> ordinary text.  And even if you didn't, mere mortals would.

Of course I didn't write the diff by hand, but I did make changes
directly in the .texi file and then the easiest and quickest way (for
me) to see the changes in context, and present them to others, is to
generate a diff.  To extract plain text out that is an added burden for
me (granted, probably in most cases only a small one).  But I shouldn't
have presumed to judge what is burdensome for others.

Steve Berman




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 26 Apr 2025 08:29:31 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 26 04:29:31 2025
Received: from localhost ([127.0.0.1]:57884 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8aug-0007GL-IQ
	for submit <at> debbugs.gnu.org; Sat, 26 Apr 2025 04:29:31 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:40224)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1u8auc-0007FT-T3
 for 78021 <at> debbugs.gnu.org; Sat, 26 Apr 2025 04:29:27 -0400
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 <eliz@HIDDEN>)
 id 1u8auW-0003xc-Ia; Sat, 26 Apr 2025 04:29:20 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From:
 Date; bh=AMEJ+oJ1us9T3fjUY50q4RK2Obhxxv2EjHM4/qy0uyM=; b=Ib6oc7KOb/6KdGtQ+CDZ
 omDRYZywweQ6wu7ayUaqWCG0pTNKUjLxdO7LvUPX4W6Cp3Hoe+cT1kNrs85HsyIWBUNCINf6IoXpj
 mdvMyEAT+5cvQUq/eCcEMzWo7k70cIlDWilTdJSOVxC6gcKq4RTF8LWOztYkLBn9TTPSMUKvLhAWU
 QCMCCh0d4mgFM7aUFqyH/H7cXaC/I/FyMlny5H6n1iO172rJjmIQBVpVHi4wkGZFVoP+XCFM7HYto
 qTcPVOTM2F7QxT7mxHWWfjcjORDgDt967Uc/XFGqQcru5OzoE9VL8IPxHtH9KK/WgROUFH9znmAYc
 XVFXu9QjyT2AOA==;
Date: Sat, 26 Apr 2025 11:29:15 +0300
Message-Id: <86wmb7uy04.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <87ldro73nd.fsf@HIDDEN> (message from Stephen Berman on Fri, 25
 Apr 2025 15:48:54 +0200)
Subject: Re: bug#78021: 30.1; Unclear sentence in (emacs)Matching
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 78021
Cc: 78021 <at> debbugs.gnu.org, drew.adams@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stephen Berman <stephen.berman@HIDDEN>
> Cc: eliz@HIDDEN,  drew.adams@HIDDEN
> Date: Fri, 25 Apr 2025 15:48:54 +0200
> 
> I've attached a patch for emacs-30 and have several remarks concerning
> it.  First, regarding my first point above, since the parent node
> already says "The major mode controls which delimiters are significant
> [...]", I now think there is no need to reiterate it here.

I think it is still a good idea to mention that.  The manual is not
always read in the logical order of the chapters and sections.  In
fact, in most cases people are supposed to use Info-index to land
directly on this text and read it without reading the parent section.

> Second, in the first paragraphs of the patch I've tried to describe the
> default behavior concisely and completely; however, the sentence about
> the numeric prefix argument, which evidently comes from the
> documentation in master, is not suitable for emacs-30: the use of the
> prefix argument was added (together with its documentation) as a result
> of bug#72437 only to master.  If my doc changes for emacs-30 are
> acceptable, they should be added to master as well, but not merged,
> because of the prefix argument doc.  But in addition, in testing the use
> of the prefix argument I've encountered what seems like buggy behavior,
> one instance of which I pointed out above; I'm still investigating this
> and plan to file a bug report about it.  A doc patch for master should
> await the outcome of that.

You could either (a) install different changes on each branch, with
"Do not merge" in the log message of emacs-30 commit; or (b) install
only the change for emacs-30, wait for it to be merged, then install
followup changes on master.

> Third, concerning the user options, I think it's better not to use the
> phrase "when non-‘nil’", which is in all cases the default value: for
> electric-pair-preserve-balance, the behavior with that value was already
> described, so it's better (and more parsimonious) to focus on the
> behavior with the non-default value here; and for the other three
> options a user-defined function is also allowed as value, which of
> course is non-nil, but I don't think documenting this value is
> appropriate for the Emacs manual, so I think it's better just to say "by
> default".

The usual style in these cases is to describe the default behavior and
then tell what will happen if the value is customized to nil.  If the
default behavior was already described, you can describe only the
non-default one.

> +  Electric Pair mode is a minor mode that provides a way to easily
> +insert matching delimiters: parentheses, braces, brackets, quotes, etc.
> +To toggle Electric Pair mode globally, type @kbd{M-x
> +electric-pair-mode}.  To toggle it only in the current buffer, type
> +@kbd{M-x electric-pair-local-mode}.
> +
> +  When this mode is enabled and you type an opening delimiter, then by
> +default the matching closing delimiter is normally automatically
> +inserted as well, leaving point between the two.  However, if there is
> +an unmatched closing delimiter later in the buffer, then by default
> +typing an opening delimiter inserts just that character, in order to
> +balance opening and closing delimiters.

The repetition of "by default", let alone with "normally" in the same
sentence, gets in the way, and IMO adds no useful information.  I
suggest to drop those redundant words.

> +  This makes it unnecessary to type a closing delimiter, and doing so
> +normally simply inserts that character.

This sounds like a contradiction to me.  Would the below be accurate:

  This makes it unnecessary to type a closing delimiter in most
  cases.  (If you type it nonetheless, Emacs simply inserts that
  character.)

>                                          However, if you type a closing
> +delimiter at a buffer position between matching delimiters of the same
> +type with only white space between the delimiters, then by default Emacs
> +simply moves point to after the closing delimiter and does not insert
> +another one.

The "only white space" part is inaccurate, and only happens when
electric-pair-skip-whitespace is non-nil.  I think this subtle aspect
is best described where electric-pair-skip-whitespace is documented.
Here, I would only describe the behavior when inserting a closing
delimiter where there is one already.

> +@code{electric-pair-preserve-balance}, when set to @code{nil}, makes
> +typing an opening delimiter insert only that character, thus overriding
> +the default pairing logic of balancing the number of opening and closing
> +delimiters.

This sounds like disabling the main effect of the mode.  Is that
really correct?  If not, then the "default pairing logic of balancing
the number of opening and closing delimiters" should be described
first, to explain what does this option disable, exactly.

>  @vindex electric-pair-delete-adjacent-pairs
> -@code{electric-pair-delete-adjacent-pairs}, when non-@code{nil}, makes
> -backspacing between two adjacent delimiters also automatically delete
> -the closing delimiter.
> +@code{electric-pair-delete-adjacent-pairs}, by default, makes
> +backspacing between two adjacent delimiters delete not only the opening
> +delimiter but also the closing delimiter.

First, "backspacing" is an unfortunate wording, because someone might
interpret it as typing C-b.  I believe the intent is to deleting by
DEL instead.  Second, in my testing typing DEL on the opening
delimiter removes the closing delimiter only if there's _nothing_
between them.  If that is why you mean by "between two adjacent
delimiters", it should be clarified, because I didn't interpret it
that way.  And third, since this is the default behavior, documenting
this option should tell what happens in the non-default case.

>  @vindex electric-pair-open-newline-between-pairs
> -@code{electric-pair-open-newline-between-pairs}, when non-@code{nil},
> -makes inserting a newline between two adjacent pairs also
> -automatically open an extra newline after point.
> +@code{electric-pair-open-newline-between-pairs}, by default, makes
> +inserting a newline between two adjacent pairs also automatically open
> +an extra newline after point.

Some modes customize the default value of this option (for example, it
is nil in *scratch*), so "by default" is not accurate in this case.
Also, the same issue about "between two adjacent delimiters" happens
here as well: the additional newline is inserted only if there's
_nothing_ between the delimiters, not even white space.  And finally,
"open an extra newline" is confusing; I would instead say "inserts one
extra newline after point, moving the closing delimiter to a new line".

>  @vindex electric-pair-skip-whitespace
> -@code{electric-pair-skip-whitespace}, when non-@code{nil}, causes the minor
> -mode to skip whitespace forward before deciding whether to skip over
> -the closing delimiter.
> +@code{electric-pair-skip-whitespace}, by default, makes typing a closing
> +delimiter between matching delimiters of the same type behave as
> +described above.

The description of the default behavior is redundant and is best
omitted.

>                   You can set this option to additionally delete any
> +white space skipped over.

This "skipping over" part is "out of the blue": it is completely
unclear what it alludes to.  This should be explained before
describing the effect of the variable.

>                              You can also set it not to skip over the
> +following closing delimiter but simply insert a closing delimiter at
> +point (thus making the following delimiter unbalanced).

And here, it is unclear what does skipping whitespace have to do with
insertion of the closing delimiter.

Btw, I think the doc strings of these options need clarifications.
They make very little sense to me when I read them.

Thanks.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 20:23:51 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 16:23:50 2025
Received: from localhost ([127.0.0.1]:53676 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8PaP-0005vs-NV
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 16:23:50 -0400
Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:57076)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew.adams@HIDDEN>)
 id 1u8PaM-0005vb-Ex
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 16:23:47 -0400
Received: from pps.filterd (m0246631.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53PKH5Au008634;
 Fri, 25 Apr 2025 20:23:45 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc
 :content-transfer-encoding:content-type:date:from:in-reply-to
 :message-id:mime-version:references:subject:to; s=
 corp-2023-11-20; bh=B3yrvH7mPFH/VXr+OrHydul754V0VIwVVH1j/kidHM0=; b=
 JLke4+smTvN+nAztONqr5mUakA1VwMZlQfkckPRz/ryrw5iuQs3LzDfQF0vC9/W6
 toKrLMXzGRJ12RP9DHMZ/85E6j91JDNNho4VMerjciLmrjpj8Rtp+xQvL11spMjl
 pPbJ8jg6rPn1TKS7PII0kFoamdMdFzGRCePiIzZGkQgf32UYT6mWHDjeVRL4meRh
 QTWgG226TeiqaDti/g3qHXPohsZ0clgFd3R4fSJZNOjTjpn9Ew8ySjX8Rx+Jgew5
 KKyZtILeoAqkpTfgBV7dCYYFaypDjba9xMrfkknxYepw53mZYrdkVhSocL9pWwwe
 mc/aWIAAnAnUD0zIY5PZ/g==
Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com
 (iadpaimrmta02.appoci.oracle.com [147.154.18.20])
 by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 468h9rg173-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 20:23:44 +0000 (GMT)
Received: from pps.filterd
 (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1])
 by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2)
 with ESMTP id 53PJT9Gs031731; Fri, 25 Apr 2025 20:23:42 GMT
Received: from ch4pr04cu002.outbound.protection.outlook.com
 (mail-northcentralusazlp17013063.outbound.protection.outlook.com
 [40.93.20.63])
 by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id
 467gft72jk-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 20:23:42 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=hO3Z0eJ+KJ84qUAu6OVd47cnjPj2VqnNBqhHCRiWlKjYQly0OSNBOeUy4h6lzL5CSDIT8us1S7C+ZwAjs0h1YePXa5ov37pNWg4pUlGVtdMgD0/QkBTUJbov+x5/adrYIJUvP+E+UuME60v9HJXvyh8UwEpoCZD/8ocQbyjuxjglxrfWCVNvaRMZdExa+iaqIQtq3FmsGijmWlvRi1Wh+Xh85cAatitPy1IHFVJU3xKt+bwbyK3fLp83S7MBEWlmlSPLc2GoSCyO8bC9zsjtVNxyYVOf3uALCtpjB47lnOeriJj5eUU5JI0cezHYVtSvsNvlcKcTxc7jEt74JB/QMQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=B3yrvH7mPFH/VXr+OrHydul754V0VIwVVH1j/kidHM0=;
 b=r+67CkSKs8palz+Svr29bUk5f8weCNGl2EZKtKhXwUBjKknuzZpAEftJZwqAKEP+Td5NtsWnpWbLNSYXhoYc/iT8rab8iCOXNeRWxSeR0KEv+m48IuoOaHn5+gpKS3YAgJnXl/mQEUxPR5yHWDLBkzQ9PCU092TtVLu2/9L2vi9KuSzhhSsL/4Ry+wNr9Csp6aT7OSiAvT9Zk+OrguwEUZoGdJVEvbNeELkCAkgDdPVsImN/6ZSqTSLAdTyE62JtMK7s7aJrJX9w8963ZpT9MONEJ7Uevg3QAR9ZB4kjSRYKl8lf0CIj2VVCFeAVWEKDfxtyQe+l6d4+5AgA1uIiQQ==
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=B3yrvH7mPFH/VXr+OrHydul754V0VIwVVH1j/kidHM0=;
 b=KqBLtY8aGj5AC/EBV7zPVCWVEgKWx95CLZYo0NeEF0RCOt099EV2M3tzM2gXUVJ2vguPXrScZmHAh51U8GVxe5c2n2Pc+hdW2+W22JXNs4vC3liWJVC781HkBeuCEI46cw0gONfbcjsktFVruMgiOl4wuvaG+4JtGr3rSIkvLuE=
Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24)
 by CH2PR10MB4390.namprd10.prod.outlook.com (2603:10b6:610:af::12) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8678.28; Fri, 25 Apr
 2025 20:23:35 +0000
Received: from DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.031; Fri, 25 Apr 2025
 20:23:34 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
Subject: RE: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Topic: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Index: AQHbthCge1/Sv8CmrkmnysGoXAOTLrO0xPoA
Date: Fri, 25 Apr 2025 20:23:34 +0000
Message-ID: <DS7PR10MB5232D0A02C54EB8DA10DF314F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <87h62c6w63.fsf@HIDDEN>
 <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
 <87cyd06qhe.fsf@HIDDEN>
In-Reply-To: <87cyd06qhe.fsf@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|CH2PR10MB4390:EE_
x-ms-office365-filtering-correlation-id: 277c782c-a9c4-446a-e64b-08dd84370dff
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0; ARA:13230040|1800799024|376014|366016|38070700018;
x-microsoft-antispam-message-info: =?us-ascii?Q?X/dcwYi7VZlaZu+luPpeif8W4cHQQsqxd4YOYOEQjjpHubJ4HZLm3Kmawm9u?=
 =?us-ascii?Q?2RVkJ+vZk6BdGXSh2+Cpzv86uqvju4lRyLu5928pnaOsVaHgfVN+DLSHlfHY?=
 =?us-ascii?Q?BgXjQCT6GcVBTEJLhB39mgu7tzEElw3hi9QU+ZvZkALP0hqoIxbILkQZGTZc?=
 =?us-ascii?Q?nMgZ/AlOydEShcqbxfEZwXfqmgw5sRFzKt2BNdnzPiZjwOUtjsjRBZG6qDXq?=
 =?us-ascii?Q?ouqcX0gJTRfxHKbGaG3lE2MZrvTwV5xPJiUkreKIdynD6svl+Qy4kC0bASJj?=
 =?us-ascii?Q?fFZRW/lF/te/bQ2jAm67agbaXVUe+VOehB3Ko9c87MzO5/lfn0wHp900W2Dw?=
 =?us-ascii?Q?ElBFdg/E1s2WhOn9A6ELryOCkuCSlQlmfbc3KTsAk4WTMiBSHL93EulmjcVQ?=
 =?us-ascii?Q?GfGpW7+rT/z1mPIhqr/wTVFgIioR4euo80iha6lcTDMTVhNklFN2d1OEgE7h?=
 =?us-ascii?Q?gugbdgOpHZ2ugJl26LyJG3YFf8McaMouPsy7Ibwl5YCXBzbNdbydo86ftCr2?=
 =?us-ascii?Q?jLDtyT41cjfSSGH58w1xYBFc/b8XP3YTsKXbdXrVLzihqHe062wxpBcyU5Vf?=
 =?us-ascii?Q?j2s567TDzYOiIFSpVJOYfFwPIbSu5IB4PHble/WhgY6g8iqZSsvsOo61YH/B?=
 =?us-ascii?Q?U0SMNlJ0KpoaLMXzV2fVXOqz5hZe43GyajkuUj3qfLPWYNeDHbEOcZ99p5mv?=
 =?us-ascii?Q?UmPvKVsdKEuNTfK+fugDvevyD/M6snQzxmKdxZKt9UB3bquiK0q7lDFbQWrS?=
 =?us-ascii?Q?yPWnS4vIHgGRJUvtcj3NDX9lK9TntOFmIh/8oymT49gk5A2zgRVhw8/ZTWp8?=
 =?us-ascii?Q?bTa9020XuTo6f/UJt6aIVeOnGRNWk2F1qutbZXIyitP6ZjuStakNdEwnnRrF?=
 =?us-ascii?Q?7Rf3dT11GqNltCNPhT4PC5ZQo+lbuyiRhx0vlBEiSt18mLUy1Mqypi+p1kZy?=
 =?us-ascii?Q?Sg0HxHq/IiIwTKrvBFaq8UbfY6QxW98A5DA9dgIVznWZ8rpxQvtGfzNRKjI5?=
 =?us-ascii?Q?qQeM8vGoLHHetBuSSFL5dEcSdBfhNL4uTM+c4nGlazPU2E7OkavWcVyrKL2K?=
 =?us-ascii?Q?lj2SjPRwl5EHJC5xE6tYOb6b+1Bk/8EII0fwZA7XVCnfr5Vfo3eutWg1y4g0?=
 =?us-ascii?Q?BAIArNbng2Cnd3eLdiZzSg/f+RKfGATyjH0TBaSBo1cyFmn6AlJ+42ucYQWc?=
 =?us-ascii?Q?Y0YQ4mIQLVxXRGOCt6J5zX/cPLRwJs4NJZ02+KDxwVsOftRDdcl8+uT0vDtv?=
 =?us-ascii?Q?hi+hKv2j3ZZUc98sY72QlkNTvedq0e9rmAZBIPbKnIUydJJ92tUJROBKvK8P?=
 =?us-ascii?Q?5WLPHzIP5VnoJqJxfXjNFWoDP3liWLDj24XNBudh1jPBCGzlu1liEsgUQ6UM?=
 =?us-ascii?Q?SGZqJ2EGGNJflMoNi+pKlMvJM1JzknyoBWbWZ51k0/t1LSd5hXn1YI1VnFyW?=
 =?us-ascii?Q?LZsp8f8sMxTxkAGek1XIO8kvRWtBRP1mRVe8w4psN3bvlx6qawziTw=3D=3D?=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(13230040)(1800799024)(376014)(366016)(38070700018); DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?VXxF0NFo6BPzc9PE1N46CsGLTjImGvtU8TZs+QmiBr3GqBLHAyWgKf+SLJmw?=
 =?us-ascii?Q?aOaEvWn/HaWQWUzoUJN1rtx7fJslo0GF+6wgk43s9sV7pGWRJ8Y+jvox9ex4?=
 =?us-ascii?Q?fqztQpUUmsuBi9ro4Ld/blOWqXYiY0cB+HOnSDHQv8GU0TI5hOBcqa7aKaXK?=
 =?us-ascii?Q?7EEK75Z25jSHrxbARulKaky1R24mHH3MD6Hd7bnK3mR6PgtEmT1cA9f9nITL?=
 =?us-ascii?Q?TUytmX15CJllsMaDYqq7aj9p8SHp3pdxa+S9CrO6rtPEX3GwtMRmfk4VNdpC?=
 =?us-ascii?Q?TPRy4r4FoALYs1qCjscd4OqaX7v9UGphCp/lbCp3Z/zV6uUZZrMhBRh3KrTN?=
 =?us-ascii?Q?I4Vb9h2xx3dMtTkFEceEn0Ln2wxDtOez3IT4MQw2Z4AmEGQ15YNhhsyrou0S?=
 =?us-ascii?Q?+URIaU6nO3sJgGN+YVH6O2/8xoEyecP4yIiotXSfvVzbTAacAo7+CRiUSWp3?=
 =?us-ascii?Q?+5vd8m5DVbZpfm2fksX1QinnX+TICm9fOTkYBqdxXAnEAHHA+PdJw+6ziDp/?=
 =?us-ascii?Q?wUQobJowCBfNTWFV5QqNm2jEmYrwYtZ0UJHop3CigIXqXwf5BZFyu79AzOTK?=
 =?us-ascii?Q?rTzi1afEpd/ELvRasLbYZbdlZtRZwMotFdpkq5wITEFpbPJvV+RF1dTFabo7?=
 =?us-ascii?Q?lBe1YtXH30WZ5yw5bgN2nQTuHswA/5kVPXGdgToq3DtDhHX7OUCwRVOkf4JX?=
 =?us-ascii?Q?+dRlVrGNNI2zcYAnrlL21BbgkW48BnMZre1UqioSnXUh0N5ap4FZXLnUiYOn?=
 =?us-ascii?Q?VYrfUx7kBp4WSL4cMaywL1m4SYSPSlbPyeVLEeOHG9iceLHbctPThPKpQfUh?=
 =?us-ascii?Q?LxJgylkVopQUUqZ19juS3Os3VIs9k9BG1fOUhA9sp6hrrewkNr27N5IYbym0?=
 =?us-ascii?Q?wIL5Vth+92b4Y5FVlHzTV9RozMBFFYTRW5qBLxZTHZOu73k/plyvckUoT076?=
 =?us-ascii?Q?J+4UW54Xd1PSDSPvd3bKQ6jCfj0XFkrFoP1Q/WX3LUvWzPxLJD5WDr1NLaov?=
 =?us-ascii?Q?V8PJo6opFPy2PyPtS+4L6mP5OZH/OaPr3xTr/HTFJeVsvuAqvFj6QZ7bwX+m?=
 =?us-ascii?Q?F/ixAEEyx+IqrN4xIQROOgrj3t40q013uWVGPuHRWR6BkNTrNJMgwchTpqiY?=
 =?us-ascii?Q?NH1bzXs1xVFaLppGHhfxG0zIB5WwhnzQj7JeIyrGjmqOCZI9Ai0J8kDXCqXl?=
 =?us-ascii?Q?A0/5zR/bWOVXJ/3oWwMb9PsRysRLFXwxTj472xt1oRIYgIyct3UkG9ByvVNz?=
 =?us-ascii?Q?K31ybL5LDul+4fk/XWcl1kmmQxau/IoPs0xFuXSOXFPEduuoeC4cWf3I4sAW?=
 =?us-ascii?Q?3nWGZ7ipdfBcqA8emO4rZm7ccWAWIU3na3C/3/gNG+/dyO1vFnaPqFpx4sbs?=
 =?us-ascii?Q?lToVmDavgsz4k8ry9FyhHCSBb8RRfTqMegvdFd38uSIefFuK0bWDrTko4fbR?=
 =?us-ascii?Q?qiwIZrJrzSsgjtVcweQXfgdgoR3anoJCyjKdHDva6yowTBcHn/IV3V3PH4iB?=
 =?us-ascii?Q?R+i0QO0s85uy+/dm0Moy4QQ/P3eCxA8A0Q5dG/VPBdY7dqfl4SO84AOnIN1K?=
 =?us-ascii?Q?gDRNBAPDYc5wN71BbNUfQj3AbBPE+JMkBfZtH3JO?=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: DxG2DwYTiHX9mv31DasPkgd3gNWJ82XZoMy1wrbTndCue/nn96NDT2H6ewV/hGcAhMw2xQL58UcOIc7yNJY6f5KknwCKWhwhq+n6tmTlVl8eWejKrqaWkZx092+U2ex25aSob02owJE2A4HGXGv5QuWo6c/CFL4VwXtHXkP/MOcUxw53r94PBP9oZ6X4Od7wy12W0UFWge1Ik19SncfZH+Pp6X/tPLS7yAD/GLR0IMS/cSrIt38mGPavyBqL1WeGTHXRCFDYntAcc/Ge1Hls2NWEVISZzAnxkHjTqgCsUqJxy06txYQL+F8sZP12OcpYi9OgcQW/Oz0oUVoYPsMgFLoRyB+LTHBPS9jR4aQJG/LWVxgpNByO1eYjiPREM+gqa9SaQDCD4BMEVYfIg1j6nNOTSIiYlflOe5iagWvjjZxu1pTEAhFP+vXSfUY4ElHUaNMt0kllINIHgH0tydT5/xrhsfA61kQiE3J7pWPjpS9LpoTASaOzy06vX3m7V8zsVw23TuwULOeAh4BClYJKavaQSxIuPfdvQT2tT5jEQWxvD/y9kEUt6SZdIwPKtA28QTMAtoIlL/w85Evm7u0+3CKDRNHwSzaKFAQurvRMuZ4=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 277c782c-a9c4-446a-e64b-08dd84370dff
X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Apr 2025 20:23:34.8998 (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: zupSXC7xT+eMbXpgKpJjU1/kuTnCDEXiEPc1ZTGTQOpqCogKKKotqf/bbHmF3b8nSiEOSgxugWWm6eAa3wVtGg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR10MB4390
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40
 definitions=2025-04-25_06,2025-04-24_02,2025-02-21_01
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0
 phishscore=0
 malwarescore=0 spamscore=0 mlxlogscore=999 mlxscore=0 bulkscore=0
 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2504070000 definitions=main-2504250146
X-Proofpoint-GUID: QQHuf-c_sLy3r8madHWg4EodLyzSPRRj
X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDI1MDE0NiBTYWx0ZWRfX0jv9M5bGeQDU
 zty/OiN9IHVFav2Yv72tsAePY+T6rEzVv8q4+V5IHonvYbUx9m0NObpTw4QEt50WQiCtBaZ/c6T
 1iW5IjaHRcsQddSpy3ZW+U/LfiHDrjRdxzCzo4/PW1tfjdcCxZHTcR2YmWvJWbscW0ITDNTrdB7
 nnW7XjrEdPU85iFduzDxEGICad/10I2Gq7ZMVKuV9GbDKeoChKXyLrdkfQIui/rS32OuaQ64YJ+
 vHHTWeY3P+1yp29Pvu4h23eBWnroMvHt6k2hmTMVBh65SZaKPG/oPJtXstnj73Up94t+Bo+aSnr
 sY/W+NiSZ8ZULbw5xbCbVBl3/l/cpjLSKEhrm5OC9SERe9XIjGH07ggBdLWQhIwWtyM1eU4PKjE
 Ushv46mh
X-Proofpoint-ORIG-GUID: QQHuf-c_sLy3r8madHWg4EodLyzSPRRj
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

> > Not clear enough:
> > "with only white space between the delimiters".
> > Only whitespace between which delimiters?  There are
> > presumably at least 3 delimiters in this scenario, one
> > opening and two closing.
>=20
> The scenario is like this: "some text (     ) more text", and the user
> types ")" somewhere between the pair of parens.  If you can think of a
> clearer way of describing this just as briefly, I would be grateful (Eli
> requested that the node should not become much longer).
>=20
> > Not clear enough:
> > "to after the closing delimiter".
> > Which closing delimiter?
>=20
> The one in the text scenario given above, which is the only actual
> closing delimiter character in the text -- the "other closing delimiter"
> is still just the key being typed, but the character is not inserted (as
> the description says).  Here, too, I would welcome a clearer but just as
> brief description.
>=20
> >                           Immediately after it?
> > If not, where after it?
>=20
> Yes, immediately or directly after it.  Perhaps adding one of those
> words would be acceptable.

Quite complicated.  Maybe should include an illustration.

  However, if you try to insert a closing delimiter between
  a matching pair of the same type, which are not separated
  or are separated only by whitespace, then there's no
  insertion and point is moved immediately after the closing
  delimiter.  For example, if you try to insert `)' at | then
  for `(|)' the result is `()|', and for `(    |  )' the
  result is `(      )|'.

Or maybe:

  However, if only whitespace (or nothing) is delimited, and
  you try to insert a closing delimiter of the same type
  between the delimiters, it's not inserted.  Instead, point
  is put immediately after the closing delimiter.  For example...=20

But a reasonable question is why?  Why is that the chosen
behavior?  And why is delimited whitespace special here?
Explaining _why_ would itself take readers a long way toward
understanding _what_ the behavior is.  IOW, start by saying
what the problem is that this behavior tries to solve.

> > And please change the name of the node (the name
> > used by `g' etc.) from just "Matching" to something
> > else, preferably something that indicates it's
> > about matching delimiters.  That too is part of
> > this bug/enhancement request.
>=20
> Making such a change is the maintainers' prerogative; the (cogent)
> argument against such a change is that, being a long-standing node name,
> changing it could well break references in external info files or other
> formats derived from them, like web pages.

If that's a concern then the old node name could presumably
still be respected for a while, as an (unadvertised) alias.

But yes, it would have been better to think more about the
node name at the outset.  The key terms in this are "paired"
and "delimiters".

There can be different ways that a pair of delimiters match
each other.  What's important is that there's some way that
they're defined as a matching _pair_.

And an ordered pair, at that.  `(' matches `)' that follows
it, but it doesn't match `)' that precedes it, etc.  (Dunno
what the case is for bidirectional text.)

Matching isn't even a great term to introduce for this, IMO.
In one sense `)' matches `)'; in another sense `)' matches `('.

> > Thanks for working on this.  And thank you for
> > providing the proposed text (for the part concerning
> > this bug).  When reviewing doc changes we shouldn't
> > have to decipher a diff or apply it.
>=20
> Since dealing with diffs is standard fare here, and they are generally
> required by those who decide whether to accept the changes, and those
> who install the changes to the source repository, I don't think it's
> unduly burdensome on other interested participants to expect them to be
> able to deal with them too.

I do think so.  Ordinary users of all stripes are encouraged
to file bug reports and enhancement requests.  They shouldn't
need to access texi sources or be familiar with diffs or
patches.  Especially for doc changes.  Just tossing them a
patch discourages such participation.

I write technical docs.  There's no way we would expect our
reviewers to fiddle with source input (XML) to the doc process
or diffs/patches, even though they're all competent software
people.  Reviewing doc is about reading text, and preferably
doing so in context.

Think about this: Surely you didn't _write_ your improved
text in the form of a diff.  You wrote it as ordinary text,
and you probably did so reading the surrounding context as
ordinary text.  And even if you didn't, mere mortals would.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 19:16:58 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 15:16:58 2025
Received: from localhost ([127.0.0.1]:53205 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8OXh-0000kk-T1
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 15:16:58 -0400
Received: from mout.gmx.net ([212.227.17.22]:57889)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u8OXe-0000kP-9y
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 15:16:55 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745608607; x=1746213407; i=stephen.berman@HIDDEN;
 bh=YZk2iyvfUSNEsOl8hZwTc55vmmbV/C+mOeObOfOmD/M=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=W82cFQDPOwwqLsxYh26BvaZDidYtfG05FQVa05tPHG02aWPGVx9bFsYmP2Hskhe8
 0amOa29IGakiCVvwV05cNiIK6C38twXX6KGRJggilGbtfJs/OAgXNH1aJq/Q8fSmM
 SdTfWe1S0IGZCh9ntbg7FE1bEOZvEeFOQaExLpocFYBDgAvnsOrOhaBDbzwHYm2GT
 goDc7ikPqCUHYASBMkgt8U7wbYCuTdwave440VwqpgyNtmb1BtCC7pYT14AwI5oau
 OP12bC2g/N2qOOLYZ9YzCToxNwU/UOovss7w/dxL/KQln/yocczr9M7mQxgeq1dQm
 0FaHNqgndkcp4WBJTg==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.238]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MHoNC-1uM9eb1sco-00FZC6; Fri, 25
 Apr 2025 21:16:47 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
In-Reply-To: <86r01gw0sl.fsf@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <86r01gw0sl.fsf@HIDDEN>
Date: Fri, 25 Apr 2025 21:16:46 +0200
Message-ID: <878qno6ogx.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:ryH2HYZU32ZMkapkYeKdRxkokgEhZqP2xFngBDurWNNJcfYiYB5
 5E7EyFoxltH4h73vYZx6tGwudemOcNoCAIjBT5Oiv4N4k/xIYiakl2/d55CUxAd1isJLZ+2
 WjAX2GKXLotl7Kke7K3PaTPkIUBhCv1B6W6PRrbWaPTpYuJN3x1prJ3KeoEjyWiVSm9ru6I
 xkWm7m5WqeSuc6jTdWH9w==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:Ldx/DUs9bgM=;tOCdrIqjCuqb7SeC3IOl3hwOzTg
 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
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: 78021 <at> debbugs.gnu.org, Drew Adams <drew.adams@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

On Fri, 25 Apr 2025 21:31:22 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Drew Adams <drew.adams@HIDDEN>
>> CC: "eliz@HIDDEN" <eliz@HIDDEN>
>> Date: Fri, 25 Apr 2025 15:51:31 +0000
>>=20
>> I don't have Eli's fix, to compare, and I can't
>> follow your diff wrt the text I see in Emacs 30,
>> so I can't tell what, in your suggested text, you
>> think actually responds to _this_ bug, which I
>> filed.
>>=20
>> This bug is only about this existing text, which
>> I can't fathom (and "places" should be "place"):
>>=20
>>   "Conversely, when you insert a closing delimiter
>>    over an existing one, no insertion takes places,
>>    and that position is simply skipped over."
>>=20
>> (And the node-name abbreviation shouldn't just be
>> "Matching".  There are lots of kinds of matching
>> in Emacs; please don't hijack that term for this.)
>>=20
>> If you fix this bug, then fine.  But please make
>> your other changes independently of this bug fix.
>> Or at least make very clear what part of your fix
>> actually corresponds to fixing this bug.  Thx.
>
> The original bug was already fixed.  Stephen reopened it, but the
> changes he suggests to install have nothing to do with the original
> report.

I respectfully disagree, and in my first reply to Drew tried to explain
why I felt it was legitimate to add to this bug.  But if you want a new
bug report for my proposed changes, then I'll make one and close this
one again.

Steve Berman




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 18:34:11 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 14:34:11 2025
Received: from localhost ([127.0.0.1]:52835 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8NsH-0005l9-Jp
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 14:34:11 -0400
Received: from mout.gmx.net ([212.227.17.20]:56241)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u8NsA-0005it-JE
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 14:34:05 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745605998; x=1746210798; i=stephen.berman@HIDDEN;
 bh=K2t0K901S0/XEGuucqzjRAmY8tJiN/xCbSlPznPLgSY=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=peljH65QkOcLKIRstzMPfyrx18kmcxvIUJgWl8jEnd9kE+2hSg24zRQRnyI+bCYl
 R5q/J+zRL68wjixtw0vSQqT8tnUrE6OLMXCoMbD47mlj3hIEp+rWzQolVO9ZAF0Hq
 CoTK8D6PQnGHuPnUbBbpYCkCu/6AdZynauv/DqLE80BnWL1sOf0thJKfqxWLdyo2u
 b/yQ08CMeCoJF08296UejpDNG4M/bRF1NtjEU6qO7ov1lm8NMnU+qh5ILmlGzzpux
 nU3gjbTbR+EUipirsb/EQHH/jicVbF3w+/F5d8Y0ds4pLVw2f9TQBdvgL9FDLWv7U
 hI73s2+Qnm71cOxO9w==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.238]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MeU0q-1uiXYg2zhs-00bz2S; Fri, 25
 Apr 2025 20:33:18 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
Subject: Re: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
In-Reply-To: <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <87h62c6w63.fsf@HIDDEN>
 <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
Date: Fri, 25 Apr 2025 20:33:17 +0200
Message-ID: <87cyd06qhe.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:CSDx8aIKIrHDhgIV1Vsn9Duwbnyq7FCmLrRZhQ3ZwJ5x6B9kb12
 vyCBFL7XPLF9NFWZCUh1jbuPlPk6nh2mCcKh9LmlT2/8+nYNrYJHJa5aGGo3bMx+jsYbQUH
 pZT6BOPVZgzAqRRp7zVVhMob4L2f5pnJl3bxdBwRyEZJ7e7LQle7ead2e0d4DYLICqY669z
 BNoZHM3RIvKk8tdXnBR1g==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:W7N3XaZRgt0=;S/7qz/6QzQVLX6GHzcSozWfNQWr
 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
 4aR7xZBF/rKE9WXXM+ZN3k=
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

On Fri, 25 Apr 2025 17:05:19 +0000 Drew Adams <drew.adams@HIDDEN> wrot=
e:

>> > This bug is only about this existing text, which
>> > I can't fathom (and "places" should be "place"):
>> >
>> >   "Conversely, when you insert a closing delimiter
>> >    over an existing one, no insertion takes places,
>> >    and that position is simply skipped over."
>> >
>> > (And the node-name abbreviation shouldn't just be
>> > "Matching".  There are lots of kinds of matching
>> > in Emacs; please don't hijack that term for this.)
>> >
>> > If you fix this bug, then fine.  But please make
>> > your other changes independently of this bug fix.
>> > Or at least make very clear what part of your fix
>> > actually corresponds to fixing this bug.  Thx.
>>=20
>> Here is Eli's clarification of the bit you found wanting:
>>=20
>>    "However, if you insert a closing delimiter where one already exists
>>    (probably a mistake, since typing the opening delimiter inserted the
>>    closing one for you), Emacs simply moves point to after the closing
>>    delimiter, skipping the insertion."
>>=20
>> And here is my reformulation, which includes a more complete descriptio=
n
>> of the behavior, which I think is needed to understand the
>> functionality:
>>=20
>>    "However, if you type a closing delimiter at a buffer position
>>    between matching delimiters of the same type with only white space
>>    between the delimiters, then by default Emacs simply moves point to
>>    after the closing delimiter and does not insert another one."
>
> "Matching" delimiters implies matching delimiters of
> the same type, no?

Yes, but the point is that matching delimiters must also be of the same
type as the closing delimiter that is typed in the region that the
matching delimiters surround; e.g., if you type ")", the matching
delimiters must "(" and ")", not "[" and "]".

> Not clear enough:
>
> "with only white space between the delimiters".
> Only whitespace between which delimiters?  There are=20
> presumably at least 3 delimiters in this scenario, one
> opening and two closing.

The scenario is like this: "some text (     ) more text", and the user
types ")" somewhere between the pair of parens.  If you can think of a
clearer way of describing this just as briefly, I would be grateful (Eli
requested that the node should not become much longer).

> Not clear enough:
>
> "to after the closing delimiter".
> Which closing delimiter?

The one in the text scenario given above, which is the only actual
closing delimiter character in the text -- the "other closing delimiter"
is still just the key being typed, but the character is not inserted (as
the description says).  Here, too, I would welcome a clearer but just as
brief description.

>                           Immediately after it?
> If not, where after it?

Yes, immediately or directly after it.  Perhaps adding one of those
words would be acceptable.

>> But I also made numerous other changes in this documentation, for
>> reasons I listed in my emacs-devel post, which is included in the post
>> you replied to and should be readable at the URL I provided above.
>> Admittedly, my other changes widen the scope of your bug report, but I
>> took that to be legitimate, since it's still about clarifying the
>> documentation of Electric Pair mode.  If you disagree, then I apologize
>> for hijacking your bug report (though I don't see it that way), but at
>> this point I would rather not open a new bug report and repeat
>> everything there; I hope you can accept that.
>
> I don't intend to review all of your proposed text.
> I'll review the text that fixes the bug I filed.
>
> And please change the name of the node (the name
> used by `g' etc.) from just "Matching" to something
> else, preferably something that indicates it's
> about matching delimiters.  That too is part of
> this bug/enhancement request.

Making such a change is the maintainers' prerogative; the (cogent)
argument against such a change is that, being a long-standing node name,
changing it could well break references in external info files or other
formats derived from them, like web pages.

> Thanks for working on this.  And thank you for
> providing the proposed text (for the part concerning
> this bug).  When reviewing doc changes we shouldn't
> have to decipher a diff or apply it.

Since dealing with diffs is standard fare here, and they are generally
required by those who decide whether to accept the changes, and those
who install the changes to the source repository, I don't think it's
unduly burdensome on other interested participants to expect them to be
able to deal with them too.

Steve Berman




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 18:31:46 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 14:31:46 2025
Received: from localhost ([127.0.0.1]:52826 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8Npy-0005dV-3Z
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 14:31:46 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:54074)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1u8Npv-0005dG-CU
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 14:31:43 -0400
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 <eliz@HIDDEN>)
 id 1u8Npp-00058L-6W; Fri, 25 Apr 2025 14:31:37 -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=cKT4sr5cHwqguCY2Hdvp/qFW2kgSGF1u7XeoOcCyjnw=; b=WqNntFB2YVkh
 2BSe7Crp8xHgpVIa3B0acrb32mYh/pvemdAXmoVAb1QV5N6FoMmidRvQ4ZKf/++qTe3UxyGVkyKS9
 ocaObDeO0r3d10uh9QJECng8HjOZyaIJpxULYnuep42O1Xn85M+8jRt4j2nfXOw+kJbQws/umMh/V
 AdECImTG2L7RqdHlSDgg8lvYXTurM8/nwYZGc1FgDSbJNJec1wV8Z28Mga2+tktQ0eBeoPxMMgcSr
 o9lvs8TEXvRP6w1HO9kMAubW7aERUbfaBl8wUTypzekiENNEDg5T/vSavukvcGULrj2fFvhsuQjj0
 AAxJ5wYqmb8CHruaKfjoxw==;
Date: Fri, 25 Apr 2025 21:31:22 +0300
Message-Id: <86r01gw0sl.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
In-Reply-To: <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 (message from Drew Adams on Fri, 25 Apr 2025 15:51:31 +0000)
Subject: Re: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN> 
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 78021
Cc: 78021 <at> debbugs.gnu.org, stephen.berman@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Drew Adams <drew.adams@HIDDEN>
> CC: "eliz@HIDDEN" <eliz@HIDDEN>
> Date: Fri, 25 Apr 2025 15:51:31 +0000
> 
> I don't have Eli's fix, to compare, and I can't
> follow your diff wrt the text I see in Emacs 30,
> so I can't tell what, in your suggested text, you
> think actually responds to _this_ bug, which I
> filed.
> 
> This bug is only about this existing text, which
> I can't fathom (and "places" should be "place"):
> 
>   "Conversely, when you insert a closing delimiter
>    over an existing one, no insertion takes places,
>    and that position is simply skipped over."
> 
> (And the node-name abbreviation shouldn't just be
> "Matching".  There are lots of kinds of matching
> in Emacs; please don't hijack that term for this.)
> 
> If you fix this bug, then fine.  But please make
> your other changes independently of this bug fix.
> Or at least make very clear what part of your fix
> actually corresponds to fixing this bug.  Thx.

The original bug was already fixed.  Stephen reopened it, but the
changes he suggests to install have nothing to do with the original
report.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 17:07:23 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 13:07:23 2025
Received: from localhost ([127.0.0.1]:52231 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8MWI-0007bP-Od
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 13:07:23 -0400
Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:39166)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew.adams@HIDDEN>)
 id 1u8MWG-0007bD-N4
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 13:07:21 -0400
Received: from pps.filterd (m0246627.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53PGWKLN005104;
 Fri, 25 Apr 2025 17:07:19 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc
 :content-transfer-encoding:content-type:date:from:in-reply-to
 :message-id:mime-version:references:subject:to; s=
 corp-2023-11-20; bh=FoWHgkMp2fWUh9eZd9qtf9OyYvMbtaOIaFYBoMFEwcA=; b=
 FQCuRqGd5X8tqQ6ixi4/o928Za5Ucrkzn63uGFKcLmf21sxh6b3G8dQSM2u1FExT
 8qcJK+cJIoIozTS4VefzvIEuew9w8y4JY6+8f8ieEuDzdmVGmBOxnC7mNPIs5YHg
 6x8Y93DIRVGgwriESQ08fExxMHBVCvRoZbKkfqoKgz/5yuiPufT/uBOrlr3xDPkn
 tSMvTjukJ6W/DObf1lhsHDzE4Aa4zn3xD/Adam6+WTytBYcBUKksrRvrSCMxoQe+
 LedFiEXbTFJwkULIHf545u9ra89nDi9ODOOdCDyRDxXIB+yvc01LOqkzBqOenMqp
 Vn6aO83QM2Y6yGs09TxaSQ==
Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com
 (phxpaimrmta01.appoci.oracle.com [138.1.114.2])
 by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 468e0b06dd-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 17:07:11 +0000 (GMT)
Received: from pps.filterd
 (phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1])
 by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2)
 with ESMTP id 53PGhkCI013820; Fri, 25 Apr 2025 17:05:22 GMT
Received: from dm1pr04cu001.outbound.protection.outlook.com
 (mail-centralusazlp17010007.outbound.protection.outlook.com [40.93.13.7])
 by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id
 466jxrw479-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 17:05:22 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=Wz087H+p+K5EGii+r9Oa8Hw2n7kXRiPgJj3l/E8Xc9EVz08H61WwFwFLe/yrhSqFcVs82eNVAPhu5Y06oVW7cy/qr3hQ7QE4+bKP+l5nYvrb+izuVAlWh2UyubjqAVbsXNHLFPqhBiX7B3TfXjQO0vnJr05bnPcYWl6k6xUT8/tgIRQW9cAg+iZ3nwvMzf8zEg2BsJbiwSi/oMVyZMTvpV9+FEd2kP76JjC6xuOP06/5sOFEi66S6ZV4zfqFMpzPEw+N41PAX83vgZymcPo0yoVZjLkd31J3BSRuos/LD9o1ZNfJBdbafmMC9knb6arEj+mx8yo/1cf3nYfXfPzzkQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=FoWHgkMp2fWUh9eZd9qtf9OyYvMbtaOIaFYBoMFEwcA=;
 b=bF4nti6+bt/xHOM1EBpnqvh8Bt8GZ5ght+xkpdF+p6rXz0lLbqMt2q6uf4bGz2eAWFslGcbrTbE4INARvVkUIDZMfeVNC8O9pPDGyffQvHrtyVrw1AHkx8dIQpb4eacfQhHLFYpmUJYo69pwtfRLlQxUO5gZKI5YYmE4n1v4vk6shGNDWvF/8me8QUvRKhLa0j7ly8m9iDfi3iUNd7Mi8FP71ARfoThtN6g9TMbk5v/mlKJmHo8ipLEqUOP0PsaV6515cR7BWKzj7F1FQkoARUmHEqKXYrhWCSCkiVm8vp3YcHHndVg9Rk7sBQL/sDZ5XUOsNLtX1D1EebhFGBJbEQ==
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=FoWHgkMp2fWUh9eZd9qtf9OyYvMbtaOIaFYBoMFEwcA=;
 b=sZPgLG2hCE/f1/Zgl/le810YCu5BDwOO16OMMAbjzArSorKCQCX8Cn/f4NjvtP92i7gaMNguf7/H8VnJSet9y8yNG/fmlODcqS8vb3+ImwvgNZc3Qx6UfrXis4PwSyd6aQ04cYB/XtyDg8RpAJTTgtDtkMXGjOzuaysQZSYSoMs=
Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24)
 by IA1PR10MB7388.namprd10.prod.outlook.com (2603:10b6:208:42c::15) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8678.26; Fri, 25 Apr
 2025 17:05:19 +0000
Received: from DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.031; Fri, 25 Apr 2025
 17:05:19 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
Subject: RE: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Topic: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Index: AQHbtf9lAHmmIaBqs06A8Mi9G5IV2rO0ltIQ
Date: Fri, 25 Apr 2025 17:05:19 +0000
Message-ID: <DS7PR10MB523224E4498C796FBDD0C595F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
 <87h62c6w63.fsf@HIDDEN>
In-Reply-To: <87h62c6w63.fsf@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|IA1PR10MB7388:EE_
x-ms-office365-filtering-correlation-id: ecda9064-929e-4d1f-c454-08dd841b5bcf
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0; ARA:13230040|1800799024|376014|366016|38070700018;
x-microsoft-antispam-message-info: =?us-ascii?Q?VZ0DrFZhsO2S04uf+drzyCoftA5vrHeENdvfqPSQaLuQoOfzaXuk/8n+E9qO?=
 =?us-ascii?Q?tL8W231HRD7tMk/iColY6PiNX5xnwuvCQr7XSEoEH9cHjtsg7MvlP0WdbElW?=
 =?us-ascii?Q?QhPeifKJqORKuXI51mLb3bfNG57FCQQ+1swxotD/nbGO4cwm3rhofbQ3OYa7?=
 =?us-ascii?Q?w+n81cXklKIY/r9E64na4hkHS+PTAycNXXYGbg7+hNXaELsU1dQ9nAWqhN+e?=
 =?us-ascii?Q?gmSR47hPjRTE9NIkIrwZS+9ECJ/cgv2KK2uhhkOOKhlkC4WceiQDq8iIc3rV?=
 =?us-ascii?Q?ttrUmmBXuA4K0sFAHqoOFotzsJriMcYkZEkmyG1YkQzVe6TNxx8S86ef2iN9?=
 =?us-ascii?Q?vuC2WECOsLXoMQLKoSgM6iStCIQPyrxjt5WNTVdrSCR6bWxkVB7+ep21+RQr?=
 =?us-ascii?Q?Jg10G6R0W5QVeI4+ofUy3JeF79IrED3ytmtuzBFrpUzsSD842qNxicP4qvX6?=
 =?us-ascii?Q?axvFIteXP4sIwUpFhwNIW7jRd1zDMEIdh1iVz4y0vrtE5zOzfCH8LQEiWayM?=
 =?us-ascii?Q?WolLdrix9aJkJDZWgu55lgcSBMmPv72+QFar3izTy96fFdMLV41TUEc5KYAH?=
 =?us-ascii?Q?aFUKJeFBkaQUszQUZ2T7pQEo+ATB0+gcvoJuCDpoz29UoEOtlC9nabR8p2b+?=
 =?us-ascii?Q?NXGXAu1YwSsQvnDcBrDml0kVuT5EBS4UrHyU8hUr/6dhb0zm9sn9YO4/F9Yg?=
 =?us-ascii?Q?N5UtW3fvAku2R+bJ27G2cKiieU8tRZwpALFURbHNS1dSlXX0tguh5rsDwuwb?=
 =?us-ascii?Q?gPZw5AFqlRFYzM+m73sGC4gBhXQu5XD8nLpoJ6d/W5KfF33VnR2X0UHvX4rJ?=
 =?us-ascii?Q?xRphdqqRvrFxPgEwprYEnFT/vqKbxokI++uQ6iQbDNcCCGbpzHnx3m6glM/E?=
 =?us-ascii?Q?KZK5Z7q4ExLzGBbzVBWFfc/59JGW5UHF46NPBR8jFDFCIvfk8ujxQVzfJCqu?=
 =?us-ascii?Q?wHlhGCexa6jMaggDcRFNsOZjGBxRQl5ZBXE16i63vHotn90nGIg3LzX87S6t?=
 =?us-ascii?Q?FrTFBoJSo+c/mZAxzt30aJv90lZmoIpqjnMO6JRxRM3TaD+yzfc+d8uhxMdr?=
 =?us-ascii?Q?plxmkmxdjiNtY5NiaspWUAA1TrscN1aGvVd1PfjJ868jN/RaQ4R9Gj86a83n?=
 =?us-ascii?Q?3J1SOaOceDXrKn7CZq80lQjGGTZqkyb74MgAVKbhJj+cIyei9loC8TsvmDAt?=
 =?us-ascii?Q?lPXej764TN+UrGdM2unZBBkD4Sm/6Ii0BspKdvoa8FVilBcKw6huA9CckFXw?=
 =?us-ascii?Q?bDHssh2yX1Uez6VmOKJ6C0s1zk1aD/JydkP47a0xkWopZTsVmqBj9+fPlfAm?=
 =?us-ascii?Q?CAogaYBipzQjqem1rgwvslTOFZSkmjridBCfoxholm5DAyvQKDX0Fa5ZX+2y?=
 =?us-ascii?Q?668q6ktU6+o9+hUDJzGmwEQoEjth2LE5jvfLI48aad5DARjo+WiBxPJh6RAT?=
 =?us-ascii?Q?FFNjXHIZnH0WV8//xnNY9Agf2AtBu4+DgRnIWkv8Sp/CHEVeHKBhjQ=3D=3D?=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(13230040)(1800799024)(376014)(366016)(38070700018); DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?NSAZoX3AXGg+Ulpd+f6eKCtT4eNzxapcJo5iAUiXA0PdCSB5CEv46DEjRxyn?=
 =?us-ascii?Q?MxI6F+ZspaSa/AJ8Oy4G3H/4Jkg6+nmPDHH3oZJcQc7Ao5q9Xe5oJ2eKfi+f?=
 =?us-ascii?Q?yr11iQocVbDiW5gvgCCg77OLJOpUrg8sDjnebOPTOJav6/dr1PBx356lh0CT?=
 =?us-ascii?Q?SbeWbw9wAjD+Rm/jNwvBzpWIxP/nMvXSwZ2T8He4ff6nLXRPwP/zSdLbSjUL?=
 =?us-ascii?Q?u+8/sCaU9MrNZAS0gY8Ppe/dQoHqZzW05swrhq039K4vf+RUdktH3oOa5VsZ?=
 =?us-ascii?Q?Y3r4nX0XTskOKDEu3a/d3SkcA5OQDLRovnc/ptel3xsWwIKuxb/xBQT8yMXX?=
 =?us-ascii?Q?Yv3Xh2QdhLFjP2chZ4UewVF4WF4qKq6Yek00RIkRDCtmPuHstquNGhhliQC/?=
 =?us-ascii?Q?V/Ld0vqyoTg+xAJoJUrm4HkcHN3HJ3kAN/LtJkSlHChmvmZzwVuDb4ZKlnGt?=
 =?us-ascii?Q?ObAR5zMkFGi2212CnJxeATSj+viKaveAb+XfSSL7A/pSkrCgGUv2/YDuyhXI?=
 =?us-ascii?Q?SH7oKA94Fahfb3XO9rSr+XqEQESdXCZC2wnZC9tQlIjKKBdWdozILcUL7At3?=
 =?us-ascii?Q?N+rKxMZBLNZOuf0F1tcepUDfpWXI3BAoMtDCMeP/m2sYv1k7ss0DVnYoCE9+?=
 =?us-ascii?Q?JXb4VHDablpFQ6VMkshsp00g3C4hfVw8Z7RnSC2vsVeaXTgYm4d01LVjB4dD?=
 =?us-ascii?Q?bM1rFlNOVSeLoBJGKBp1TzTKgwqk0LlQZDgIX1JswcSzcV4gJrtIkcBQkWVY?=
 =?us-ascii?Q?OVSTzVwvUn79LGsZ1MS9KQi7LsEoDI1Kw54R6rZcOLnCHEExFoSpf0VtJ381?=
 =?us-ascii?Q?Z1HLxE6xSnj+Rupi5qb9HTXkLt1GR49of9QgWEmYs1vuTiRE/HwxwA1Rpz0+?=
 =?us-ascii?Q?n3qmzvwUSG9CxbQkQQ89RDg1RasPkgfBzNV3PksrvGBGC6uXlivC1vODk//o?=
 =?us-ascii?Q?w0W4I2Bb7bT6ZH/ZJL72wR6ah6VxADsTBkx8XgyL10cR5b9Ewkerwc6g/udB?=
 =?us-ascii?Q?yFbk8MF0WqFWhlDfvL+VWokYoTd0q0w2yfz3lc9SJ9ng0mAPxNr6mEkEaUEc?=
 =?us-ascii?Q?RhvB6jKOxKVsrrKOTha+utxU5II1NrhuqsiJZQwhOyzZ2lGsVngaEvq1f9GA?=
 =?us-ascii?Q?0mMTY1KTYMAq+OFPST11qOuLZdB0IAUizAS0Ro9reAn7E2PgUL85Pj1MArQ1?=
 =?us-ascii?Q?Q9DC57ltxCr2lFLgaOQCH4/iHrBtLYXJ5grcyWwqMfJRhacyRtbU8ePrLUQG?=
 =?us-ascii?Q?58U8To8KHXKdjDaFjixjYnXUUwpu3e38iVAHgJ86p65ddM/PA/VoMyAENcF/?=
 =?us-ascii?Q?DVKoG+6SRknEKE7I0VOa4SA1zXajq3FR3/Im0T4MvFJGtHIrfFHt7/0hIQQv?=
 =?us-ascii?Q?FRHrgCXARL/vOzq+t8QQ18bUfHyw3nafyTE1AL2hgM/uHgi8s/K3Xhf7EitR?=
 =?us-ascii?Q?sIddS0S5QIvuS95gwNP9VBZZZ6Xd0g2rC56YuSX7kzgbxvLiqmnYZcxlufab?=
 =?us-ascii?Q?vnKLsO1FrlmedNhKtNbHe2aO7mIcMuysx3GuYGXwFHBlqJ3NzqUBi18OEqT9?=
 =?us-ascii?Q?no2FYpE19nubY0qFBb7SujldZ9dMML0uRw3vGknd?=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: +jPOxvJr32kwg8v80g6kfPrpumb0XM50aTwJaKqqYVL5t4fQZLdBGRbrP2zAB7jsBY1D/vo9h/RaiJn71wWWMpTKFmYZNbaR3U/tGCwQ4jAXO4IalW7IeSCJwd0vEXCRVJ/3BSPA93deBkdsFNR/exgh1HD/H1SQq0kwaUzQmWjQ4kLOte2W9JN/V6hJtMlhtsXYclz5E5XxBBVaDrN6h6Eci1uKJSCsTXfUa1LDIrzzQJc30B17X2eRmmEUlefgx19/mcEnvZJ6vD8VG+b/t0+V/v6tL0VHpY7nLYRt5DOtYPKfVARWApeBAxe8pPLx3LNsVjattM++wc0RdfzwLHideiA3+VNLPTw235Qw0yMgveDnjfBmnIfhaZFrRbEQ88YsJszme865RnrAhzPC9EM6kj7w0gVuO4PvtM9vlf/SrGoS5hVO5jPdLZIZMZXWiVbjexFCaxY80FJFgl6Qrh+uVTAW/9kj9W55V3bRDNxnbhRXTPdvRbnnfWz5N8orcdcjY3GktzAAA8+ctFCPheTo5ZpPhPs8sPhb3bNjbD/SHZWVtI2LgWpE1SLHfwq8ikGOykxcdmFjCBH0hu4ka2csUeNzDW++Mj3QxGIhJ9Y=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: ecda9064-929e-4d1f-c454-08dd841b5bcf
X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Apr 2025 17:05:19.5509 (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: JXByku5nns2kyUKoTG60fyeJSIQSox4aYiyMx2x+hDGK4nP3el+Qv7zEXxVYreF1GnyG//b13dg5FYEEqml3Vg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7388
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40
 definitions=2025-04-25_05,2025-04-24_02,2025-02-21_01
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0
 mlxscore=0 adultscore=0
 phishscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 spamscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2504070000
 definitions=main-2504250121
X-Proofpoint-ORIG-GUID: _L5z2chFp4EAzUQOsPflRDf-574bWVpz
X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDI1MDEyMSBTYWx0ZWRfXwSyRk0e4ORyT
 6Pg8tIXPm7jnLGiN+pMjR/KmYp4z4qmXK7CP1Ih7UeFE8dUfbsyekfqAC4PH1Nhf+4fXMRmCffY
 txLzAZIhyl3rSFfAuLGXrHZm/1q5Y7+DgpLpIxEJcFqtfpv61Nw37k5vOz0vJeD36zLNApnMtSZ
 dwTxKqpfInNhTsmSkDdmE9HINzjnhlSFVitHbPuZBch9zTVCEzMFpds/wssDFevwImt7sSHu2hh
 nAYOazNyv6BXYmA2lrCQX8UGX+ItG4DmvmCMUVi6s96sI0Pd9GrdG6M1zS2K86IG0Gz7QO0yvgI
 AfKeAqOeH+aMDOMNFmB0s06cppyIg0wqksV6co6gRXX3oVnDG5v4qN1lDRfQyyeSny3/pq4Qwtc
 RHt2XJho
X-Proofpoint-GUID: _L5z2chFp4EAzUQOsPflRDf-574bWVpz
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

> > This bug is only about this existing text, which
> > I can't fathom (and "places" should be "place"):
> >
> >   "Conversely, when you insert a closing delimiter
> >    over an existing one, no insertion takes places,
> >    and that position is simply skipped over."
> >
> > (And the node-name abbreviation shouldn't just be
> > "Matching".  There are lots of kinds of matching
> > in Emacs; please don't hijack that term for this.)
> >
> > If you fix this bug, then fine.  But please make
> > your other changes independently of this bug fix.
> > Or at least make very clear what part of your fix
> > actually corresponds to fixing this bug.  Thx.
>=20
> Here is Eli's clarification of the bit you found wanting:
>=20
>    "However, if you insert a closing delimiter where one already exists
>    (probably a mistake, since typing the opening delimiter inserted the
>    closing one for you), Emacs simply moves point to after the closing
>    delimiter, skipping the insertion."
>=20
> And here is my reformulation, which includes a more complete description
> of the behavior, which I think is needed to understand the
> functionality:
>=20
>    "However, if you type a closing delimiter at a buffer position
>    between matching delimiters of the same type with only white space
>    between the delimiters, then by default Emacs simply moves point to
>    after the closing delimiter and does not insert another one."

"Matching" delimiters implies matching delimiters of
the same type, no?

Not clear enough:

"with only white space between the delimiters".
Only whitespace between which delimiters?  There are=20
presumably at least 3 delimiters in this scenario, one
opening and two closing.

Not clear enough:

"to after the closing delimiter".
Which closing delimiter?  Immediately after it?
If not, where after it?

> But I also made numerous other changes in this documentation, for
> reasons I listed in my emacs-devel post, which is included in the post
> you replied to and should be readable at the URL I provided above.
> Admittedly, my other changes widen the scope of your bug report, but I
> took that to be legitimate, since it's still about clarifying the
> documentation of Electric Pair mode.  If you disagree, then I apologize
> for hijacking your bug report (though I don't see it that way), but at
> this point I would rather not open a new bug report and repeat
> everything there; I hope you can accept that.

I don't intend to review all of your proposed text.
I'll review the text that fixes the bug I filed.

And please change the name of the node (the name
used by `g' etc.) from just "Matching" to something
else, preferably something that indicates it's
about matching delimiters.  That too is part of
this bug/enhancement request.

Thanks for working on this.  And thank you for
providing the proposed text (for the part concerning
this bug).  When reviewing doc changes we shouldn't
have to decipher a diff or apply it.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 16:30:46 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 12:30:46 2025
Received: from localhost ([127.0.0.1]:51976 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8Lwr-0004oM-SJ
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 12:30:46 -0400
Received: from mout.gmx.net ([212.227.17.22]:54689)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u8Lwo-0004nk-JF
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 12:30:43 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745598629; x=1746203429; i=stephen.berman@HIDDEN;
 bh=HcnI//ThwVgdYZvH8qc1ydQu8mHrF/26sr30+ODJaE0=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:
 content-transfer-encoding:content-type:date:from:message-id:
 mime-version:reply-to:subject:to;
 b=PqJx7s4L0RM5sg9GkGjUXQaxR201Eqp0bMNiUMRaWME51D8zR9rq2nFNC9R21NSE
 YzaT3x8d1wi3tOY76a8u2u3dwwyNRM1EBSvkBzcaZZfZ5Ra8Jcq6jRBRxVL8bmdIZ
 aLuaccYc6Q0jDJKcOeKGLcIRPl7cYuSibdbn4VDxt0Bl0wgCVuEUlo/yxNwIxg+DI
 MjwxvXkbFuJaiB6kseWGhJddhTDMK/aWb49wdOgH9e+CxQkUwCcvNEdw9gkyaBqDG
 duxPQZ8g0ZvuJG3LBL+HEP2XKNyd9tPX6A21N6AXIQmLqpP1v4BY69VQGacOecVIF
 tzUcXDyoartD4qIFTA==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.238]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MdNY8-1uhPe92HLs-00d5hx; Fri, 25
 Apr 2025 18:30:29 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
Subject: Re: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
In-Reply-To: <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
 <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
Date: Fri, 25 Apr 2025 18:30:28 +0200
Message-ID: <87h62c6w63.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:+KIWMUsrbUCxpE9626aCj3wIDsgOeb8FXMNRNAuQ8LsV/m938Pi
 ewqvedX8Vt/+loyJfcG9k8Fz0XBRiR4qiA7FbaNyRGscXTfUnkgbUWhrPWf+Lw0HkXAWu68
 GaF7VB9QLOHAzxhT+lSwgnHLS1k3BkVqS3yOLYnJ/Z++UtyPYWyn33pl47rRuITPo7EcJmC
 iYpNOIuIZaxGcyUKgDDLQ==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:XRXT8+ULv3I=;HsVBlwJJWURks41wUCzybyJoyCV
 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
 2OSUSnj2zdZbq2tyGZ3qBI=
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>,
 "78021 <at> debbugs.gnu.org" <78021 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

On Fri, 25 Apr 2025 15:51:31 +0000 Drew Adams <drew.adams@HIDDEN> wrot=
e:

> I don't have Eli's fix, to compare,=20

I included the diff of his fix in my post, so I wonder why you can't see
it there; I also see it in the mailing list archive:

https://lists.gnu.org/archive/html/bug-gnu-emacs/2025-04/msg01589.html

But I will quote from his fix below for your convenience.

>                                     and I can't
> follow your diff wrt the text I see in Emacs 30,

This is because my diff was against the current emacs-30 branch, which
contains Eli's changes.  But again, you should be able to see his diff
at the above URL (and in my post).

> so I can't tell what, in your suggested text, you
> think actually responds to _this_ bug, which I
> filed.
>
> This bug is only about this existing text, which
> I can't fathom (and "places" should be "place"):
>
>   "Conversely, when you insert a closing delimiter
>    over an existing one, no insertion takes places,
>    and that position is simply skipped over."
>
> (And the node-name abbreviation shouldn't just be
> "Matching".  There are lots of kinds of matching
> in Emacs; please don't hijack that term for this.)
>
> If you fix this bug, then fine.  But please make
> your other changes independently of this bug fix.
> Or at least make very clear what part of your fix
> actually corresponds to fixing this bug.  Thx.

Here is Eli's clarification of the bit you found wanting:

   "However, if you insert a closing delimiter where one already exists
   (probably a mistake, since typing the opening delimiter inserted the
   closing one for you), Emacs simply moves point to after the closing
   delimiter, skipping the insertion."

And here is my reformulation, which includes a more complete description
of the behavior, which I think is needed to understand the
functionality:

   "However, if you type a closing delimiter at a buffer position
   between matching delimiters of the same type with only white space
   between the delimiters, then by default Emacs simply moves point to
   after the closing delimiter and does not insert another one."

But I also made numerous other changes in this documentation, for
reasons I listed in my emacs-devel post, which is included in the post
you replied to and should be readable at the URL I provided above.
Admittedly, my other changes widen the scope of your bug report, but I
took that to be legitimate, since it's still about clarifying the
documentation of Electric Pair mode.  If you disagree, then I apologize
for hijacking your bug report (though I don't see it that way), but at
this point I would rather not open a new bug report and repeat
everything there; I hope you can accept that.

Steve Berman




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 15:51:47 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 11:51:47 2025
Received: from localhost ([127.0.0.1]:51716 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8LL8-0001zs-Kv
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 11:51:47 -0400
Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:5668)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew.adams@HIDDEN>)
 id 1u8LL6-0001zf-Bh
 for 78021 <at> debbugs.gnu.org; Fri, 25 Apr 2025 11:51:45 -0400
Received: from pps.filterd (m0246630.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53PF6Z8U030096;
 Fri, 25 Apr 2025 15:51:43 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc
 :content-transfer-encoding:content-type:date:from:in-reply-to
 :message-id:mime-version:references:subject:to; s=
 corp-2023-11-20; bh=3Ozcyzq/giiFk3SA4rEXhd0eV5GPGwCYeWfgPKIKLBI=; b=
 EML9pbynoa2WWIrMDWrKRZC35iBBXE4RVO2hB0hjeHCo7suAhxYoCvQVVgDKyD1m
 W5FImmLUt0F3BUxlFS20wbbNUpcc1hC0O82bzScJ+oNBkxv/NkT4alefxGER0+v8
 cV44goQu8tftz4kj088QW3IQ6ImqRoG/7cvxtQGfk9Z55E7oDlu7YEVSS9NMEa3H
 y0niTvYs6unJgqWXMkbsvf1bvD0IFhWaxAWYIOdeRet/suwGwzIwAxjjliccFakO
 FZm6U3+95vd9JCAQAMtqMNUFIQ46YsbGyhAG6zmuVTDKs6TAgF9N2loMocNfbVSj
 Vla84oZ32083TVYYuk9G2A==
Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com
 (phxpaimrmta03.appoci.oracle.com [138.1.37.129])
 by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 468cr606mq-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 15:51:42 +0000 (GMT)
Received: from pps.filterd
 (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1])
 by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2)
 with ESMTP id 53PEZleM024835; Fri, 25 Apr 2025 15:51:34 GMT
Received: from cy7pr03cu001.outbound.protection.outlook.com
 (mail-westcentralusazlp17012038.outbound.protection.outlook.com [40.93.6.38])
 by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id
 467pucy8wb-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Fri, 25 Apr 2025 15:51:34 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=c0Lqz4yhS+2IfJ3vaOVGeomRQQhjPuL8QcCMnimRCb/MQGxH7CfUuwMCAa/a7iiNx3UZSkoN6KeEUOE5xqgDZkiJ5ChnBNhQokOWNoZmKckvw0UQZ4xLaVwia8kq+t0JenjvUNCotflCJpuq900G8eM4dG2TUHy69HRk7MxuUjbz+8L4ZNO1ay7/x9/ECOPZB3GFh7A4txqqh3hS0Imdyhh25nt/Va0i7sMUX9caUTmyOh4LfU92GNupaypSPomN/1zfQs5oUPCZ5U3jsQfwZDtqGngRaJu0vT1OE6w/TvFqQzHd8rPE7FPBp8c9E+rtASRzpGJNpkQ3oB5tmnmHGg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=3Ozcyzq/giiFk3SA4rEXhd0eV5GPGwCYeWfgPKIKLBI=;
 b=JGAd1Lx4MX+hS0NHv/ES7ssKpc8GTTvAmmHA7VfMGmJmJI3Xp+dOJeJgusPMrqbVHYH5BysTpZIvgLZooUhmZBwoeNZshnIm3TIGPG2GwMlAhhJDe9oNeGChdV/d/fuElV8zAqvylXzGry4rqItmKgX2+gyEBa+t6jh92VkyyDnDJz20G0cQSWWmO/JS/f1fjlfsor1BXRP86StVV1e22VD0J+mC8ZjKFYJ6qxCP7xgDYlttA/aHw1FKblEboPDWH1kQlRf9u9u3F5OKOAsmk9VqcyNBg94lOlUY5y7EI4HXgnPC/LVnZyDDBvQcPAdQ2xkS3AemtMBG1c5sDO7UZg==
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=3Ozcyzq/giiFk3SA4rEXhd0eV5GPGwCYeWfgPKIKLBI=;
 b=o50A1ecNke9DYPcnB2gkrDQ8yf4Y5YRJSIKui80f2sFEcgZIZ1pj2i9o2MVSDelEq05xD3/iGsX21ww0yhguVI6PWKFc9Gy6208edyIOcLRj6AkcCGzg5KXY7bqtpJv/lfCAzzTSbPx+kIMjd6VH7oIOt0tz5JiYeM2oaFKbdhs=
Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24)
 by BY5PR10MB4212.namprd10.prod.outlook.com (2603:10b6:a03:200::23) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8678.27; Fri, 25 Apr
 2025 15:51:31 +0000
Received: from DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.031; Fri, 25 Apr 2025
 15:51:31 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>, "78021 <at> debbugs.gnu.org"
 <78021 <at> debbugs.gnu.org>
Subject: RE: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Topic: [External] : Re: bug#78021: 30.1; Unclear sentence in
 (emacs)Matching
Thread-Index: AQHbtejQ8gDzTGX7UUac2CQZ4Blx57O0hJag
Date: Fri, 25 Apr 2025 15:51:31 +0000
Message-ID: <DS7PR10MB5232CF28E551FCEC4364B1B8F3842@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN> <87ldro73nd.fsf@HIDDEN>
In-Reply-To: <87ldro73nd.fsf@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|BY5PR10MB4212:EE_
x-ms-office365-filtering-correlation-id: b7ce5a55-fc0e-41f8-8b89-08dd84110caa
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0; ARA:13230040|366016|1800799024|376014|38070700018;
x-microsoft-antispam-message-info: =?utf-8?B?M2VQcGtid0ZVeDkzN2pvc0Q5SWVlRDNtOWxjRmVBWFRMYitBQWJMODJRRWFF?=
 =?utf-8?B?d2lnM3pObEtsN2IxWGN5VUJ0NGpKZCtUMWNKSjdxb2RmTlBRbDJRZFY2NnRX?=
 =?utf-8?B?VDlDUGlGR0tIdVFDejd4Q3ZWMjFWZzU4VXpQL3U4ck5EeXRDaTd0UTUwTy9z?=
 =?utf-8?B?Nys2ejVGY01CS0pYbUlXQk84a0hSZlcwSDhWalpGL0g2aWY0allHZ2FYNzdW?=
 =?utf-8?B?dDgwNy9NdE5VN0h6eU5mdlAvYytCQnJ2dWovNmFKbzFxYlhJSXJLNFJFWUJz?=
 =?utf-8?B?c0xKR1RBSGkvTzBlS1FlaktLeGc1RGE3VXI0NVpqZ3RLYWRXdzJ2N1FER2lG?=
 =?utf-8?B?cW53ZWI3ZDA5TlJoelRiZE0vOVdGVHJQT3RJYU5CeER5RUlaY243bSt4c1Vq?=
 =?utf-8?B?N3ZoTlVLcFNpY2Q0Yno2SkY4ZmJ5dXVpTEh4TkF4cHNsVHdlZGJuNzFUYitx?=
 =?utf-8?B?YUQ5RUt1bE5ONjZUS3FEak5CTmlWVzFsS3VlK0hXaU9pSmpTaWpxdE1qWUNM?=
 =?utf-8?B?ajltN3A3bEZCcGxzT1l3SThxTHF6K1U0WTVFU2xiSEFCL0twOU9weVRrYm9H?=
 =?utf-8?B?UGtHSVBHV0tnVDBDblplYlBab2N3Nkw4QlRZV1NyQkxvd1JpN3puKzJKSEtu?=
 =?utf-8?B?V1lNK1VJaWZib1V0WVp6ckhKMUhheEdTdm42QStFaWZSbzdKb2dmVG9xbW5m?=
 =?utf-8?B?Z3llWXo4b1hIQ2gyRVcwaVhkaElOOVpLTS9zanlWWDRrZ09MZjBIaW5Tc0px?=
 =?utf-8?B?QXB5TW41M3ZMSmFGL3NZR1hONWFVbm5yUFIzbklETDdVTEtidVJvcGhCaEF5?=
 =?utf-8?B?M3JTUUlGbkRwRnBCTkJyeU1NZGh5bHZDdWFLbjlWTHFCNWxsaWgvVFNlK1ov?=
 =?utf-8?B?Mm1jQWtRWWEvOWptWUlXS2d0ZEdMYUt5dUxER0ozMklMSGZWa1daemV6TXZw?=
 =?utf-8?B?Y2tTRXBickVHWkFUYWhSZE91WjdUWk15VmppZzVtSG1uRG5NTys0bmZMZ3c3?=
 =?utf-8?B?a1p0bitiRk1tdHFPQU5sVmJGZU5vZGw3eStEQmZIOVBON1p2Z1ZRTzFoTnNk?=
 =?utf-8?B?L2JFZGdFUTRMWXptMUFWK3p5MXRLZFlmNWNWckRvUEhGclZVS0JyK2RWRFhq?=
 =?utf-8?B?SGMwWmJBLy9jLzc1dmFrbUNLN0lIOHVGa1pEaGRMN2JtdHpLRHdJU0F5YXAz?=
 =?utf-8?B?K1JPcnkxcW5pZHBiNGJocExrVlJ2RTNJZnZCa21ZYVJLWFJVeHZjNUdMdDdh?=
 =?utf-8?B?S1hBdzNsSnowUVZwR3pWNnNOakdaZmV4cUZLU3ZYcTRIOFVkZkNXcThyVXg4?=
 =?utf-8?B?akE2WGhKSkxLVDZsMkI4dzQzUWUxMkpVdWJ0QmZqblQ0eG9mZWtQOUVxNXFh?=
 =?utf-8?B?SXl2KzRYK0p3SHdzbWhVeEtaUU4rM1FCM1krOHN5K0paUURSOU5KK01HZXhm?=
 =?utf-8?B?cEFpNmZqZjdZRExEczNHbWxlY3dqSG1NRGtYZ2E4ZFZmVFdXaWQxaFhtOUEx?=
 =?utf-8?B?bkt4Y1JlekFXYWw1UkIwYWxaa0duSE8xRktvVEtzWFZiRHU5R29ubW01Zktt?=
 =?utf-8?B?Z3JsdCtHYjQwVHozWGVzNXNicTJoMzJtVzkwVjNPOGRHUHJmZS9GTnI5WDNT?=
 =?utf-8?B?SHlaNnRVeXVhNnVQdlRtbVlSS1FhcTNIcDFzYm1wdnFsbllGRmRVUDZldEY5?=
 =?utf-8?B?NnEzc0tUb1ZDYlRuME8zQk9RV09pTWdvNHlKaGVVK2FDcGgyNmtBSW56ZjhJ?=
 =?utf-8?B?T1NYbG1rOS90Vmg4RFRWTDNqMXZSQnZMSit4QmFwcWhzTUIrcERPU0Z1Rjdu?=
 =?utf-8?B?OTVySENEVzVPemMrZEFpMzlYcHZGWVhNQmk3UGFNa0tjbnAwTktJWGFGbTA5?=
 =?utf-8?B?L3lEd0l2aFdVM25YdmVoUXVEQVViVXVtZ3l4TGZHTXNKOFB6QVJzVTdjTDAr?=
 =?utf-8?B?Y0xvbmVOSWQvZGhFbGI2Mko2Zit2NlUybU05OWZXbzZTMk1SeDdTL0Fya0NV?=
 =?utf-8?B?ODhKTStYa2NRPT0=?=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(13230040)(366016)(1800799024)(376014)(38070700018); DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?utf-8?B?V0J2ZnZRSkJMenorVTdiTGxnZ1YrK3RVRnhqamtMaG01cXYvYmdpWFNiK2FU?=
 =?utf-8?B?dnZBZ054NWNFRWJKaGtpeEFicCswN0pOYVdRMUpuS09xSUpaRXZRWVluWmpR?=
 =?utf-8?B?YWhpZVNwZDViMEtHd0ZEWW5RNTlvai85VmVNaVViSmVUd1JpN3dseHpEZHpq?=
 =?utf-8?B?SnMvQ2JCOHZSVmN0SDAyaVRnbnpLMjVvWHMyMmxVd0lnZ09HQjkyTHFjRllv?=
 =?utf-8?B?QXZ1M2lhQkEyOEJQV2IyWWNMMnNpR28rNzNXdCtNSFNoR1hGMkdlZ1kxZ2Iy?=
 =?utf-8?B?eTBHRnJUd2RmQWxRc1Z6N2FhM0M4dDEzMmZGaEFQTXdpYVE1bWN3cjhDb0U1?=
 =?utf-8?B?U2g1b1B4eElhYmFabS9BUG55Z0huWHhzd3R5L3hMQVZQcjRwTW9rb0tTV2JR?=
 =?utf-8?B?KzlUMnpVVWFRTy9tckRncWFqVERySkQydEZNVWlvd2VqNEQyb2xRcVlxcjRO?=
 =?utf-8?B?NVJyekhPSkx1V1VnaUVWK3lIZkJQMXNuWVR2Mk5KUHhpUU5SUi9PZE5ZR3Yw?=
 =?utf-8?B?UmdQampyZEt0L2E0Q0tKcWF0TThTZ3NRdmsyYWhtUVhaYy9CbFh4SmNZVVA4?=
 =?utf-8?B?WU1wWHlqWTR3WThMQWptU0U3MG9wOHEwTGFVUGo4ZTJDTXJzMTlyNkJ1WkZq?=
 =?utf-8?B?TlpGNGdQZy95RGsrU3ZJRDhpdHRtZGQ4NUh0SFE4L21zYTQ5S00xVVQvU0Za?=
 =?utf-8?B?alduT0c5dGI1bW5jWWE0bFcrcmpmK25QR0Q5N0Ntc3JGN2wrR3k1UWtjc1o1?=
 =?utf-8?B?QkRndUVHRGdlN3cxZGo1NEYrVnBSd0lJQlAzZENkV2J6V0ZQOG12Q1h6aUlC?=
 =?utf-8?B?Q3pvZ2x4NStZZFdCZnpzSHdEWlVxSGdxNHRic1ltbFNZUjlXQXp3eXlJQXp1?=
 =?utf-8?B?RlBMUU1ibWZPQVFGRU41cStVcmtPMG9tdWdCRHpPTVhKdllNaHlsMjd5c09U?=
 =?utf-8?B?L1ozWWhzalBYWlBNOXVxclRrTGhJcXFvK2N0VTVGa2hSR05VR2ppRFROWXZN?=
 =?utf-8?B?K2xPK05PQ2NWRlRqUTJWUmZvdjY5UDZZak96bVhmdFlEVVNyTU1UKzRjQTR6?=
 =?utf-8?B?SklzcGg4TzVJU1VFWEhiR0I1Q2dPN2g2TzlSTmd4clVXM2l6MjFSa3QzbDdC?=
 =?utf-8?B?SDhmV05jL28wbnVpRDBQVERjWWVJd3FHMitrM2VqWnZQU0N2SzFVTkR4ZDhO?=
 =?utf-8?B?aU5aSmJ3SGlYVy83NzJnRUdXS0pzSkpOR3BjblVpWFA3d0JPM2o4RjBqS1l5?=
 =?utf-8?B?UFdYeTNGbmYzaVlubHBPRWZ5R2dMUTNwTVU5Syt2SzQrQ1pGWEdPL0ZBSkIx?=
 =?utf-8?B?NHhmVGRtK0xFM3BEbGNiWW9tS1R4Rm1SbE9EeUpVY1ZYZmcxUkxRNWJFSTM1?=
 =?utf-8?B?bjRrNGtuUjRJcUJFY2hHV1FSK1pGajJXK0xkQkxxVFZQMnlGczIwd0NzY1BJ?=
 =?utf-8?B?bmZKeVQya2VwQ0xaUzFaamxYRzV5N1dHRWNOVi84KzVlU251YU5iWGdHK3lo?=
 =?utf-8?B?THBvYjVHTlVkT20vM0xseUszVUpOckJFSzRjL05tWHZGM1ZFOGZpN2xBZFBQ?=
 =?utf-8?B?eFV5ay9rVHYrUXRTeGFMaVF2eFlwL0xQOTRkc2Y0emRLWC9ueThqTHNMOUFq?=
 =?utf-8?B?VTNoMGJRWDZsalVtZktXUlhGTGM1ZFEyVGJ4K1hpbDR2bys5aFptZ2FUa2g4?=
 =?utf-8?B?dEZZZEV3TVdNYkF1YlIrbU50K2hRN2d5am1GUkNEU1dJYlE3U1BrVTJINHJB?=
 =?utf-8?B?UjZ2NzNvVVVUSThQQ05LbTYxeG1UL2cvMVhJU0ZXMjlGUzJseU0wTzNDNTZj?=
 =?utf-8?B?UUtSWG1ZQkZQemtYMm1yOGliWXA3d3cxazlKWmxScGpLMkdab0JGcXhjbHFr?=
 =?utf-8?B?Q0ovWlp6emNYNjBvMU1IOVFmdmRHcHJNdWhaS0VlcVJoT0tMWWxnN3QyUzlh?=
 =?utf-8?B?VW5nTHNZOFh6WEdZZFBKc0Z1azByOUhDREI2c28zc0dZbG5jNllUdHVHeWtj?=
 =?utf-8?B?aFlrYzNVVEVadVRjdXBzeGpyZVphWWN3QlovWGhsMmY3bjJKenBoQ0ZzdlMv?=
 =?utf-8?B?WVBZazVXMTl1NlBORWJKazVIQUUwZnQ4RE8xeW5qWlk5RDJlVkNVdTlyQ1dj?=
 =?utf-8?Q?kGkqbAdj85zV9xE7m22dSXEWI?=
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: Y4WEzHiMj1FXvaA71ZrgCxknPN3Qmcq2aukLKJDxvxRg5l+j5ZY4RJ7piEHVCxzk6ELpw6c6lkbO1WchP1Gy0B3aBk3A47SgQDOn50AuFv5KPEa0SQ4qE4Xrv1GyW64ody5aPaBYw+Ti9C30y249vSkIVRV0M8Z/MBQVeFsVfAEc4QlJ2vqEhP1mQCA4dL83GApHZHtnhMBE/lHyzzvKopW5yQY4c3k0s2+oyExhadlEW9Q+6PmDWLFUnzZPoXH3g/vD+VzxXcQy5GaZ1xx8J8weqR/34FLtlqo1DTpzXUPRXgObk/rGU9/XsYjXH1zZS+GZ+pG1NgIQ7i9wst/wXa1tNkOc7S3AwjXOY9SyYNJ6hbQECh9Wz2IL5/nvhwOxuPDkFD4rZzHhC5vOedG9gtQEX6umTmBNO/dLHPQU/YevPCpd8sX9wTeKe8mJAYYMzAKzhoWayTylwXqF9OwYNW2f8ozyp5YNQWlzLTNzatVhXZRnNvd9gjHYB4cMFIMBMELjwMHYldu0yZu4vnwfr2ejU2iY5YC133HYVGisrBZivMu2Fnb+PL2TEME0x//zq0WsTJ41Ri8GsJDZedl3h1kAj/3wASuQyTMLKVbS/pg=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: b7ce5a55-fc0e-41f8-8b89-08dd84110caa
X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Apr 2025 15:51:31.7784 (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: 0GpdbnmPv1Wj0VHjOuY7bbnLGkcVEaS9f9GVVXBGStt05vcq1TTqMzLYzq/6WHeG9A7sD8M9QG0kd3js5LD2qA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR10MB4212
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40
 definitions=2025-04-25_04,2025-04-24_02,2025-02-21_01
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0
 mlxlogscore=999
 mlxscore=0 spamscore=0 phishscore=0 bulkscore=0 adultscore=0
 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2504070000 definitions=main-2504250112
X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDI1MDExMiBTYWx0ZWRfX1lsHcLFiV0QG
 b6p5WXzMVQ9qCd1FBxy7S7suKfv3MEj5DBscMgyZqufob0v5/EMGRQIqSqnG6/8YeJeSq8iCqSL
 OqqdrlMELMUSeCRvual7AhcSudbiYMg06ZMYPTWKbINqTWkjkYE0MJM895CzWqm5mWAq99MjxCM
 RSBkU2U7T+1eYs+KQ0eKfPZ3lh7RkKXKGL1cybQILMKRXbGJICi5UZK7ohrEJnSwiHCiFnfpM2P
 y6jALhkQmEhyWZ9uoxWrSKBuMHXHqtZm8DKzxZlODGAsG/7GWsptMSiOpp6eZDdvkehm034Ehtb
 RknGirC7IkrTKGkx9WbiDkVpBNzpqKhl7n4wj+n6rTLF7fXAhqqvvh930CwA1vrclvLIOzcqw0w
 eEOy9m6D
X-Proofpoint-GUID: a4yX471zlnd-yZJHEJwfumXoGvQcOJ62
X-Proofpoint-ORIG-GUID: a4yX471zlnd-yZJHEJwfumXoGvQcOJ62
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: "eliz@HIDDEN" <eliz@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

SSBkb24ndCBoYXZlIEVsaSdzIGZpeCwgdG8gY29tcGFyZSwgYW5kIEkgY2FuJ3QNCmZvbGxvdyB5
b3VyIGRpZmYgd3J0IHRoZSB0ZXh0IEkgc2VlIGluIEVtYWNzIDMwLA0Kc28gSSBjYW4ndCB0ZWxs
IHdoYXQsIGluIHlvdXIgc3VnZ2VzdGVkIHRleHQsIHlvdQ0KdGhpbmsgYWN0dWFsbHkgcmVzcG9u
ZHMgdG8gX3RoaXNfIGJ1Zywgd2hpY2ggSQ0KZmlsZWQuDQoNClRoaXMgYnVnIGlzIG9ubHkgYWJv
dXQgdGhpcyBleGlzdGluZyB0ZXh0LCB3aGljaA0KSSBjYW4ndCBmYXRob20gKGFuZCAicGxhY2Vz
IiBzaG91bGQgYmUgInBsYWNlIik6DQoNCiAgIkNvbnZlcnNlbHksIHdoZW4geW91IGluc2VydCBh
IGNsb3NpbmcgZGVsaW1pdGVyDQogICBvdmVyIGFuIGV4aXN0aW5nIG9uZSwgbm8gaW5zZXJ0aW9u
IHRha2VzIHBsYWNlcywNCiAgIGFuZCB0aGF0IHBvc2l0aW9uIGlzIHNpbXBseSBza2lwcGVkIG92
ZXIuIg0KDQooQW5kIHRoZSBub2RlLW5hbWUgYWJicmV2aWF0aW9uIHNob3VsZG4ndCBqdXN0IGJl
DQoiTWF0Y2hpbmciLiAgVGhlcmUgYXJlIGxvdHMgb2Yga2luZHMgb2YgbWF0Y2hpbmcNCmluIEVt
YWNzOyBwbGVhc2UgZG9uJ3QgaGlqYWNrIHRoYXQgdGVybSBmb3IgdGhpcy4pDQoNCklmIHlvdSBm
aXggdGhpcyBidWcsIHRoZW4gZmluZS4gIEJ1dCBwbGVhc2UgbWFrZQ0KeW91ciBvdGhlciBjaGFu
Z2VzIGluZGVwZW5kZW50bHkgb2YgdGhpcyBidWcgZml4Lg0KT3IgYXQgbGVhc3QgbWFrZSB2ZXJ5
IGNsZWFyIHdoYXQgcGFydCBvZiB5b3VyIGZpeA0KYWN0dWFsbHkgY29ycmVzcG9uZHMgdG8gZml4
aW5nIHRoaXMgYnVnLiAgVGh4Lg0K




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.
Did not alter fixed versions and reopened. Request was from Debbugs Internal Request <help-debbugs@HIDDEN> to internal_control <at> debbugs.gnu.org. Full text available.

Message received at 78021 <at> debbugs.gnu.org:


Received: (at 78021) by debbugs.gnu.org; 25 Apr 2025 13:49:21 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Apr 25 09:49:21 2025
Received: from localhost ([127.0.0.1]:49021 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8JQd-0005L1-Qa
	for submit <at> debbugs.gnu.org; Fri, 25 Apr 2025 09:49:20 -0400
Received: from mout.gmx.net ([212.227.17.21]:46221)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <stephen.berman@HIDDEN>)
 id 1u8JQa-0005KX-4y; Fri, 25 Apr 2025 09:49:17 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1745588939; x=1746193739; i=stephen.berman@HIDDEN;
 bh=6JXoDLILpOO5UJJcYtGeldpC/hsPypM20Jt3C8/cyyk=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
 Message-ID:MIME-Version:Content-Type:cc:content-transfer-encoding:
 content-type:date:from:message-id:mime-version:reply-to:subject:
 to;
 b=K02dKciGdGkLwqG7mAG6gnKXjsgtyqLQFQk7SXPDc6JMqlgXs+cTcdHdvSv/lM+T
 ATQKgA7L+n60igp8zBaRMgwcA5HnwpCdCTEXo80ZSzPh8Vsa0Bu58KfE8md0AHOt7
 oQh5YYcdTphEz/gHAIuOsZsQl8CUM+c7zeAuzKQGltF5H/64xSve8QHA8JOUNG/N4
 vT0YrwS9weL0o+HZB4uXihwT0mdlhLP8e1hIy4FODL5wbcmVKcZ7vwdzwoHeascyD
 1LocQpc3h2RBhM6W0pdhKmmRU0plAsrKxq9jNFhKdd+WcMI2Zu0NjlsQTFStsnyMG
 KqsD7645GUmSmXVmiA==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs2 ([94.134.95.238]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MVNB1-1uZ5kj3vlv-00T5pA; Fri, 25
 Apr 2025 15:48:59 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: 78021 <at> debbugs.gnu.org
Subject: Re: bug#78021: 30.1; Unclear sentence in (emacs)Matching
In-Reply-To: <868qnqylg0.fsf@HIDDEN>
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 <868qnqylg0.fsf@HIDDEN>
Date: Fri, 25 Apr 2025 15:48:54 +0200
Message-ID: <87ldro73nd.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:oeWMWDuGiNsMahZCYw5Lqq0Odzv9cspLQcwAO5YMrxuywy7wNe+
 yrJpzL1QUj1crnc7wHmT5GRBjQvPyrhLl9chrcBeQ+5XEDCyDOIect1HKA68feMqso1rfhN
 5ZjCnzI9GkC9Aot+de2HSzds++35Y7rvgSGvpr/o6vDZIVmpPoUwR/Qef/yl2fOPhKL/ddo
 208I36CvxIAvSfyJDgrzA==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:/gwIjQ0O4zc=;v9ND1UpmtvCHEp4YeFdiwd/CJyY
 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
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 78021
Cc: eliz@HIDDEN, drew.adams@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable

reopen 78021
thanks

(In light of the posts related to this bug on emacs-devel, included
below for convenience, I've reopened this bug and am following up here.)

On Thu, 24 Apr 2025 18:30:37 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Stephen Berman <stephen.berman@HIDDEN>
>> Cc: Eli Zaretskii <eliz@HIDDEN>
>> Date: Thu, 24 Apr 2025 16:15:16 +0200
>>=20
>> On Thu, 24 Apr 2025 05:08:40 -0400 (EDT) Eli Zaretskii <eliz@HIDDEN> wr=
ote:
>>=20
>> > branch: emacs-30
>> > commit a975232c0fd7bbcce39f904518bd068a879ea4f0
>> > Author: Eli Zaretskii <eliz@HIDDEN>
>> > Commit: Eli Zaretskii <eliz@HIDDEN>
>> >
>> >     ; * doc/emacs/programs.texi (Matching): Fix wording (bug#78021).
>> > ---
>> >  doc/emacs/programs.texi | 25 ++++++++++++++-----------
>> >  1 file changed, 14 insertions(+), 11 deletions(-)
>> >
>> > diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
>> > index e155092676b..820a772104e 100644
>> > --- a/doc/emacs/programs.texi
>> > +++ b/doc/emacs/programs.texi
>> > @@ -960,11 +960,11 @@ argument specifies the number of levels to go do=
wn.
>> >=20=20
>> >  @node Matching
>> >  @subsection Matching Parentheses
>> > -@cindex matching parentheses
>> > +@cindex matching, parentheses and other paired delimiters
>> >  @cindex parentheses, displaying matches
>> >=20=20
>> > -  Emacs has a number of @dfn{parenthesis matching} features, which
>> > -make it easy to see how and whether parentheses (or other delimiters)
>> > +  Emacs has a number of @dfn{parenthesis matching} features, which ma=
ke
>> > +it easy to see how and whether parentheses (or other paired delimiter=
s)
>> >  match up.
>> >=20=20
>> >    Whenever you type a self-inserting character that is a closing
>> > @@ -1065,14 +1065,17 @@ nonblank line.
>> >  @findex electric-pair-mode
>> >    Electric Pair mode, a global minor mode, provides a way to easily
>> >  insert matching delimiters: parentheses, braces, brackets, etc.
>> > -Whenever you insert an opening delimiter, the matching closing
>> > -delimiter is automatically inserted as well, leaving point between the
>> > -two.  Conversely, when you insert a closing delimiter over an existing
>> > -one, no insertion takes places, and that position is simply skipped
>> > -over.  If the region is active (@pxref{Mark}), insertion of a
>> > -delimiter operates on the region: the characters in the region are
>> > -enclosed in a pair of matching delimiters, leaving point after the
>> > -delimiter you typed.
>> > +Whenever you insert an opening delimiter, the matching closing delimi=
ter
>> > +is automatically inserted as well, leaving point between the two.
>> > +However, if you insert a closing delimiter where one already exists
>> > +(probably a mistake, since typing the opening delimiter inserted the
>> > +closing one for you), Emacs simply moves point to after the closing
>> > +delimiter, skipping the insertion.  If the region is active
>> > +(@pxref{Mark}), insertion of a delimiter operates on the region: the
>> > +characters in the region are enclosed in a pair of matching delimiter=
s,
>> > +leaving point after the delimiter you typed.  If you provide a prefix
>> > +argument when inserting a delimiter, the numeric value of that prefix
>> > +argument specifies the number of pairs to insert.
>> >=20=20
>> >  These variables control additional features of Electric Pair mode:
>>=20=20=20
>> I think the documentation of Electric Pair mode (both before and after
>> the change), is incomplete or inaccurate in several respects:
>>=20
>> - What counts as paired delimiters can vary with the mode (e.g.,
>>   emacs-lisp-mode includes ` and ', and latex-mode includes $).
>>=20
>> - Whether typing an opening delimiter automatically inserts the matching
>>   closing delimiter depends both on the presence or absence of a
>>   following unmatched closing delimiter as well as on the value of
>>   electric-pair-preserve-balance.
>>=20
>> - Unless the region is active (see below), typing a closing delimiter
>>   anywere (not just where a closing delimiter already is) does not
>>   insert the matching opening delimiter but is just like typing a
>>   non-delimiter self-inserting character.
>>=20
>> - With a numeric prefix argument N, typing an opening delimiter normally
>>   (but see below) inserts N nested (not sequential) paired delimiters
>>   and leaves point directly after the innermost opening delimiter, while
>>   typing a closing delimiter inserts N nested paired delimiters only
>>   with an active region, leaving point directly after the outermost
>>   closing delimiter.  If there is an unmatched closing delimiter, then
>>   typing the opening delimiter with a numeric prefix argument inserts
>>   just N copies of the opening delimiter, not N nested paired delimiters
>>   (even if electric-pair-preserve-balance is non-nil, which might be
>>   considered a bug).
>>=20
>> - The user option electric-pair-preserve-balance only affects the
>>   behavior of opening delimiters (I haven't yet tested the other
>>   Electric Pair mode user options).
>>=20
>> Should the documentation be amended accordingly?
>
> I think so, but please try to be as concise as possible, and secondary
> details could be omitted entirely.  I wouldn't want to have this node
> bloated too much because of this minor feature.
>
> For example, your first point could be addressed by adding just this:
>
>   What counts as paired delimiters depends on the major mode.
>
> Thanks.

I've attached a patch for emacs-30 and have several remarks concerning
it.  First, regarding my first point above, since the parent node
already says "The major mode controls which delimiters are significant
[...]", I now think there is no need to reiterate it here.

Second, in the first paragraphs of the patch I've tried to describe the
default behavior concisely and completely; however, the sentence about
the numeric prefix argument, which evidently comes from the
documentation in master, is not suitable for emacs-30: the use of the
prefix argument was added (together with its documentation) as a result
of bug#72437 only to master.  If my doc changes for emacs-30 are
acceptable, they should be added to master as well, but not merged,
because of the prefix argument doc.  But in addition, in testing the use
of the prefix argument I've encountered what seems like buggy behavior,
one instance of which I pointed out above; I'm still investigating this
and plan to file a bug report about it.  A doc patch for master should
await the outcome of that.

Third, concerning the user options, I think it's better not to use the
phrase "when non-=E2=80=98nil=E2=80=99", which is in all cases the default =
value: for
electric-pair-preserve-balance, the behavior with that value was already
described, so it's better (and more parsimonious) to focus on the
behavior with the non-default value here; and for the other three
options a user-defined function is also allowed as value, which of
course is non-nil, but I don't think documenting this value is
appropriate for the Emacs manual, so I think it's better just to say "by
default".

Finally, in the description of electric-pair-preserve-balance the
penultimate parenthetical sentence seems like a rather shamefaced
admission of a bug.  Indeed, it does strike me as a bug, and I have a
simple fix that makes setting this option to nil have the same effect
with an active region as without, according to my initial testing.  I
will file a bug report and include the patch.  If the maintainers agree
that this is a bug and that the patch fixes it, then the parenthetical
sentence can be removed.  But whether that goes only for master or also
for emacs-30 is also for the maintainers to decide.

Steve Berman

--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: electric pair mode doc patch
Content-Transfer-Encoding: quoted-printable

diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 820a772104e..ff8cf904915 100644
=2D-- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -1063,52 +1063,65 @@ Matching
 @cindex Electric Pair mode
 @cindex inserting matching parentheses
 @findex electric-pair-mode
-  Electric Pair mode, a global minor mode, provides a way to easily
-insert matching delimiters: parentheses, braces, brackets, etc.
-Whenever you insert an opening delimiter, the matching closing delimiter
-is automatically inserted as well, leaving point between the two.
-However, if you insert a closing delimiter where one already exists
-(probably a mistake, since typing the opening delimiter inserted the
-closing one for you), Emacs simply moves point to after the closing
-delimiter, skipping the insertion.  If the region is active
-(@pxref{Mark}), insertion of a delimiter operates on the region: the
-characters in the region are enclosed in a pair of matching delimiters,
-leaving point after the delimiter you typed.  If you provide a prefix
-argument when inserting a delimiter, the numeric value of that prefix
-argument specifies the number of pairs to insert.
-
-These variables control additional features of Electric Pair mode:
+  Electric Pair mode is a minor mode that provides a way to easily
+insert matching delimiters: parentheses, braces, brackets, quotes, etc.
+To toggle Electric Pair mode globally, type @kbd{M-x
+electric-pair-mode}.  To toggle it only in the current buffer, type
+@kbd{M-x electric-pair-local-mode}.
+
+  When this mode is enabled and you type an opening delimiter, then by
+default the matching closing delimiter is normally automatically
+inserted as well, leaving point between the two.  However, if there is
+an unmatched closing delimiter later in the buffer, then by default
+typing an opening delimiter inserts just that character, in order to
+balance opening and closing delimiters.
+
+  This makes it unnecessary to type a closing delimiter, and doing so
+normally simply inserts that character.  However, if you type a closing
+delimiter at a buffer position between matching delimiters of the same
+type with only white space between the delimiters, then by default Emacs
+simply moves point to after the closing delimiter and does not insert
+another one.
+
+  If the region is active (@pxref{Mark}), inserting either an opening or
+a closing delimiter encloses the characters in the region within the
+resulting pair of matching delimiters, leaving point after the delimiter
+you typed.
+
+  There are several user options for changing the default behavior of
+Electric Pair mode:
=20
 @itemize @bullet
 @item
 @vindex electric-pair-preserve-balance
-@code{electric-pair-preserve-balance}, when non-@code{nil}, makes the
-default pairing logic balance out the number of opening and closing
-delimiters.
+@code{electric-pair-preserve-balance}, when set to @code{nil}, makes
+typing an opening delimiter insert only that character, thus overriding
+the default pairing logic of balancing the number of opening and closing
+delimiters.  (However, if the region is active, setting this option to
+@code{nil} has no effect.)  The default is non-@code{nil} (on).
=20
 @item
 @vindex electric-pair-delete-adjacent-pairs
-@code{electric-pair-delete-adjacent-pairs}, when non-@code{nil}, makes
-backspacing between two adjacent delimiters also automatically delete
-the closing delimiter.
+@code{electric-pair-delete-adjacent-pairs}, by default, makes
+backspacing between two adjacent delimiters delete not only the opening
+delimiter but also the closing delimiter.
=20
 @item
 @vindex electric-pair-open-newline-between-pairs
-@code{electric-pair-open-newline-between-pairs}, when non-@code{nil},
-makes inserting a newline between two adjacent pairs also
-automatically open an extra newline after point.
+@code{electric-pair-open-newline-between-pairs}, by default, makes
+inserting a newline between two adjacent pairs also automatically open
+an extra newline after point.
=20
 @item
 @vindex electric-pair-skip-whitespace
-@code{electric-pair-skip-whitespace}, when non-@code{nil}, causes the min=
or
-mode to skip whitespace forward before deciding whether to skip over
-the closing delimiter.
+@code{electric-pair-skip-whitespace}, by default, makes typing a closing
+delimiter between matching delimiters of the same type behave as
+described above.  You can set this option to additionally delete any
+white space skipped over.  You can also set it not to skip over the
+following closing delimiter but simply insert a closing delimiter at
+point (thus making the following delimiter unbalanced).
 @end itemize
=20
-To toggle Electric Pair mode, type @kbd{M-x electric-pair-mode}.  To
-toggle the mode in a single buffer, use @kbd{M-x
-electric-pair-local-mode}.
-
 @node Comments
 @section Manipulating Comments
 @cindex comments

--=-=-=--




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.

Message received at 78021-done <at> debbugs.gnu.org:


Received: (at 78021-done) by debbugs.gnu.org; 24 Apr 2025 09:10:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Apr 24 05:10:24 2025
Received: from localhost ([127.0.0.1]:35909 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u7sbA-0007mU-3X
	for submit <at> debbugs.gnu.org; Thu, 24 Apr 2025 05:10:24 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:60582)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1u7sb6-0007lx-OG
 for 78021-done <at> debbugs.gnu.org; Thu, 24 Apr 2025 05:10:21 -0400
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 <eliz@HIDDEN>)
 id 1u7sb0-0006jH-QT; Thu, 24 Apr 2025 05:10:14 -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=BmcPAbCY6k1r7/2cUxUzhi4pLLloc3gt1NEr9Ovntts=; b=OFXlf05Dms5I
 3gseeLThyuIVepFoMVCAd+Ca6fdduIAJp8NI+4J6L1x7/DdoYFHKoV7rzZO/N08/fej90XUsyLS4n
 D3xD1VkIjNAPo4zpRkxup3VSDx3Pocn8AN4V46lSg13DIvG2VxR7b3P+XvzTdis9rcS2+GWWcXDZ1
 4mvzyN87U18eDn1o6Bf4LIZbrbjOWQMO6N0c1AdQO+vT+H81asjyhzAh0rBhqdRtSAuI9WfiUaqQ7
 cte7xi98JXqnLreF0AdBbNXKe5KONAtgQN7crh+bAfwMJ60/44EuIIGX4worPkkwdwYeIvwRnTYcF
 uKK4NrrjBrdFfEw5ZpqcEQ==;
Date: Thu, 24 Apr 2025 12:10:07 +0300
Message-Id: <868qnqylg0.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
In-Reply-To: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
 (bug-gnu-emacs@HIDDEN)
Subject: Re: bug#78021: 30.1; Unclear sentence in (emacs)Matching
References: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 78021-done
Cc: 78021-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> Date: Wed, 23 Apr 2025 22:42:49 +0000
> From:  Drew Adams via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> 
> In (emacs)Matching (not a great name for the node abbreviation, BTW),
> this sentence is unclear:
> 
>   "Conversely, when you insert a closing delimiter over an existing one,
>    No insertion takes places, and that position is simply skipped over."
> 
> What does it mean to insert a closing delimiter "over an existing one"?
> No idea what this is trying to say, or why it's deemed the "converse" of
> what happens when you insert an opening delimiter.
> 
> Presumably it should include something about what happens to the
> "existing" closing delimiter, and something about point, if it hopes to
> convey the converse behavior.

Thanks, I've fixed the wording on the emacs-30 branch.




Notification sent to Drew Adams <drew.adams@HIDDEN>:
bug acknowledged by developer. Full text available.
Reply sent to Eli Zaretskii <eliz@HIDDEN>:
You have taken responsibility. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 23 Apr 2025 22:43:58 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Apr 23 18:43:58 2025
Received: from localhost ([127.0.0.1]:59352 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u7iov-0003Z5-PU
	for submit <at> debbugs.gnu.org; Wed, 23 Apr 2025 18:43:58 -0400
Received: from lists.gnu.org ([2001:470:142::17]:48956)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew.adams@HIDDEN>)
 id 1u7ios-0003YD-GI
 for submit <at> debbugs.gnu.org; Wed, 23 Apr 2025 18:43:55 -0400
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 <drew.adams@HIDDEN>)
 id 1u7iom-0000FY-Q3
 for bug-gnu-emacs@HIDDEN; Wed, 23 Apr 2025 18:43:48 -0400
Received: from mx0a-00069f02.pphosted.com ([205.220.165.32])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <drew.adams@HIDDEN>)
 id 1u7iok-0000gx-Ms
 for bug-gnu-emacs@HIDDEN; Wed, 23 Apr 2025 18:43:48 -0400
Received: from pps.filterd (m0246617.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53NLNAVo018126
 for <bug-gnu-emacs@HIDDEN>; Wed, 23 Apr 2025 22:43:14 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=
 content-transfer-encoding:content-type:date:from:message-id
 :mime-version:subject:to; s=corp-2023-11-20; bh=TfPQMCk6ZYOB+UTN
 ggR8eyQXGaYsw71jhgZsMP+J71s=; b=ASIfOv10fWtIpTgy2U5VxZk35/HUvvy0
 BUkGWO67g/mk2A+Oy2g1kLiF2sRpDhriqggnXLs/ZrhSa5108s56ixmAzuY/6qo/
 I6H6Sz0JMiRR7umG5F1VMq4ocnt4/ql2yj3ZpSwkeLBki97LUU5CUyPLnppJN5eF
 Nr+GfKEr699Zn0y8ddhMBHomRSlGX0GKzM+xglKbPTnZAJoDI9FaEuKgEULA+QDD
 ATDn4usqmGkLKxy0VJlPUsENPMkq0jXW6dTW89Xxl9QUJOymsAfTMzXHWMeKsKN2
 5ggTK6gJjlOQlcT5LUW/jAJV0ub4Kb8wvO9sx3QB1sfrTA0U2ku+ZQ==
Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com
 (phxpaimrmta01.appoci.oracle.com [138.1.114.2])
 by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 466jkjjg3k-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK)
 for <bug-gnu-emacs@HIDDEN>; Wed, 23 Apr 2025 22:43:14 +0000 (GMT)
Received: from pps.filterd
 (phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1])
 by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2)
 with ESMTP id 53NMfDKo013816
 for <bug-gnu-emacs@HIDDEN>; Wed, 23 Apr 2025 22:43:14 GMT
Received: from nam12-mw2-obe.outbound.protection.outlook.com
 (mail-mw2nam12lp2042.outbound.protection.outlook.com [104.47.66.42])
 by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id
 466jxpgad1-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK)
 for <bug-gnu-emacs@HIDDEN>; Wed, 23 Apr 2025 22:43:13 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=c1zaOvxf2KvKMd5HRZtfJwWJyGigbEWK7gUqvW3tcTFY/z1T1J9/Eb7c1BFXLmxz3DYq6TkoayFw2paHKGugVx8U34+ZGd8Bc38Ud5CSVJya12LRTMin7qAXYhXlbnqLD1hnXIeT/LddAUvHduwi7MPYGmvbKAg6xFer1fZTOTqDVG3mahjpBtzSm83ISouvz+2kmbjI4nx9bXC132BYpt9B5wmxjEMdFqqBB+ClmEXodvV4RJMHuCjM3ghb2yPUmpW2qhQ5i5viwqVGKDkp5IM4G2Smm8/yWvwfi4b0PJ561NB4mGoUmHU74t3Xm+dkhUmo31lAGX1GhYFTkcU1Xg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=TfPQMCk6ZYOB+UTNggR8eyQXGaYsw71jhgZsMP+J71s=;
 b=YEU/T/FJQfrFZxpLIgP9GP8MGwJ9Om8t4DtBinHp1EYVwj1F/nwzaD3zmD0nuwZlc+E+ZoBBSCO4FYgnpPDzMiCCrq05vOTLZF+X1Bm+186X2qnqY58MNXQV8dAQf1qmU9NOfRDiCwrlHu1rkL44eInleTrxRnVlKTd0Fx/fmmGdtpK9L/bOjV5N4Xf3qCRTjmfM2SkVq8LSVGcZKuNiRh4bkSwTPoQD6Vbwyn5CYUfOcE5MpEIVC8s0eG83XIlr92e7wPxwLiyGFaFoNxCokLk45OltuscyaV0AVnNs8FaiVrsDqMEjcpqZBlsXBlQU8F6p1yWV/MX91nfRX2CbPw==
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=TfPQMCk6ZYOB+UTNggR8eyQXGaYsw71jhgZsMP+J71s=;
 b=jERihRIWN5gVMjLGM+lOe/QMLBSX0PEM0wFeVWu6YBqd3NIDQPR3N5XZdDZHOZYrzh6LTES7k5uFHKloMhTsZI2q58D74WRe9lxbO8+l3hdtUfkRB4/kR/pKgJGqbKTExpzW4k+thajz4PDY634jIbrAdSvI5Bx1iS/D0xSD3sg=
Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24)
 by SA1PR10MB6662.namprd10.prod.outlook.com (2603:10b6:806:2b6::21) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8655.36; Wed, 23 Apr
 2025 22:42:50 +0000
Received: from DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com
 ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.031; Wed, 23 Apr 2025
 22:42:49 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: "bug-gnu-emacs@HIDDEN" <bug-gnu-emacs@HIDDEN>
Subject: 30.1; Unclear sentence in (emacs)Matching
Thread-Topic: 30.1; Unclear sentence in (emacs)Matching
Thread-Index: Adu0oODhIb2na5FKR8GqeizZLTetiA==
Date: Wed, 23 Apr 2025 22:42:49 +0000
Message-ID: <DS7PR10MB5232E5F21321C3DE85A4B7E5F3BA2@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|SA1PR10MB6662:EE_
x-ms-office365-filtering-correlation-id: dfdc0be8-2dc1-428d-d00b-08dd82b82cf9
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0; ARA:13230040|366016|1800799024|376014|38070700018;
x-microsoft-antispam-message-info: =?us-ascii?Q?HZIjk06wYePnoQDJQTwZ8+U1jyntUWjBJYKel5ldq3tsN4eXSmg2NlaMkINL?=
 =?us-ascii?Q?M4aGiWWhsr3itv/ljMJPRYyTGq+csEFEQuZmBBR+SoFpTkIP+VXSPM6/G0K1?=
 =?us-ascii?Q?BU1HqP76F02c6rxDI7s4EFSJVB1PCGyGTVp3rCUyhaUyrFydX6Ryij+Bfq04?=
 =?us-ascii?Q?diLgKQxBzvPz1u8eGFSF6yLHAbtND/N7UGJrztAmyuzyFmAhgbvfuIWp47TT?=
 =?us-ascii?Q?jjsI7ohdHgorvOuhaxK/y12vRb+JtAFLcDTYe/7LNI+CAAs0njuq/JctZ7TY?=
 =?us-ascii?Q?7fKmKSdxozFXtCk/TxeotNqnNcpUd5GWNl8gtMPBjUJ6DiMsp2NdiIYcTqOg?=
 =?us-ascii?Q?pK7cnAc07vI3kPH4cM/7u9gpCm7C41a91TQnTJBIfAdQE+rPfn6NPHRHJpen?=
 =?us-ascii?Q?XjjksF0YIVMgn3NgN/3xwt8RyWfKmRiJZ42ikc5ttSIp2ZQjZKLSfJk5H2Cy?=
 =?us-ascii?Q?4IshrApAc4PPVZbyFD3STcrAhZNS7cR2O+apB/2wYuSxz8A0h1dlR2jtlfRT?=
 =?us-ascii?Q?pFnEfjiT0bc9ACSkZhR+GExgYP+Pju0GK8loAp9HtsiNDqt702md2mQubj+u?=
 =?us-ascii?Q?h5Tc2RAFTp5HAPjonRxdqXTodnjqw6Adwp7OHuheYMRdbIm/+wy1J8Yl5kUa?=
 =?us-ascii?Q?HvVBeoCvn7RSU3OLMqZovN5qUhRUrkmibn2ce2WqHnsUSbaLjpar4MrRtPDY?=
 =?us-ascii?Q?XSqOC0DJtDzvQ9ETEkjglyp2yBl5Wx49xIfZVhmDlroslLREwHrP+wdY+60D?=
 =?us-ascii?Q?DYwsc4LvbnQnWRoClKmSDIU06mdF1m/gC+NI/KCCqUDelgtEFkbFimi/Uo7s?=
 =?us-ascii?Q?btKSX23JWz7gQqKo2pFqiY0WGXZn62buJuOoxep8SEnOJ20FP6P74KkuRcPu?=
 =?us-ascii?Q?iBuGXzKo/utu1jsAzDKNgwq2jAL2etf6jDXqCcOGcm7duMaRR6Q8q0LFhApw?=
 =?us-ascii?Q?dKhwqKrDXcS87KDWy0lM8vapgNnsn7sxuKoXk8MLsfYPDX3BJ3pZ3AzA42RS?=
 =?us-ascii?Q?6D7THTfQXvhozUxJBlRPQadgZ99y3CT3fHDdAOK4EYf881TuNvKWMAz0lasz?=
 =?us-ascii?Q?abSDD07SKlvBBb1iPu5CFlKaLgQwVeoC7hbOBinj4NQM9kOs3TF8MePAdcN1?=
 =?us-ascii?Q?0QsVDbHegdH5dL5lW33s4VMnDmaw7WhLHbZonfNRs2tK5FFyiXSHT17P2GPP?=
 =?us-ascii?Q?UUHWZqWUr/kJtu4RHWMmSUAhcpTJtsoJwKvseSu2nwXtiNUWHlV6TXMaBDsl?=
 =?us-ascii?Q?BVm2mBmScR2ow8Ya306NON3QTUTJMbGPyJzNw/xn29IdDnkmSh+rnj9sCbAV?=
 =?us-ascii?Q?4iwUQhC9Ei0yWR57lMeTQA9qOZJJJ6sLeIzgSFuFLWZSXLLJbq5EboBn/kDR?=
 =?us-ascii?Q?ULOFGKB3BaQaMb1fQeeWOIbaN35Y5kVqi5xjF1FvaQAK0M2B9mnHTpFGZupQ?=
 =?us-ascii?Q?S06h+/y5jWf6x9TwNlJxEVQB4/LkO6XQKo4k+PRFGtwyKu14QxexwA=3D=3D?=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(13230040)(366016)(1800799024)(376014)(38070700018); DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?GAmir1G4tqKzbqaLq1wW9XvE14ST16bXpCAQZm4w8FmwTcrwO5TPg3UCgSD+?=
 =?us-ascii?Q?9a1SGl8OLX2+0hEOS1ed8mrCNHl1hkFP7/WTzAdiUSeOOM0C9ZMWLXBuWMxR?=
 =?us-ascii?Q?ChelsnObqzQuITwzxPhAePe4Bh63Hs1oN1+UiHmqDHTvHVONKmruEUZwvPo3?=
 =?us-ascii?Q?Mg/IuHmaPHi/F0NnXIHohCAcKIUly+TESFV+uJ6xZhNA0xw7IViw9CwcVSjy?=
 =?us-ascii?Q?gzgT3C1e/2vRNduwsdFNbj75CzRKPF8ZPQJ/KKjk32PNFPcyN88fxpaNx9J1?=
 =?us-ascii?Q?diINnOYRRCXKejJ0AonO5rGRJ+VwOhQ/cnmllVqxbhHsjezuFIIZ2gazKw/j?=
 =?us-ascii?Q?+vMAkqq9R9jeptLmwHdY0TDegspXgVyH1RdMz3WhDY/Jch4Nd4kbA9nAjXaT?=
 =?us-ascii?Q?7INfXZhIWSTv9VwCJ3S2K+i8vzl4Fa23E+DN6SI3dUhNADZ0PzjT8oMS29RS?=
 =?us-ascii?Q?BfKmm91bF0KASbBzm+xsY/pxXOkppUyueps1EKk6K621BHZ7Z5keOhW8qIAx?=
 =?us-ascii?Q?jTAB+91W+6nGUJpLhB3zvMafxMnqsM6cmJBkJp7LC2ydHQhbFH2nLII3XkXR?=
 =?us-ascii?Q?fj+KjUCZpOlF313ZFo8su/J9/BwiX+ij7gC1iCqoMiVb0FahEN+oHuhVxdiP?=
 =?us-ascii?Q?SPDFR0Ukaeg4WAKqrJTt2KU31NzZmqZR5e9LMJR02qtAnLHqWUGpUR4g89UH?=
 =?us-ascii?Q?UxEPiqvbvrGB5VYung//IwRNKnWTCy3enjjO3UIq5XsZnm45gtD/9Q6G0qgz?=
 =?us-ascii?Q?fsQXbP1lD4MjzvXOEGT1b1+5AF5EIpoI3RuZxTgqh/BdJ7jQCEo+BQDnzYUw?=
 =?us-ascii?Q?QuL+ChdLLRxmmgbjdeyiVt4l+feRlsPnhl9IRxAnjkCUUjQqG0G8/Wt+Bzev?=
 =?us-ascii?Q?YacEqWrB17QXfwkjAgklZ5ohabFHsf0pIgBe2o7x5s2z3TX8hZ0kEp73BnTI?=
 =?us-ascii?Q?wA2CY1GBCQ1/h3O0lanE1VNz5paOMKrLOmO3FenCbh1ktofEiSmfT7PcRjyt?=
 =?us-ascii?Q?1ezWEMGRJDecHKPmkSnUmZ2G/ihBasZe4C4F8GsqI/jemmTr1Ph8VHcWkoYX?=
 =?us-ascii?Q?aDQ9jG3aKortEne7ATKzEfujtv7nw/orkbCcmwQqqHUgLp5mCiL5Cv0VLTXx?=
 =?us-ascii?Q?hkMpQMtPyWDdFe8u4Ji2XMc3X+KDLZpOIfkoTGKsO/l13sPIG4GLqIwm3Ck/?=
 =?us-ascii?Q?potcsB81V4paEvRuDx7RnHv0qV9E0wUvpa3rLCcmXNPPes3PhS8qJ86ZcHyn?=
 =?us-ascii?Q?jPpehDwr1/yKI69lhjvaKzj3C317FZzATAnqI4iAU5eER76GT+XlWhrqYfI/?=
 =?us-ascii?Q?TFCrd34u8tYAzLF6Rd2S/vR35Him9sOBpYO5Z4Bwssc4CjlJGqpxSly5LweF?=
 =?us-ascii?Q?CK77/sPjWHY/bd8Ux8A3t+qfwB+FPiz0Ij7BoLFVXLZEgQ0f6b+iOw8diSk0?=
 =?us-ascii?Q?MVP+sgShNOlni9pxkPN13ezWeXrCPUYfXlmcNQuUK0XagWi8sO2cp/o48KtA?=
 =?us-ascii?Q?Q4XyK/2LeFjB/zL3gCYUZFXWdLfbUBOkP8CyduKPVJPSPiKRqrWc+zEtCNCj?=
 =?us-ascii?Q?1kNTSoU0LG1imVXr2ASfeQPhHY3rcC2PSrcdqNfq?=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: kBPavljEugkvbFZb1az36UmGVF6y4aTZgA7kaElXPAoX23aH4DdID/LGxsTguOReLgvBqtLWFnDd7NzHUxUmHGGc5dq7ipa1LNSTJTrA9kmSXzNedSNsqxPyOBQPe2k0/hKGfhS6vNOcTz8mij4UXfW3A7ZNGYIoWmgPzipE0FDzBKT5a5mQouprxGDudWBIlLcER9C59vTnfBu703Y/50eRwE3koHRWhqLdTOdfSh8ksSQ1NVqnbGTT6e3yBqPyD1PIVvABoxPnRcBG6LZPlXc1LTkr5QyAfpAkRm9y3SFoxG9NU3aMzXxl+a8fX+Ja6YdjGmHELYSFMWQRW11yBbdtLF+ZheoBBVE6OSJPj9QmkA8L9aQzQkPvUO/Te3oKr0aPWlpWik6dsuwYBGVz1qsLQmztJNGV3KHf2r/CTy0Ot2sM/KBn4MIsOELNu8bdZR7iXIt5mZuXlpUgGBvHkdBIF5KTp3lxYQ0GsFdp5jIT59b5vksbf+qeGZhRAcq2to4x80RxWxgndASNadxNXMf3yz6D9/h52kZusGpOdFT7Z+knQu6Hd4pbg0/+A0DNS1weHmng0praVv9jnsw9Zul4Fb+bz2xndwjeZPbfrFo=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: dfdc0be8-2dc1-428d-d00b-08dd82b82cf9
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Apr 2025 22:42:49.6279 (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: S4I+rPwyQPXniQVNFkYxZ+hA9cDskVyHpinqNmBEMdZprt+K7+VO9dLQomogM+gRwYLP9uF+44xNOmovyH3YaQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR10MB6662
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.680,FMLib:17.12.80.40
 definitions=2025-04-23_12,2025-04-22_01,2025-02-21_01
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0
 mlxscore=0 adultscore=0
 phishscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 spamscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2504070000
 definitions=main-2504230151
X-Proofpoint-GUID: zTYoKsLBqwGBBDrfe9uiCS0J-Jz1Y-lW
X-Proofpoint-ORIG-GUID: zTYoKsLBqwGBBDrfe9uiCS0J-Jz1Y-lW
X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDIzMDE1MSBTYWx0ZWRfX4u1zjrAop8uO
 jjWOWPvheRrvQg9yv9Vde05hbuRJISeYHKD5KLNmgkQiVl5F48pxed/B2GI7SAdZ0HCR7T4AVQT
 32RPCLtZKnZrf9jSQ1JvAHBVYmywr2s3PoRurT/mJL4P5DgQ/Jx9Ci1Sj9Awjhzva4Cad6p4SqI
 cBEEBVaR7+vuQ+3PP2S+LJljEqHPl9PyyEfd/p4ga8LbphOmOdopwOdPA8w4h7upsO0BzFW4Akl
 jA34Bg413Nch5SRSEP6tFsEUcSW4ZVvkzmfHulzuceMjdR42bRQdE41JI7qTO68w4Ka5x1kq1OD
 ipImaCXvPF8+vgIDj7z+ZT8+CgtPRWd/8K9ltMnlkcQLXn6w0YcBP0SJcKcCocX3Cj+8PPGxtTH
 QMxe+aVv
Received-SPF: pass client-ip=205.220.165.32;
 envelope-from=drew.adams@HIDDEN; 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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001,
 RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001,
 SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 1.0 (+)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.0 (/)

In (emacs)Matching (not a great name for the node abbreviation, BTW),
this sentence is unclear:

  "Conversely, when you insert a closing delimiter over an existing one,
   No insertion takes places, and that position is simply skipped over."

What does it mean to insert a closing delimiter "over an existing one"?
No idea what this is trying to say, or why it's deemed the "converse" of
what happens when you insert an opening delimiter.

Presumably it should include something about what happens to the
"existing" closing delimiter, and something about point, if it hopes to
convey the converse behavior.

In GNU Emacs 30.1 (build 2, x86_64-w64-mingw32) of 2025-02-23 built on
 AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.26100
System Description: Microsoft Windows 10 Pro (v10.0.2009.26100.3775)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation=3Daot
 --without-compress-install --with-tree-sitter CFLAGS=3D-O2
 prefix=3D/g/rel/install/emacs-30.1'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG LCMS2 LIBXML2 MODULES NATIVE_COMP
NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB

(NATIVE_COMP present but libgccjit not available)

Important settings:
  value of $LANG: ENU
  locale-coding-system: cp1252





Acknowledgement sent to Drew Adams <drew.adams@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#78021; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Tue, 29 Apr 2025 17:30:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.