From: Lars Ingebrigtsen <larsi@gnus.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 16513@debbugs.gnu.org
Subject: bug#16513: 24.3.50; doc string of `use-empty-active-region'
Date: Sun, 09 Feb 2014 21:34:45 -0800 [thread overview]
Message-ID: <87ppmv7cp6.fsf@building.gnus.org> (raw)
In-Reply-To: <8da28f3d-e5ec-48d4-9407-377ec2afbc6c@default> (Drew Adams's message of "Mon, 20 Jan 2014 20:20:18 -0800 (PST)")
Drew Adams <drew.adams@oracle.com> writes:
> 1. Remove the last part: ", and on the text near point otherwise." It
> is inappropriate and wrong. (This is the reason I filed this bug.)
>
> This is about commands that act differently depending on whether or
> not the region is active. Do not say anything about what the behavior
> must be in either case: active or inactive. Certainly, do not claim
> that when the region is inactive such commands act on the text near
> point. That is pure fantasy.
>
> 2. Simplify the following, which suggests that having an active region
> is somehow different from having an active mark:
>
> "If non-nil, region-aware commands treat the region as active as long as
> the mark is active, even if the region is empty." Just say: "If
> non-nil, region-aware commands treat an active region as such, even if
> it is empty."
>
> 3. Do not speak of "regions", as it can confuse people. In any given
> buffer at any moment there is only one region. "The region" makes
> sense; "regions" does not, unless you are talking about multiple
> buffers.
The previous version of the doc strings seems to be more
straightforward. Is there some subtlety that the new version tried to
get across?
! "If non-nil, an active region takes control even if empty.
! This applies to certain commands which, in Transient Mark mode,
! apply to the active region if there is one. If the setting is t,
! these commands apply to an empty active region if there is one.
! If the setting is nil, these commands treat an empty active
! region as if it were not active."
while it's now
(defcustom use-empty-active-region nil
"Whether \"region-aware\" commands should act on empty regions.
If nil, region-aware commands treat empty regions as inactive.
If non-nil, region-aware commands treat the region as active as
long as the mark is active, even if the region is empty.
Region-aware commands are those that act on the region if it is
active and Transient Mark mode is enabled, and on the text near
point otherwise."
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
next prev parent reply other threads:[~2014-02-10 5:34 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-01-21 4:20 bug#16513: 24.3.50; doc string of `use-empty-active-region' Drew Adams
2014-02-10 5:34 ` Lars Ingebrigtsen [this message]
2016-04-29 15:54 ` Lars Ingebrigtsen
2016-04-29 18:20 ` Drew Adams
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87ppmv7cp6.fsf@building.gnus.org \
--to=larsi@gnus.org \
--cc=16513@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.