From unknown Thu Aug 14 20:53:12 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#1185 <1185@debbugs.gnu.org> To: bug#1185 <1185@debbugs.gnu.org> Subject: Status: 23.0.60; Doc string of region-active-p considered unhelpful Reply-To: bug#1185 <1185@debbugs.gnu.org> Date: Fri, 15 Aug 2025 03:53:12 +0000 retitle 1185 23.0.60; Doc string of region-active-p considered unhelpful reassign 1185 emacs submitter 1185 Eli Zaretskii severity 1185 normal thanks 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 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. From unknown Thu Aug 14 20:53:12 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: $requester Subject: Internal Control Message-Id: bug archived. Date: Wed, 19 Nov 2008 15:24:04 +0000 User-Agent: Fakemail v42.6.9 # A New Hope # A log time ago, in a galaxy far, far away # something happened. # # Magically this resulted in the following # action being taken, but this fake control # message doesn't tell you why it happened # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator