Mention level cycling in the docstring of org-cycle

2 files changed, 8 insertions, 0 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 34d94a3..3f4edaa 100755
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2010-02-01  Carsten Dominik  <carsten.dominik@gmail.com>
 
+	* org.el (org-cycle): Mention level cycling in the docstring.
+
 	* org-remember.el (org-remember-apply-template): Do file insertion
 	first.
 
diff --git a/lisp/org.el b/lisp/org.el
index d92e335..96aeded 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -5142,6 +5142,12 @@ in special contexts.
   3. SUBTREE:  Show the entire subtree, including body text.
   If there is no subtree, switch directly from CHILDREN to FOLDED.
 
+- When point is at the beginning of an empty headline and the variable
+  `org-cycle-level-after-item/entry-creation' is set, cycle the level
+  of the headline by demoting and promoting it to likely levels.  This
+  speeds up creation document structure by presing TAB once or several
+  times right after creating a new headline.
+
 - When there is a numeric prefix, go up to a heading with level ARG, do
   a `show-subtree' and return to the previous cursor position.  If ARG
   is negative, go up that many levels.