GNU bug report logs - #3873
23.1.50; docstring of `region-active-p' is nonsensical

Previous Next

Full log

Message #15 received at 3873 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: MON KEY <monkey <at> sandpframing.com>
To: Lennart Borgman <lennart.borgman <at> gmail.com>
Cc: 3873 <at> debbugs.gnu.org
Subject: Re: bug#3873: 23.1.50; docstring of `region-active-p' is nonsensical
Date: Fri, 17 Jul 2009 21:03:59 -0400

On Fri, Jul 17, 2009 at 2:28 PM, Lennart
Borgman<lennart.borgman <at> gmail.com> wrote:
> To me it would be more clear with something like:
>
> Mark mode is enabled. To make this work as in most other editing
> environtments today you can use `cua-mode'."
>
Lennart, I appreciate the `cua-mode' plug :)
However, this is not the issue nor the solution and can only introduce
additional confusion...

My proposal:

"`region-active-p'

Return t if Transient Mark mode is enabled and the mark is active.

Commands which act on the region may require to test if it is active;
if Transient Mark mode is enabled; or if it is otherwise at the text
near point should use `use-region-p' instead.

This function is usually the wrong thing to use when testing if
the region is active and if it is appropriate to act on it.
It can return incorrect results when used with commands which act on the
region by disregarding the value of `use-empty-active-region'."

s_P

Previous Next

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