From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#20253: 24.4; Document `region' face behavior changes, overlay, priority Date: Wed, 21 Sep 2016 21:35:27 +0300 Message-ID: <834m59f6ds.fsf@gnu.org> References: <0ad651bb-89bc-4e86-9354-063db1c400a2@default>> <87inu2vx36.fsf@gmail.com>> <83k2eh9ic9.fsf@gnu.org>> <83wpih7ynm.fsf@gnu.org> <87vaxpnmwz.fsf@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1474483387 31081 195.159.176.226 (21 Sep 2016 18:43:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 21 Sep 2016 18:43:07 +0000 (UTC) Cc: 20253@debbugs.gnu.org To: Alex Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Sep 21 20:43:03 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 1bmmTx-0006v1-FJ for geb-bug-gnu-emacs@m.gmane.org; Wed, 21 Sep 2016 20:42:57 +0200 Original-Received: from localhost ([::1]:49497 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmmTv-0006GE-KJ for geb-bug-gnu-emacs@m.gmane.org; Wed, 21 Sep 2016 14:42:55 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37268) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmmPG-0001VP-1d for bug-gnu-emacs@gnu.org; Wed, 21 Sep 2016 14:38:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bmmPC-00007c-0V for bug-gnu-emacs@gnu.org; Wed, 21 Sep 2016 14:38:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53707) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmmPB-00007X-TG for bug-gnu-emacs@gnu.org; Wed, 21 Sep 2016 14:38:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bmmPB-00026g-MS for bug-gnu-emacs@gnu.org; Wed, 21 Sep 2016 14:38:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 21 Sep 2016 18:38:01 +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.14744830498056 (code B ref 20253); Wed, 21 Sep 2016 18:38:01 +0000 Original-Received: (at 20253) by debbugs.gnu.org; 21 Sep 2016 18:37:29 +0000 Original-Received: from localhost ([127.0.0.1]:59897 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmmOf-00025s-7p for submit@debbugs.gnu.org; Wed, 21 Sep 2016 14:37:29 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:46108) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmmOd-00025g-RQ for 20253@debbugs.gnu.org; Wed, 21 Sep 2016 14:37:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bmmOU-0008RQ-GA for 20253@debbugs.gnu.org; Wed, 21 Sep 2016 14:37:22 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:41692) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmmOU-0008R7-Cs; Wed, 21 Sep 2016 14:37:18 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4370 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bmmOQ-00030Q-HK; Wed, 21 Sep 2016 14:37:17 -0400 In-reply-to: <87vaxpnmwz.fsf@gmail.com> (message from Alex on Wed, 21 Sep 2016 12:11:08 -0600) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:123526 Archived-At: > From: Alex > Cc: Drew Adams , 20253@debbugs.gnu.org > Date: Wed, 21 Sep 2016 12:11:08 -0600 > > My curiosity about the meaning of a cons cell priority is what pushed me > to find and respond to this bug, so I guess that would count as one > question. > > Since the region overlay is a very common overlay, I think it is > important enough to at least have a passing statement about its priority > value type in the documentation. Even something like "For example, some > overlays use a cons cell priority (PRIMARY . SECONDARY), where SECONDARY > is used as a tie-breaker if the PRIMARY priorities and boundaries of the > overlays are equal." would be nice. I hoped to hear some practical reasons for this, not just curiosity. Like practical use cases where knowing that internal detail (as opposed to using the documented methods of comparing priorities etc.) is imperative for that use case. People often ask questions here out of curiosity about the display engine's inner workings, for example, and I try to answer them as best as I can. But that doesn't mean all I write here in those discussions should be in the manual. IOW, the need to have some internal detail described in the manual (which implies we will have to update and maintain it for the years to come) should have more important reasons than just curiosity.