Ihor Radchenko <[email protected]> writes: > Axel Svensson <[email protected]> writes: > >> org-version: 9.4.6 >> >> The documentation for the variable org-startup-folded is not up to date. It >> states that the variable can be nil or non-nil, but the program logic makes >> a difference between the values 't, 'content, 'showeverything, >> 'show2levels, 'show3levels, 'show4levels, and 'show5levels. > > The docstring mentions fold, nofold, and other options on master and > maint, albeit not stating that you can set those values with setq: > >> Non-nil means entering Org mode will switch to OVERVIEW. >> >> This can also be configured on a per-file basis by adding one of >> the following lines anywhere in the buffer: >> >> #+STARTUP: fold (or overview, this is equivalent) >> #+STARTUP: nofold (or showall, this is equivalent) >> #+STARTUP: content >> #+STARTUP: show<n>levels (<n> = 2..5) >> #+STARTUP: showeverything >> >> Set org-agenda-inhibit-startup to a non-nil value if you want >> to ignore this option when Org opens agenda files for the first >> time.
For the bug tracker: Fixed, because [C-h v org-startup-folded RET] now gives me the following: #+begin_quote org-startup-folded is a variable defined in ‘org.el’. Its value is ‘showeverything’ Initial folding state of headings when entering Org mode. Allowed values are: symbol ‘nofold’ Do not fold headings. symbol ‘fold’ Fold everything, leaving only top-level headings visible. symbol ‘content’ Leave all the headings and sub-headings visible, but hide their text. This is an equivalent of table of contents. symbol ‘show2levels’, ‘show3levels’, ‘show4levels’, ‘show5levels’ Show headings up to Nth level. symbol ‘showeverything’ (default) Start Org mode in fully unfolded state. Unlike all other allowed values, this value prevents drawers, blocks, and archived subtrees from being folded even when ‘org-cycle-hide-block-startup’, ‘org-cycle-open-archived-trees’, or ‘org-cycle-hide-drawer-startup’ are non-nil. Per-subtree visibility settings (see manual node ‘(org)Initial visibility)’) are also ignored. This can also be configured on a per-file basis by adding one of the following lines anywhere in the buffer: #+STARTUP: fold (or ‘overview’, this is equivalent) #+STARTUP: nofold (or ‘showall’, this is equivalent) #+STARTUP: content #+STARTUP: show<n>levels (<n> = 2..5) #+STARTUP: showeverything Set ‘org-agenda-inhibit-startup’ to a non-nil value if you want to ignore this option when Org opens agenda files for the first time. This variable was introduced, or its default value was changed, in version 9.4 of the Org package that is part of Emacs 27.2. You can customize this variable. #+end_quote -- Christer Enfors Org contributor liaison GPG Fingerprint: 9CF7 3292 83BC D643 DF01 992C 1C3B 434F 2AC2 B1E6 Public Key available at: keys.openpgp.org
