From 0b3c6a752f21256cdd583483c896ebcbaae1d1f4 Mon Sep 17 00:00:00 2001 From: Ihor Radchenko Date: Sun, 31 Jul 2022 14:58:47 +0800 Subject: [PATCH] * etc/ORG-NEWS (New options): Add new section (A new custom setting =org-hide-drawer-startup= to control initial folding state of drawers): Move to the new section. --- etc/ORG-NEWS | 47 ++++++++++++++++++++++++----------------------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index 578911b86..b41820a2b 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -262,6 +262,30 @@ example, prints a sub-bibliography containing the book entries with =ai= among their keywords. +** New options +*** A new custom setting =org-hide-drawer-startup= to control initial folding state of drawers + +Previously, all the drawers were always folded when opening an Org +file. This only had an effect on the drawers outside folded +headlines. The drawers inside folded headlines were re-folded because +=org-cycle-hide-drawers= was present inside =org-cycle-hook=. + +With the new folding backend, running =org-cycle-hide-drawers= is no +longer needed if all the drawers are truly folded on startup: [[*Folding +state of the drawers is now preserved when cycling headline +visibility]]. However, this has an unwanted effect when a user does +not want the drawers to be folded (see [[https://orgmode.org/list/m2r14f407q.fsf@ntnu.no][this bug report]]). + +The new custom setting gives more control over initial folding state +of the drawers. When set to =nil= (default is =t=), the drawers are +not folded on startup. + +The folding state can also be controlled on per-file basis using +=STARTUP= keyword: + +: #+startup: hidedrawers +: #+startup: nohidedrawers + ** New functions and changes in function arguments *** ~org-fold-show-entry~ does not fold drawers by default anymore @@ -320,29 +344,6 @@ The new variable name is =org-plantuml-args=. It now applies to both jar PlantUML file and executable. ** Miscellaneous -*** A new custom setting =org-hide-drawer-startup= to control initial folding state of drawers - -Previously, all the drawers were always folded when opening an Org -file. This only had an effect on the drawers outside folded -headlines. The drawers inside folded headlines were re-folded because -=org-cycle-hide-drawers= was present inside =org-cycle-hook=. - -With the new folding backend, running =org-cycle-hide-drawers= is no -longer needed if all the drawers are truly folded on startup: [[*Folding -state of the drawers is now preserved when cycling headline -visibility]]. However, this has an unwanted effect when a user does -not want the drawers to be folded (see [[https://orgmode.org/list/m2r14f407q.fsf@ntnu.no][this bug report]]). - -The new custom setting gives more control over initial folding state -of the drawers. When set to =nil= (default is =t=), the drawers are -not folded on startup. - -The folding state can also be controlled on per-file basis using -=STARTUP= keyword: - -: #+startup: hidedrawers -: #+startup: nohidedrawers - *** Styles are customizable in ~biblatex~ citation processor It is now possible to add new styles or modify old ones in ~biblatex~