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: Mon, 12 Sep 2016 19:46:30 +0300 Message-ID: <83k2eh9ic9.fsf@gnu.org> References: <0ad651bb-89bc-4e86-9354-063db1c400a2@default> <87inu2vx36.fsf@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1473698984 10962 195.159.176.226 (12 Sep 2016 16:49:44 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 12 Sep 2016 16:49:44 +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 Mon Sep 12 18:49:40 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 1bjUQK-0001wU-Jn for geb-bug-gnu-emacs@m.gmane.org; Mon, 12 Sep 2016 18:49:36 +0200 Original-Received: from localhost ([::1]:44148 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjUQE-0003lF-Ne for geb-bug-gnu-emacs@m.gmane.org; Mon, 12 Sep 2016 12:49:30 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40066) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjUNw-0002Dj-2F for bug-gnu-emacs@gnu.org; Mon, 12 Sep 2016 12:47:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bjUNq-0002l1-Bz for bug-gnu-emacs@gnu.org; Mon, 12 Sep 2016 12:47:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:60141) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjUNq-0002kl-8c for bug-gnu-emacs@gnu.org; Mon, 12 Sep 2016 12:47:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bjUNq-0006f3-4f for bug-gnu-emacs@gnu.org; Mon, 12 Sep 2016 12:47:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 12 Sep 2016 16:47: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.147369881225590 (code B ref 20253); Mon, 12 Sep 2016 16:47:02 +0000 Original-Received: (at 20253) by debbugs.gnu.org; 12 Sep 2016 16:46:52 +0000 Original-Received: from localhost ([127.0.0.1]:57853 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bjUNf-0006ef-LU for submit@debbugs.gnu.org; Mon, 12 Sep 2016 12:46:51 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:48893) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bjUNX-0006eK-Ga for 20253@debbugs.gnu.org; Mon, 12 Sep 2016 12:46:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bjUNH-0002Yj-SA for 20253@debbugs.gnu.org; Mon, 12 Sep 2016 12:46:37 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:39486) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjUNH-0002YU-Oo; Mon, 12 Sep 2016 12:46:27 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1869 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bjUNG-0007Kx-SW; Mon, 12 Sep 2016 12:46:27 -0400 In-reply-to: <87inu2vx36.fsf@gmail.com> (message from Alex on Sun, 11 Sep 2016 17:24:45 -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:123221 Archived-At: > From: Alex > Date: Sun, 11 Sep 2016 17:24:45 -0600 > Cc: 20253@debbugs.gnu.org > > 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. See compare_overlays in buffer.c. The ELisp manual is not supposed to be a comprehensive documentation of the Emacs internals, it's supposed to provide information for users who write Lisp programs. People who develop Emacs itself will need to read the sources anyway. So it's not a big deal if some obscure feature is not described in the manual, it just means it is not supposed to be used by Lisp programs that are not part of Emacs.