[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] Confused about the explanation for 'org-cycle'
From: |
Nicolas Goaziou |
Subject: |
Re: [O] Confused about the explanation for 'org-cycle' |
Date: |
Tue, 26 Sep 2017 12:41:39 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) |
Hello,
address@hidden writes:
> But now, compared to the previous version:
>
> When the cursor is at the beginning of the buffer and the first
> line is not a headline, then <TAB> actually runs global cycling
>
> it is not clear to me why the mention "and the first line is not a
> headline" has been suppressed.
I traded completeness for clarity.
The reasoning is that the description about a pathological case -- here,
the first line of the buffer being a heading -- belongs to variable's
docstring, not to the manual.
We can add a footnote about that case, but even a footnote impedes
clarity.
Of course, if you have a clear wording that includes that pathological
case, I'll happily use it.
Regards,
--
Nicolas Goaziou
- [O] Confused about the explanation for 'org-cycle', Alain . Cochard, 2017/09/18
- Re: [O] Confused about the explanation for 'org-cycle', Matt Lundin, 2017/09/19
- Re: [O] Confused about the explanation for 'org-cycle', Nicolas Goaziou, 2017/09/20
- 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
- Re: [O] Confused about the explanation for 'org-cycle', Alain . Cochard, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Josiah Schwab, 2017/09/28
- Re: [O] Confused about the explanation for 'org-cycle', Nicolas Goaziou, 2017/09/28