unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#20253: 24.4; Document `region' face behavior changes, overlay, priority
@ 2015-04-03 21:02 Drew Adams
  2016-09-11 23:24 ` Alex
  0 siblings, 1 reply; 11+ messages in thread
From: Drew Adams @ 2015-04-03 21:02 UTC (permalink / raw)
  To: 20253

Since Emacs 24.3, if I recall correctly, face `region' uses an overlay.
This produces changes in the user-observable behavior - that's why the
change was made.

But the NEWS for 24.3 and for 24.4 do not mention anything about this,
AFAICT.  Not only does NEWS not seem to say anything about `region'
using an overlay, but it does not even mention the observable behavior
differences that this produces.

And the Elisp manual is likewise silent on this change.

Please tell users that such a change was made.  That's what NEWS is for.

And please tell users, in the Elisp manual, what the default priority of
the overlay is.  Testing shows a priority value of (nil . 100), which is
not even a documented form that an overlay priority can take.  But even
if that is what the value needs to be, for internal reasons, at least
tell users what it is.

And if, for some reason, users are supposed not to change the priority,
then say so, in the doc.  And if there is no such restriction or
recommendation, then let them know, if they should be assigning a
priority value that is a cons, such as (nil . NUMBER).

IOW, please communicate with your users about such changes: what they
mean for users (what behavior differences they can expect), and how they
can manipulate/customize the behavior.

In GNU Emacs 24.4.1 (i686-pc-mingw32)
 of 2014-10-24 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr'





^ permalink raw reply	[flat|nested] 11+ messages in thread
[parent not found: <<0ad651bb-89bc-4e86-9354-063db1c400a2@default>]

end of thread, other threads:[~2019-10-12 19:02 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-04-03 21:02 bug#20253: 24.4; Document `region' face behavior changes, overlay, priority Drew Adams
2016-09-11 23:24 ` Alex
2016-09-12 16:46   ` Eli Zaretskii
     [not found] <<0ad651bb-89bc-4e86-9354-063db1c400a2@default>
     [not found] ` <<87inu2vx36.fsf@gmail.com>
     [not found]   ` <<83k2eh9ic9.fsf@gnu.org>
2016-09-12 17:19     ` Drew Adams
2016-09-12 18:37       ` Eli Zaretskii
2016-09-21 18:11         ` Alex
2016-09-21 18:35           ` Eli Zaretskii
2016-09-21 19:10             ` Alex
2016-09-21 20:25               ` Drew Adams
2016-09-23  8:28               ` Eli Zaretskii
2019-10-12 19:02                 ` Lars Ingebrigtsen

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).