From 4fa9c08fabb17bddd760ec8491c140b7d1d1c91f Mon Sep 17 00:00:00 2001 From: Ihor Radchenko Date: Mon, 21 Dec 2020 23:26:49 +0800 Subject: [PATCH] Document changes of headline fontification introduced in 979e82fc3 * etc/ORG-NEWS (=org-goto-first-child= now works before first heading): Document that all the headline components inherit the headline face instead of default face. Provide example how to restore the old behaviour. --- etc/ORG-NEWS | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index d685f30b6..fd19b2f1a 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -157,6 +157,35 @@ headings in the buffer. Previously =org-goto-first-child= would do nothing before first heading, except return nil. +*** Faces of all the heading text elements now conform to the headline face + +In the past, faces of todo keywords, emphasised text, tags, and +priority cookies inherited =default= face. The resulting headline +fontification was not always consistent, as discussed in [[https://lists.gnu.org/archive/html/emacs-orgmode/2020-09/msg00331.html][this bug +report]]. Now, the relevant faces adapt to face used to fontify the +current headline level. + +Users who prefer to keep the old behaviour should change their face +customisation explicitly stating that =default= face is inherited. + +Example of old face customisation: + +#+begin_src emacs-lisp +(setq org-todo-keyword-faces '(("TODO" + :background "chocolate" + :height 0.75))) +#+end_src + +To preserve the old behaviour the above customisation should be +changed to + +#+begin_src emacs-lisp +(setq org-todo-keyword-faces '(("TODO" + :inherit default + :background "chocolate" + :height 0.75))) +#+end_src + * Version 9.4 ** Incompatible changes *** Possibly broken internal file links: please check and fix -- 2.26.2