From unknown Fri Aug 15 04:06:49 2025 X-Loop: don@donarmstrong.com Subject: bug#1185: 23.0.60; Doc string of region-active-p considered unhelpful Reply-To: Eli Zaretskii , 1185@debbugs.gnu.org Resent-From: Eli Zaretskii Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Thu, 16 Oct 2008 19:50:03 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1185 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12241862103384 (code B ref -1); Thu, 16 Oct 2008 19:50:03 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.6 required=4.0 tests=AWL,BAYES_00,FOURLA, RCVD_IN_DNSWL_MED,RCVD_IN_NIX1 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 16 Oct 2008 19:43:30 +0000 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m9GJhQor003378 for ; Thu, 16 Oct 2008 12:43:27 -0700 Received: from mail.gnu.org ([199.232.76.166]:48754 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1KqYiK-0001Jn-3A for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:40:52 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1KqYkm-00081y-UD for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:43:25 -0400 Received: from mtaout1.012.net.il ([84.95.2.1]:41105) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KqYkm-00081o-Fy for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:43:24 -0400 Received: from HOME-C4E4A596F7 ([77.127.24.3]) by i-mtaout1.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0K8U00C8SK554S30@i-mtaout1.012.net.il> for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 21:43:53 +0200 (IST) Date: Thu, 16 Oct 2008 21:42:28 +0200 From: Eli Zaretskii X-012-Sender: halo1@inter.net.il To: emacs-pretest-bug@gnu.org Message-id: X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the emacs-pretest-bug@gnu.org mailing list. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: "C-h f region-active-p RET" produces the following documentation: Return t if Transient Mark mode is enabled and the mark is active. This is NOT the best function to use to test whether a command should operate on the region instead of the usual behavior -- for that, use `use-region-p'. This is not really helpful: it does not tell why would a Lisp program want to use this function. Are there any circumstances where this function is useful, or do we keep it for compatibility reasons? If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file d:/gnu/emacs/etc/DEBUG for instructions. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-10-16 on HOME-C4E4A596F7 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: ENU value of $XMODIFIERS: nil locale-coding-system: cp1255 default-enable-multibyte-characters: t Major mode: Emacs-Lisp Minor modes in effect: tooltip-mode: t tool-bar-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: C-h f r u e s e - r e g C-x o C-s C-w C-w C-w C-s C-s C-r C-r C-r C-x C-f a l l C-s u s e - r e g C-x C-f - 2 2 - e m / l i s / a l l C-s m a r k - a C-x b s i m p M-x r e p o r t - e Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Type C-x 1 to delete the help window. Loading vc-cvs...done Mark saved where search started Making completion list... Mark saved where search started From unknown Fri Aug 15 04:06:49 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: don@donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: Eli Zaretskii Subject: bug#1185 closed by Chong Yidong (23.0.60; Doc string of region-active-p considered unhelpful) Message-ID: References: <87d4htswuv.fsf@cyd.mit.edu> X-Emacs-PR-Message: they-closed 1185 X-Emacs-PR-Package: emacs Reply-To: 1185@debbugs.gnu.org Content-Type: multipart/mixed; boundary="----------=_1224609004-12558-1" This is a multi-part message in MIME format... ------------=_1224609004-12558-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #1185: 23.0.60; Doc string of region-active-p considered unhelpful It has been closed by Chong Yidong . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Chong Yidong by replying to this email. --=20 1185: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D1185 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1224609004-12558-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >From cyd@stupidchicken.com Tue Oct 21 10:04:41 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-3.9 required=4.0 tests=AWL,BAYES_00 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 1185-done) by emacsbugs.donarmstrong.com; 21 Oct 2008 17:04:41 +0000 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m9LH4cxb010582 for <1185-done@emacsbugs.donarmstrong.com>; Tue, 21 Oct 2008 10:04:39 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 440FF57E0BD; Tue, 21 Oct 2008 13:04:40 -0400 (EDT) From: Chong Yidong To: Eli Zaretskii Cc: 1185-done@debbugs.gnu.org Subject: 23.0.60; Doc string of region-active-p considered unhelpful Date: Tue, 21 Oct 2008 13:04:40 -0400 Message-ID: <87d4htswuv.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > "C-h f region-active-p RET" produces the following documentation: > > Return t if Transient Mark mode is enabled and the mark is active. > This is NOT the best function to use to test whether a command should > operate on the region instead of the usual behavior -- for that, > use `use-region-p'. > > This is not really helpful: it does not tell why would a Lisp program > want to use this function. Are there any circumstances where this > function is useful, or do we keep it for compatibility reasons? The reason to use use-region-p is because that checks whether the region is empty and compares that with use-empty-active-region. That's what we want for most commands that have the behavior "do X on the region if it's active". But in some circumstances, we don't care about whether or not the region is empty; e.g., some commands want to deactivate the mark if region-active-p is non-nil. I checked in a doc fix. ------------=_1224609004-12558-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >From eliz@gnu.org Thu Oct 16 12:43:30 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.6 required=4.0 tests=AWL,BAYES_00,FOURLA, RCVD_IN_DNSWL_MED,RCVD_IN_NIX1 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 16 Oct 2008 19:43:30 +0000 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m9GJhQor003378 for ; Thu, 16 Oct 2008 12:43:27 -0700 Received: from mail.gnu.org ([199.232.76.166]:48754 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1KqYiK-0001Jn-3A for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:40:52 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1KqYkm-00081y-UD for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:43:25 -0400 Received: from mtaout1.012.net.il ([84.95.2.1]:41105) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KqYkm-00081o-Fy for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 15:43:24 -0400 Received: from HOME-C4E4A596F7 ([77.127.24.3]) by i-mtaout1.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0K8U00C8SK554S30@i-mtaout1.012.net.il> for emacs-pretest-bug@gnu.org; Thu, 16 Oct 2008 21:43:53 +0200 (IST) Date: Thu, 16 Oct 2008 21:42:28 +0200 From: Eli Zaretskii Subject: 23.0.60; Doc string of region-active-p considered unhelpful X-012-Sender: halo1@inter.net.il To: emacs-pretest-bug@gnu.org Message-id: X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the emacs-pretest-bug@gnu.org mailing list. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: "C-h f region-active-p RET" produces the following documentation: Return t if Transient Mark mode is enabled and the mark is active. This is NOT the best function to use to test whether a command should operate on the region instead of the usual behavior -- for that, use `use-region-p'. This is not really helpful: it does not tell why would a Lisp program want to use this function. Are there any circumstances where this function is useful, or do we keep it for compatibility reasons? If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file d:/gnu/emacs/etc/DEBUG for instructions. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-10-16 on HOME-C4E4A596F7 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: ENU value of $XMODIFIERS: nil locale-coding-system: cp1255 default-enable-multibyte-characters: t Major mode: Emacs-Lisp Minor modes in effect: tooltip-mode: t tool-bar-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: C-h f r u e s e - r e g C-x o C-s C-w C-w C-w C-s C-s C-r C-r C-r C-x C-f a l l C-s u s e - r e g C-x C-f - 2 2 - e m / l i s / a l l C-s m a r k - a C-x b s i m p M-x r e p o r t - e Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Type C-x 1 to delete the help window. Loading vc-cvs...done Mark saved where search started Making completion list... Mark saved where search started ------------=_1224609004-12558-1--