Skip to content

Commit

Permalink
* etc/ORG-NEWS (New options): Add new section
Browse files Browse the repository at this point in the history
(A new custom setting =org-hide-drawer-startup= to control initial
folding state of drawers): Move to the new section.
  • Loading branch information
yantar92 committed Jul 31, 2022
1 parent 31b3b16 commit 0b3c6a7
Showing 1 changed file with 24 additions and 23 deletions.
47 changes: 24 additions & 23 deletions etc/ORG-NEWS
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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~
Expand Down

0 comments on commit 0b3c6a7

Please sign in to comment.