all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Drew Adams <drew.adams@oracle.com>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: 33383@debbugs.gnu.org
Subject: bug#33383: 26; `count-words-region'
Date: Wed, 10 Jul 2019 07:28:32 -0700 (PDT)	[thread overview]
Message-ID: <c57c2aaa-0174-409e-a2ff-72e6d583283c@default> (raw)
In-Reply-To: <87ftne5adh.fsf@mouse.gnus.org>

> > Please consider a minor enhancement: Change the message from this:
> >
> > (count-words--message "Region" start end) to this:
> >
> > (count-words--message
> >   (if (use-region-p) "Active region" "Inactive region")
> >   start
> >   end)
> >
> > It's not so obvious that the report is for the region even when
> > inactive, and many Emacs users will nowadays think of the region only as
> > the active region.  So if the region is inactive and they see a non-zero
> > number they might wonder (and need to consult the doc string to
> > understand).
> 
> I think this command is the wrong place to teach people about what a
> region is, and how it pertains to the "active region mode" (which I
> think uses unfortunate terminology, but that's a different matter).
> 
> So I'm closing this bug report.

It's unfortunate that you feel that way.

1. The doc string explicitly calls this out:
   "(whether or not the region is active)".
   Why, if this is not the place to talk about it?

   That was added to the doc string because it was
   not obvious to many/most users what was going on
   when they saw no region highlighting.

   The same thing is true for `count-lines-region'.
   When `transient-mark-mode' came along, with the
   notion of "active" region and highlighting the
   region, its doc string added that text because
   of such confusion.

2. How many users these days even know that there
   is such a thing as an inactive region, i.e.,
   that the region exists even when they see no
   highlighting of selected text?  Few.

   Many/most users will wonder why this command
   tells them about a word count in "the region"
   when it is inactive, and they will wonder why
   the doc string mentions this.

   Fixing the message clarifies things.  Do you
   think it confuses things?  If not, what reason
   is there _not_ to make this minor change?

   Does your region make you want to also remove
   that text that was added to the doc string?
   If it makes sense to point this out in the doc
   string then it makes even more sense to put it
   in the message - which many more users will see
   than will see the doc string.






      reply	other threads:[~2019-07-10 14:28 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-11-14 15:47 bug#33383: 26; `count-words-region' Drew Adams
2019-07-10 12:42 ` Lars Ingebrigtsen
2019-07-10 14:28   ` Drew Adams [this message]

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=c57c2aaa-0174-409e-a2ff-72e6d583283c@default \
    --to=drew.adams@oracle.com \
    --cc=33383@debbugs.gnu.org \
    --cc=larsi@gnus.org \
    /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.