From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#20253: 24.4; Document `region' face behavior changes, overlay, priority Date: Fri, 3 Apr 2015 14:02:26 -0700 (PDT) Message-ID: <0ad651bb-89bc-4e86-9354-063db1c400a2@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1428095010 32005 80.91.229.3 (3 Apr 2015 21:03:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 3 Apr 2015 21:03:30 +0000 (UTC) To: 20253@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 03 23:03:17 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Ye8kB-0008Rj-Lq for geb-bug-gnu-emacs@m.gmane.org; Fri, 03 Apr 2015 23:03:11 +0200 Original-Received: from localhost ([::1]:35352 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8kB-00032n-4W for geb-bug-gnu-emacs@m.gmane.org; Fri, 03 Apr 2015 17:03:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52907) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8k7-00032X-4o for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:03:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ye8k2-0001G4-5N for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:03:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54398) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8k2-0001G0-1u for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:03:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Ye8k1-0004AO-Os for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:03:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 03 Apr 2015 21:03:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20253 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.142809496415989 (code B ref -1); Fri, 03 Apr 2015 21:03:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Apr 2015 21:02:44 +0000 Original-Received: from localhost ([127.0.0.1]:44174 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ye8jj-00049p-Ol for submit@debbugs.gnu.org; Fri, 03 Apr 2015 17:02:44 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:51043) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ye8jh-00049b-4r for submit@debbugs.gnu.org; Fri, 03 Apr 2015 17:02:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ye8jb-0001Bs-2T for submit@debbugs.gnu.org; Fri, 03 Apr 2015 17:02:35 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:57408) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8ja-0001Bo-WB for submit@debbugs.gnu.org; Fri, 03 Apr 2015 17:02:35 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52764) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8ja-0002mg-4k for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:02:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ye8jV-0001Ax-5m for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:02:34 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:29825) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ye8jU-0001Al-WD for bug-gnu-emacs@gnu.org; Fri, 03 Apr 2015 17:02:29 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t33L2Rxm029653 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 3 Apr 2015 21:02:28 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t33L2R9A010982 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 3 Apr 2015 21:02:27 GMT Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t33L2QGK009696 for ; Fri, 3 Apr 2015 21:02:26 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:101165 Archived-At: 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=3D/c/usr'