From unknown Sun Jun 15 08:48:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Feb 2015 21:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 19841 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 19841@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.14236903668267 (code B ref -1); Wed, 11 Feb 2015 21:33:02 +0000 Received: (at submit) by debbugs.gnu.org; 11 Feb 2015 21:32:46 +0000 Received: from localhost ([127.0.0.1]:40360 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YLetp-00029H-OY for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:46 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60478) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YLetn-000294-Kz for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YLeth-00039f-HF for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:38 -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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:50918) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLeth-00039b-DH for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:37 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33967) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLetg-0001BT-C7 for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:37 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YLetd-00039P-68 for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:36 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:40400) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLetc-00039K-Vu for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:33 -0500 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1BLWUhH013503 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 11 Feb 2015 21:32:31 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id t1BLWTFq006234 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 11 Feb 2015 21:32:30 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t1BLWTQv000459 for ; Wed, 11 Feb 2015 21:32:29 GMT MIME-Version: 1.0 Message-ID: <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> Date: Wed, 11 Feb 2015 13:32:24 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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.0 (----) Please update the doc string, the Emacs manual, node `Disabled Transient Mark', and the Elisp manual, node `The Mark'. While you're at it, please so likewise for the Elisp manual node `The Region'. (At least Emacs manual node `Mark' mentions it.) It is not obvious to users which face they can customize to change the `transient-mark-mode' highlighting. This thread is one indication of the need for this improvement: http://lists.gnu.org/archive/html/help-gnu-emacs/2015-02/msg00236.html In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1' From unknown Sun Jun 15 08:48:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 13 Feb 2015 09:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19841 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 19841@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 19841-submit@debbugs.gnu.org id=B19841.14238188631289 (code B ref 19841); Fri, 13 Feb 2015 09:15:02 +0000 Received: (at 19841) by debbugs.gnu.org; 13 Feb 2015 09:14:23 +0000 Received: from localhost ([127.0.0.1]:41330 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMCKN-0000Kj-7J for submit@debbugs.gnu.org; Fri, 13 Feb 2015 04:14:23 -0500 Received: from mtaout25.012.net.il ([80.179.55.181]:33680) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMCKL-0000KV-5b for 19841@debbugs.gnu.org; Fri, 13 Feb 2015 04:14:22 -0500 Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NJP00M00D80RL00@mtaout25.012.net.il> for 19841@debbugs.gnu.org; Fri, 13 Feb 2015 11:09:03 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NJP00K4CDF39O30@mtaout25.012.net.il>; Fri, 13 Feb 2015 11:09:03 +0200 (IST) Date: Fri, 13 Feb 2015 11:14:11 +0200 From: Eli Zaretskii In-reply-to: <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> X-012-Sender: halo1@inter.net.il Message-id: <83oaoy41i4.fsf@gnu.org> References: <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> X-Spam-Score: 1.0 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: 1.0 (+) > Date: Wed, 11 Feb 2015 13:32:24 -0800 (PST) > From: Drew Adams > > Please update the doc string, the Emacs manual, node `Disabled Transient > Mark', and the Elisp manual, node `The Mark'. > > While you're at it, please so likewise for the Elisp manual node `The > Region'. (At least Emacs manual node `Mark' mentions it.) > > It is not obvious to users which face they can customize to change the > `transient-mark-mode' highlighting. > > This thread is one indication of the need for this improvement: > http://lists.gnu.org/archive/html/help-gnu-emacs/2015-02/msg00236.html I added references to the 'region' face to the 2 doc strings, but left the manuals alone. We generally don't mention faces of features where those features are described; instead, there's a "Standard Faces" node in the Emacs manual that documents them all in one place. From unknown Sun Jun 15 08:48:01 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 13 Feb 2015 14:54:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19841 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 19841@debbugs.gnu.org Received: via spool by 19841-submit@debbugs.gnu.org id=B19841.142383918913733 (code B ref 19841); Fri, 13 Feb 2015 14:54:01 +0000 Received: (at 19841) by debbugs.gnu.org; 13 Feb 2015 14:53:09 +0000 Received: from localhost ([127.0.0.1]:41597 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMHcC-0003ZR-W4 for submit@debbugs.gnu.org; Fri, 13 Feb 2015 09:53:09 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:40895) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMHcB-0003ZE-Lh for 19841@debbugs.gnu.org; Fri, 13 Feb 2015 09:53:08 -0500 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1DEr0TA005027 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 13 Feb 2015 14:53:01 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1DEqxhh020007 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 13 Feb 2015 14:53:00 GMT Received: from abhmp0016.oracle.com (abhmp0016.oracle.com [141.146.116.22]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id t1DEqvwj021868; Fri, 13 Feb 2015 14:52:59 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 13 Feb 2015 06:52:56 -0800 (PST) From: Drew Adams References: <<25162aaf-0573-4f31-a4bf-e8b64f8937ed@default>> <<83oaoy41i4.fsf@gnu.org>> In-Reply-To: <<83oaoy41i4.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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 (--) > > Please update the doc string, the Emacs manual, node `Disabled Transien= t > > Mark', and the Elisp manual, node `The Mark'. > > > > While you're at it, please so likewise for the Elisp manual node `The > > Region'. (At least Emacs manual node `Mark' mentions it.) > > > > It is not obvious to users which face they can customize to change the > > `transient-mark-mode' highlighting. > > > > This thread is one indication of the need for this improvement: > > http://lists.gnu.org/archive/html/help-gnu-emacs/2015-02/msg00236.html >=20 > I added references to the 'region' face to the 2 doc strings, but left > the manuals alone. We generally don't mention faces of features where > those features are described; instead, there's a "Standard Faces" node > in the Emacs manual that documents them all in one place. OK, thank you. Wouldn't it be good to xref node Standard Faces for this? The doc string mention is sufficient, but someone reading the manual might not think to also look at the doc string. And in the case of `transient-mark-mode' and the `region' face, the connection is not at all obvious. For some other modes and their faces the names are similar (e.g. if the `region' were called `transient-mark' or something). But for these two, in particular, I think a cross-ref wouldn't hurt. Anyway, feel free to close the bug, and use your judgment about the manuals. I haven't looked at the new doc-string text, but I'm sure it's a big improvement. From unknown Sun Jun 15 08:48:01 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#19841: closed (Re: bug#19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region') Message-ID: References: <83bnkx4zl2.fsf@gnu.org> <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> X-Gnu-PR-Message: they-closed 19841 X-Gnu-PR-Package: emacs Reply-To: 19841@debbugs.gnu.org Date: Fri, 13 Feb 2015 15:11:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1423840263-15629-1" This is a multi-part message in MIME format... ------------=_1423840263-15629-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting= is with face `region' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 19841@debbugs.gnu.org. --=20 19841: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D19841 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1423840263-15629-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 19841-done) by debbugs.gnu.org; 13 Feb 2015 15:10:30 +0000 Received: from localhost ([127.0.0.1]:42037 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMHsz-00043L-KK for submit@debbugs.gnu.org; Fri, 13 Feb 2015 10:10:30 -0500 Received: from mtaout29.012.net.il ([80.179.55.185]:45065) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YMHsw-000436-L5 for 19841-done@debbugs.gnu.org; Fri, 13 Feb 2015 10:10:27 -0500 Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0NJP00K00TWF1E00@mtaout29.012.net.il> for 19841-done@debbugs.gnu.org; Fri, 13 Feb 2015 17:06:24 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NJP00EGFTYODQ50@mtaout29.012.net.il>; Fri, 13 Feb 2015 17:06:24 +0200 (IST) Date: Fri, 13 Feb 2015 17:10:17 +0200 From: Eli Zaretskii Subject: Re: bug#19841: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region' In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83bnkx4zl2.fsf@gnu.org> References: <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> <83oaoy41i4.fsf@gnu.org> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 19841-done Cc: 19841-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii 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: 1.0 (+) > Date: Fri, 13 Feb 2015 06:52:56 -0800 (PST) > From: Drew Adams > Cc: 19841@debbugs.gnu.org > > Wouldn't it be good to xref node Standard Faces for this? I thought about that, but when I looked at the corresponding nodes, it didn't look useful: the nodes are very large, and a single sentence will get lost there. > And in the case of `transient-mark-mode' and the `region' > face, the connection is not at all obvious. The region is mentioned. In any case, I presume a user who wants to find the face will simply go to "Standard Faces". > Anyway, feel free to close the bug Done. ------------=_1423840263-15629-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 11 Feb 2015 21:32:46 +0000 Received: from localhost ([127.0.0.1]:40360 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YLetp-00029H-OY for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:46 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60478) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YLetn-000294-Kz for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YLeth-00039f-HF for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:38 -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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:50918) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLeth-00039b-DH for submit@debbugs.gnu.org; Wed, 11 Feb 2015 16:32:37 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33967) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLetg-0001BT-C7 for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:37 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YLetd-00039P-68 for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:36 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:40400) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YLetc-00039K-Vu for bug-gnu-emacs@gnu.org; Wed, 11 Feb 2015 16:32:33 -0500 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1BLWUhH013503 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 11 Feb 2015 21:32:31 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id t1BLWTFq006234 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 11 Feb 2015 21:32:30 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t1BLWTQv000459 for ; Wed, 11 Feb 2015 21:32:29 GMT MIME-Version: 1.0 Message-ID: <25162aaf-0573-4f31-a4bf-e8b64f8937ed@default> Date: Wed, 11 Feb 2015 13:32:24 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; Doc for `transient-mark-mode' should say that highlighting is with face `region' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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.0 (----) Please update the doc string, the Emacs manual, node `Disabled Transient Mark', and the Elisp manual, node `The Mark'. While you're at it, please so likewise for the Elisp manual node `The Region'. (At least Emacs manual node `Mark' mentions it.) It is not obvious to users which face they can customize to change the `transient-mark-mode' highlighting. This thread is one indication of the need for this improvement: http://lists.gnu.org/archive/html/help-gnu-emacs/2015-02/msg00236.html In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1' ------------=_1423840263-15629-1--