From unknown Fri Jun 20 07:08:56 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#30502 <30502@debbugs.gnu.org> To: bug#30502 <30502@debbugs.gnu.org> Subject: Status: 26.0.91; electric-pair-mode documentation Reply-To: bug#30502 <30502@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:08:56 +0000 retitle 30502 26.0.91; electric-pair-mode documentation reassign 30502 emacs submitter 30502 charles@aurox.ch (Charles A. Roelli) severity 30502 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 17 10:58:34 2018 Received: (at submit) by debbugs.gnu.org; 17 Feb 2018 15:58:34 +0000 Received: from localhost ([127.0.0.1]:48466 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en4sk-0007KB-AA for submit@debbugs.gnu.org; Sat, 17 Feb 2018 10:58:34 -0500 Received: from eggs.gnu.org ([208.118.235.92]:46254) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en4si-0007Jw-Cw for submit@debbugs.gnu.org; Sat, 17 Feb 2018 10:58:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1en4sc-0005tL-4k for submit@debbugs.gnu.org; Sat, 17 Feb 2018 10:58:27 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:38914) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1en4sc-0005tF-1A for submit@debbugs.gnu.org; Sat, 17 Feb 2018 10:58:26 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:37217) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1en4sb-0003zI-1m for bug-gnu-emacs@gnu.org; Sat, 17 Feb 2018 10:58:25 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1en4sW-0005sA-6x for bug-gnu-emacs@gnu.org; Sat, 17 Feb 2018 10:58:25 -0500 Received: from [2a03:2040:2:1b::1] (port=32784 helo=sinyavsky.aurox.ch) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1en4sV-0005oY-VG for bug-gnu-emacs@gnu.org; Sat, 17 Feb 2018 10:58:20 -0500 Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id 2F1E522690 for ; Sat, 17 Feb 2018 15:58:35 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass (1024-bit key) reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= subject:subject:to:from:from:message-id:date:date; s=dkim; t= 1518883114; x=1519747115; bh=LlnHbzCbpp/FRlg8dwn92xeKbFUaqZPuwdc Ltmatxmc=; b=hY6XmZSL6jgOxdwNhJC5AfiVKLzNFAMAMiDNh9H006oxjRvYHO0 WqnIcnAhMsbhyEuF9FTh9ju/nmHFQoiqakhyUOhkHiM4A0csIjUc4ZtdXsoNyC3K RmmWJsWPxQYMw87DGq/U6o4KE4Mo8ebKhEszo7dhKw/1a+4zSBDLeJWA= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id oGiMK5eJweXi for ; Sat, 17 Feb 2018 15:58:34 +0000 (UTC) Received: from gray (125.85.192.178.dynamic.wline.res.cust.swisscom.ch [178.192.85.125]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id 258A62264C for ; Sat, 17 Feb 2018 15:58:34 +0000 (UTC) Date: Sat, 17 Feb 2018 17:07:53 +0100 Message-Id: From: charles@aurox.ch (Charles A. Roelli) To: bug-gnu-emacs@gnu.org Subject: 26.0.91; electric-pair-mode documentation X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.1 (----) When you turn on electric-pair-mode from emacs -q, then select a region and type an opening delimeter like "(", the region is surrounded by the "(" and ")" characters, the mark is deactivated, and point is left after the opening delimeter. This should be documented. (I searched for documentation but have not found any.) Also, this functionality requires transient-mark-mode to be on. Are there any equivalent "wrapping" commands for use when transient-mark-mode is off? If not, maybe we should add some. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 17 11:21:27 2018 Received: (at 30502) by debbugs.gnu.org; 17 Feb 2018 16:21:27 +0000 Received: from localhost ([127.0.0.1]:48505 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en5Er-0007xh-Ce for submit@debbugs.gnu.org; Sat, 17 Feb 2018 11:21:26 -0500 Received: from eggs.gnu.org ([208.118.235.92]:51660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en5Ep-0007xS-3M for 30502@debbugs.gnu.org; Sat, 17 Feb 2018 11:21:23 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1en5Eg-0000hq-MJ for 30502@debbugs.gnu.org; Sat, 17 Feb 2018 11:21:17 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54931) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1en5Eg-0000hm-Ie; Sat, 17 Feb 2018 11:21:14 -0500 Received: from [176.228.60.248] (port=4090 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1en5Eg-0001rj-0G; Sat, 17 Feb 2018 11:21:14 -0500 Date: Sat, 17 Feb 2018 18:21:16 +0200 Message-Id: <83r2pjbn9f.fsf@gnu.org> From: Eli Zaretskii To: charles@aurox.ch (Charles A. Roelli) In-reply-to: (charles@aurox.ch) Subject: Re: bug#30502: 26.0.91; electric-pair-mode documentation References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30502 Cc: 30502@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Sat, 17 Feb 2018 17:07:53 +0100 > From: charles@aurox.ch (Charles A. Roelli) > > When you turn on electric-pair-mode from emacs -q, then select a > region and type an opening delimeter like "(", the region is > surrounded by the "(" and ")" characters, the mark is deactivated, and > point is left after the opening delimeter. This should be documented. > (I searched for documentation but have not found any.) Which part of this is undocumented? Did you see the description of Electric pair mode in the "Matching" node of the user manual? > Also, this functionality requires transient-mark-mode to be on. I don't see it. I can turn off transient-mark-mode, and the feature still works. Maybe I don't understand what you mean by "this functionality"? Thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 17 11:42:17 2018 Received: (at 30502) by debbugs.gnu.org; 17 Feb 2018 16:42:17 +0000 Received: from localhost ([127.0.0.1]:48522 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en5Z3-0008Sv-Ar for submit@debbugs.gnu.org; Sat, 17 Feb 2018 11:42:17 -0500 Received: from sinyavsky.aurox.ch ([37.35.109.145]:45782) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en5Z1-0008Sh-4e for 30502@debbugs.gnu.org; Sat, 17 Feb 2018 11:42:15 -0500 Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id EFFE422697 for <30502@debbugs.gnu.org>; Sat, 17 Feb 2018 16:42:26 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass (1024-bit key) reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= references:subject:subject:in-reply-to:to:from:from:message-id :date:date; s=dkim; t=1518885745; x=1519749746; bh=R4dJSxkItqG8m 4pw9DBjlga2jCCW1CobzyISW82tgJo=; b=U7TENwKRWRYpkOeMdNvF7QZguN6eP pV9EfLJYWnC8v7hzJwMs5cFHmZsm5bkizxit8/bJkuUOuW7MxwAd/urYzvaBjO/+ J9EefXVsvn7WXcIoJWQz9FoCElUUKfqqIsXWwE8ovMzVeSa2ycdSM2L0aM8R0sVU ekYstyk1Y8JvUM= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id os9Hi3pDswcC for <30502@debbugs.gnu.org>; Sat, 17 Feb 2018 16:42:25 +0000 (UTC) Received: from gray (125.85.192.178.dynamic.wline.res.cust.swisscom.ch [178.192.85.125]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id A711A2264C; Sat, 17 Feb 2018 16:42:25 +0000 (UTC) Date: Sat, 17 Feb 2018 17:51:45 +0100 Message-Id: From: charles@aurox.ch (Charles A. Roelli) To: Eli Zaretskii In-reply-to: <83r2pjbn9f.fsf@gnu.org> (message from Eli Zaretskii on Sat, 17 Feb 2018 18:21:16 +0200) Subject: Re: bug#30502: 26.0.91; electric-pair-mode documentation References: <83r2pjbn9f.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 30502 Cc: 30502@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > Date: Sat, 17 Feb 2018 18:21:16 +0200 > From: Eli Zaretskii > CC: 30502@debbugs.gnu.org > Reply-to: Eli Zaretskii > > > Date: Sat, 17 Feb 2018 17:07:53 +0100 > > From: charles@aurox.ch (Charles A. Roelli) > > > > When you turn on electric-pair-mode from emacs -q, then select a > > region and type an opening delimeter like "(", the region is > > surrounded by the "(" and ")" characters, the mark is deactivated, and > > point is left after the opening delimeter. This should be documented. > > (I searched for documentation but have not found any.) > > Which part of this is undocumented? Did you see the description of > Electric pair mode in the "Matching" node of the user manual? Yes, I did. The node does not mention anything about automatically inserting a matching delimeter at the mark when the region is active and a delimeter character is typed. For example, it could say, Whenever you insert an opening delimiter, the matching closing delimiter is automatically inserted as well (at the mark, if the region is active), leaving point between the two. instead of, Whenever you insert an opening delimiter, the matching closing delimiter is automatically inserted as well, leaving point between the two. > > Also, this functionality requires transient-mark-mode to be on. > > I don't see it. I can turn off transient-mark-mode, and the feature > still works. Maybe I don't understand what you mean by "this > functionality"? By "this functionality" I mean auto-inserting a matching delimeter at the mark when a delimeter character is typed, when electric-pair-mode is on. The region has to be active for this to work, therefore transient-mark-mode must be on (even if temporarily). I suggest adding a command that wraps point and mark with some given delimeters, regardless of whether the region is active. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 17 12:31:52 2018 Received: (at 30502) by debbugs.gnu.org; 17 Feb 2018 17:31:52 +0000 Received: from localhost ([127.0.0.1]:48566 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en6L2-0001Hs-60 for submit@debbugs.gnu.org; Sat, 17 Feb 2018 12:31:52 -0500 Received: from eggs.gnu.org ([208.118.235.92]:41022) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en6L0-0001Hc-JH for 30502@debbugs.gnu.org; Sat, 17 Feb 2018 12:31:50 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1en6Kr-0000Tr-EM for 30502@debbugs.gnu.org; Sat, 17 Feb 2018 12:31:45 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56078) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1en6Kr-0000Tn-9z; Sat, 17 Feb 2018 12:31:41 -0500 Received: from [176.228.60.248] (port=4170 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1en6Kq-000578-Kb; Sat, 17 Feb 2018 12:31:41 -0500 Date: Sat, 17 Feb 2018 19:31:42 +0200 Message-Id: <83mv07bk01.fsf@gnu.org> From: Eli Zaretskii To: charles@aurox.ch (Charles A. Roelli) In-reply-to: (charles@aurox.ch) Subject: Re: bug#30502: 26.0.91; electric-pair-mode documentation References: <83r2pjbn9f.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30502 Cc: 30502@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Sat, 17 Feb 2018 17:51:45 +0100 > From: charles@aurox.ch (Charles A. Roelli) > CC: 30502@debbugs.gnu.org > > The node does not mention anything about automatically > inserting a matching delimeter at the mark when the region is active > and a delimeter character is typed. Thanks, I documented that now. In the doc string of the mode as well. > By "this functionality" I mean auto-inserting a matching delimeter at > the mark when a delimeter character is typed, when electric-pair-mode > is on. The region has to be active for this to work, therefore > transient-mark-mode must be on (even if temporarily). I suggest > adding a command that wraps point and mark with some given delimeters, > regardless of whether the region is active. We have "C-u C-x C-x" that turns on transient-mark-mode temporarily. Isn't that enough? If not, the issue is general, not specific to this mode. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 17 14:51:29 2018 Received: (at 30502-done) by debbugs.gnu.org; 17 Feb 2018 19:51:29 +0000 Received: from localhost ([127.0.0.1]:48656 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en8W9-0004xs-2U for submit@debbugs.gnu.org; Sat, 17 Feb 2018 14:51:29 -0500 Received: from sinyavsky.aurox.ch ([37.35.109.145]:45946) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1en8W7-0004xg-Kc for 30502-done@debbugs.gnu.org; Sat, 17 Feb 2018 14:51:28 -0500 Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id F203122697 for <30502-done@debbugs.gnu.org>; Sat, 17 Feb 2018 19:51:39 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass (1024-bit key) reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= references:subject:subject:in-reply-to:to:from:from:message-id :date:date; s=dkim; t=1518897099; x=1519761100; bh=zLHGvPWOY8MpW A2iDDQ/TG0NFHDpc6qhG6sZly9YOwQ=; b=M0qF03ap3wKy42aPH8kb8zDy8UEVF sAEzLkqJ5busa/h6/R4qTEbM9nRjzMAK073otWxSsShXRmvTHl20txfSd4xxDs/2 9TyQn1Zo7ugRZiV2GUEsFEbK9E9cXoPONkCKnZz0psru+82UwQi3kVG6QfmWEwrv a5Cb0z7odbtHsg= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id gHuJMmC1pC7R for <30502-done@debbugs.gnu.org>; Sat, 17 Feb 2018 19:51:39 +0000 (UTC) Received: from gray (125.85.192.178.dynamic.wline.res.cust.swisscom.ch [178.192.85.125]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id DF9AE2264C; Sat, 17 Feb 2018 19:51:38 +0000 (UTC) Date: Sat, 17 Feb 2018 21:00:58 +0100 Message-Id: From: charles@aurox.ch (Charles A. Roelli) To: Eli Zaretskii In-reply-to: <83mv07bk01.fsf@gnu.org> (message from Eli Zaretskii on Sat, 17 Feb 2018 19:31:42 +0200) Subject: Re: bug#30502: 26.0.91; electric-pair-mode documentation References: <83r2pjbn9f.fsf@gnu.org> <83mv07bk01.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 30502-done Cc: 30502-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > Date: Sat, 17 Feb 2018 19:31:42 +0200 > From: Eli Zaretskii > > Thanks, I documented that now. In the doc string of the mode as well. Thanks a lot for the improvement. With that, I'll close this bug. > > By "this functionality" I mean auto-inserting a matching delimeter at > > the mark when a delimeter character is typed, when electric-pair-mode > > is on. The region has to be active for this to work, therefore > > transient-mark-mode must be on (even if temporarily). I suggest > > adding a command that wraps point and mark with some given delimeters, > > regardless of whether the region is active. > > We have "C-u C-x C-x" that turns on transient-mark-mode temporarily. > Isn't that enough? If not, the issue is general, not specific to this > mode. "C-u C-x C-x" does work well enough, but Emacs normally also provides commands that explicitly do some subset of what a region-aware command would do in the same situation. For example, if you want to comment out the region with transient-mark-mode switched off, you can either type: C-u C-x C-x [exchange-point-and-mark] M-; [comment-dwim] or more memorably, clearly, and without moving point, M-x comment-region RET I like having both options available, but the latter is preferable IMO. Hence we could have some command that would be used like, M-x wrap-region RET ( RET to wrap a region explicitly. From unknown Fri Jun 20 07:08:56 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 18 Mar 2018 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator