all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Confused about the explanation for 'org-cycle'
@ 2017-09-18 14:04 Alain.Cochard
  2017-09-19  5:08 ` Matt Lundin
  0 siblings, 1 reply; 27+ messages in thread
From: Alain.Cochard @ 2017-09-18 14:04 UTC (permalink / raw)
  To: emacs-orgmode; +Cc: Alain Cochard


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


-- 
EOST (École et Observatoire des Sciences de la Terre) 
IPG (Institut de Physique du Globe) | alain.cochard@unistra.fr
5 rue René Descartes   [bureau 106] | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France    | Fax:   +33 (0)3 68 85 01 25     

^ permalink raw reply	[flat|nested] 27+ messages in thread

end of thread, other threads:[~2017-11-16 10:08 UTC | newest]

Thread overview: 27+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-09-18 14:04 Confused about the explanation for 'org-cycle' Alain.Cochard
2017-09-19  5:08 ` Matt Lundin
2017-09-20 10:57   ` Nicolas Goaziou
2017-09-26  8:54     ` Alain.Cochard
2017-09-26 10:41       ` Nicolas Goaziou
2017-09-26 12:48         ` Alain.Cochard
2017-09-28 13:44           ` org-list-empty-line-terminates-plain-lists removed but still mentioned in the manual Alain.Cochard
2017-09-28 14:07             ` Nicolas Goaziou
2017-09-28 14:31           ` Confused about the explanation for 'org-cycle' Nicolas Goaziou
2017-09-28 15:29             ` Robert Horn
2017-09-28 16:10               ` Kyle Meyer
2017-09-28 16:17                 ` Eric S Fraga
2017-09-28 21:04             ` Alain.Cochard
2017-09-28 21:22               ` Josiah Schwab
2017-09-28 21:30               ` Nicolas Goaziou
2017-10-05  8:17                 ` Alain.Cochard
2017-11-10 17:23                   ` How to use case sensitive org-search-view? Alain.Cochard
2017-11-14 14:26                     ` Matt Lundin
2017-11-14 15:30                       ` Alain.Cochard
2017-11-14 20:35                       ` Nicolas Goaziou
2017-11-14 20:55                         ` Tim Cross
2017-11-15 14:02                           ` Nicolas Goaziou
2017-11-15 21:14                             ` Tim Cross
2017-11-16 10:05                             ` Alain.Cochard
2017-11-15 10:49                         ` Alain.Cochard
2017-11-15 11:55                           ` Nicolas Goaziou
2017-11-15 12:35                             ` Alain.Cochard

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.