Subject: bug#3873: 23.1.50; docstring of `region-active-p' is nonsensical

From: MON KEY <[email-masked]>
Date: Fri, 17 Jul 2009 21:03:59 -0400

On Fri, Jul 17, 2009 at 2:28 PM, Lennart
Borgman<[email-masked]> 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