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.
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: Fri, 25 Apr 2025 14:00:05 UTC

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