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.
This commit is contained in:
Ihor Radchenko 2020-12-21 23:26:49 +08:00 committed by Bastien
parent 713b3bf7a0
commit 1f4ea532a4
1 changed files with 29 additions and 0 deletions

View File

@ -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