[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] Confused about the explanation for 'org-cycle'
From: |
Matt Lundin |
Subject: |
Re: [O] Confused about the explanation for 'org-cycle' |
Date: |
Tue, 19 Sep 2017 00:08:36 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux) |
I agree that this is confusing. I examined the org repository history,
and it seems that both the documentation and the variable go all the way
back to 2007. I believe the default value of the variable was changed to
nil, but the documentation was not updated accordingly.
Matt
address@hidden writes:
> Hello.
>
> In section "2.3.1 Global and local cycling" of the manual I read:
>
>
> `<TAB>' (`org-cycle')
> _Subtree cycling_: Rotate current subtree among the states
>
> ,-> FOLDED -> CHILDREN -> SUBTREE --.
> '-----------------------------------'
>
> The cursor must be on a headline for this to work(1). When the
> cursor is at the beginning of the buffer and the first line is not
> a headline, then <TAB> actually runs global cycling (see
> below)(2).
>
> with the footnote being
>
> (2) see the option `org-cycle-global-at-bob'.
>
>
> If I use Org Mode without any customization, then, when using <TAB>
> "When the cursor is at the beginning of the buffer and the first line
> is not a headline", absolutely nothing is done.
>
> Sure, this is consistent with the help page of variable
> org-cycle-global-at-bob which says that "When this option is nil,
> don't do anything special at the beginning of the buffer", together
> with the fact that, without any customization, org-cycle-global-at-bob
> is 'nil'.
>
> But I find this very confusing, at least for the beginner, who is
> unlikely to enquire right away about the possible values of
> org-cycle-global-at-bob.
>
> Or perhaps I am missing something at the English level?
>
> Regards,
> alain
- [O] Confused about the explanation for 'org-cycle', Alain . Cochard, 2017/09/18
- Re: [O] Confused about the explanation for 'org-cycle',
Matt Lundin <=
- Re: [O] Confused about the explanation for 'org-cycle', Nicolas Goaziou, 2017/09/20
- Re: [O] Confused about the explanation for 'org-cycle', Alain . Cochard, 2017/09/26
- Re: [O] Confused about the explanation for 'org-cycle', Nicolas Goaziou, 2017/09/26
- Re: [O] Confused about the explanation for 'org-cycle', Alain . Cochard, 2017/09/26
- [O] org-list-empty-line-terminates-plain-lists removed but still mentioned in the manual, Alain . Cochard, 2017/09/28
- Re: [O] org-list-empty-line-terminates-plain-lists removed but still mentioned in the manual, Nicolas Goaziou, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Nicolas Goaziou, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Robert Horn, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Kyle Meyer, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Eric S Fraga, 2017/09/28