From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Alex Newsgroups: gmane.emacs.bugs Subject: bug#20253: 24.4; Document `region' face behavior changes, overlay, priority Date: Sun, 11 Sep 2016 17:24:45 -0600 Message-ID: <87inu2vx36.fsf@gmail.com> References: <0ad651bb-89bc-4e86-9354-063db1c400a2@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1473636381 24226 195.159.176.226 (11 Sep 2016 23:26:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 11 Sep 2016 23:26:21 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) Cc: 20253@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Sep 12 01:26:17 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bjE8e-0005f2-JD for geb-bug-gnu-emacs@m.gmane.org; Mon, 12 Sep 2016 01:26:16 +0200 Original-Received: from localhost ([::1]:39383 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjE8c-0004wF-Na for geb-bug-gnu-emacs@m.gmane.org; Sun, 11 Sep 2016 19:26:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57798) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjE8T-0004wA-Uv for bug-gnu-emacs@gnu.org; Sun, 11 Sep 2016 19:26:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bjE8Q-0000Wt-Nj for bug-gnu-emacs@gnu.org; Sun, 11 Sep 2016 19:26:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:59135) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjE8Q-0000Wp-KV for bug-gnu-emacs@gnu.org; Sun, 11 Sep 2016 19:26:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bjE8Q-0005dT-Cz for bug-gnu-emacs@gnu.org; Sun, 11 Sep 2016 19:26:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Alex Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Sep 2016 23:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20253 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20253-submit@debbugs.gnu.org id=B20253.147363630321580 (code B ref 20253); Sun, 11 Sep 2016 23:26:02 +0000 Original-Received: (at 20253) by debbugs.gnu.org; 11 Sep 2016 23:25:03 +0000 Original-Received: from localhost ([127.0.0.1]:56847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bjE7S-0005bq-Uh for submit@debbugs.gnu.org; Sun, 11 Sep 2016 19:25:03 -0400 Original-Received: from mail-oi0-f52.google.com ([209.85.218.52]:34073) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bjE7R-0005bC-9E for 20253@debbugs.gnu.org; Sun, 11 Sep 2016 19:25:01 -0400 Original-Received: by mail-oi0-f52.google.com with SMTP id m11so274173153oif.1 for <20253@debbugs.gnu.org>; Sun, 11 Sep 2016 16:25:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=HKKirjNMpFER38oIisgbtv6QVRWYd383b93y3dNWxRs=; b=OdyuONpeDnZgVgifMhpyEnhue38o5xS6PnRIKdjc7/GjIgS2Z9Wd7fzuvp9KhNUUYF FJDa9FvZkgLfobDUV1Qx+n8Gf3DVDYK0if69iwrJCg5b2SfnxbCAYiKTr++CcrjS9wuM TFApjkVK8Z4TEeOJymU1RPh9hWRXhhWmEjkrlh35wPLc2pQMaKvtcUBY7FxBxW/aZtz+ E60cFUt0pKLZh9TyAR8S3KPj2E3I8/iwM+WXD2AFpkkby5kftwJpOX92Zm3yn3BKszSC cWIx/l47jvzcBGlz4cq+trpo3HQsVnPWG+aj+iT3XxF4KkFMwvi8lAjDbpj5FWVxJQR/ 1VFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=HKKirjNMpFER38oIisgbtv6QVRWYd383b93y3dNWxRs=; b=eP9nZNEHBx4mTHLBBN8sIPlFgEI3OkHIYsNKSb3F4NxIe6rqcX+XOE22xNXr61gmjo tFVriSiHPkfPKzaWfdMBzhFgvhF8ATAQHmKuYJ5IZHuS//OY5IajfaeJNizbEUY3TSgR BIACgXwXIM0ELMeFUiya0AbXYFnYocaWX67G+6FkxhOHKANcu7de7aapJxk07HXgbId4 eeDoWaiZX3VBxGPWb108tCv67gj5de57jnu2LSVANARUYvI46tiDTQXr/O2qmixSlWdB PkJhaXsuF02c+u+egUy3etJrJeZws2LC4Whae4WBX5/P19maMajrEH8TunOtcwjedFx7 hGcQ== X-Gm-Message-State: AE9vXwMgDjbcoh734Yi708ALxdfGXEvWFcb8R9Grx120v7OJ1HtbNqhAdDJ1TmhpLIUa3g== X-Received: by 10.202.95.133 with SMTP id t127mr19583541oib.80.1473636295603; Sun, 11 Sep 2016 16:24:55 -0700 (PDT) Original-Received: from lylat (S01061859339e9903.ss.shawcable.net. [174.2.107.88]) by smtp.gmail.com with ESMTPSA id n26sm572585ioi.17.2016.09.11.16.24.54 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 11 Sep 2016 16:24:55 -0700 (PDT) In-Reply-To: <0ad651bb-89bc-4e86-9354-063db1c400a2@default> (Drew Adams's message of "Fri, 3 Apr 2015 14:02:26 -0700 (PDT)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:123199 Archived-At: Drew Adams writes: > 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. The Elisp manual does mention that "Emacs sometimes uses non-numeric priority values for some of its internal overlays", but it would be nice if it documented what those were and what they mean. The comments in simple.el mention that a cons cell value represents primary/secondary priorities, but it's not clear what the difference is.