org.texi: Fix documentation about C-RET and M-RET

* doc/org.texi (Structure editing): Fix documentation, which is no
  longer in sync with the current behavior of the commands.
This commit is contained in:
Nicolas Goaziou 2016-10-02 00:19:51 +02:00
parent 005b3c07bb
commit 7075704b09
1 changed files with 12 additions and 17 deletions

View File

@ -1425,26 +1425,21 @@ See also the option @code{org-goto-interface}.
@vindex org-M-RET-may-split-line @vindex org-M-RET-may-split-line
Insert a new heading/item with the same level as the one at point. Insert a new heading/item with the same level as the one at point.
If the cursor is in a plain list item, a new item is created (@pxref{Plain If the command is used at the @emph{beginning} of a line, and if there is
lists}). To prevent this behavior in lists, call the command with one prefix a heading or a plain list item (@pxref{Plain lists}) at point, the new
argument. When this command is used in the middle of a line, the line is heading/item is created @emph{before} the current line. When used at the
split and the rest of the line becomes the new item or headline. If you do beginning of a regular line of text, turn that line into a heading.
not want the line to be split, customize @code{org-M-RET-may-split-line}.
If the command is used at the @emph{beginning} of a line, and if there is a When this command is used in the middle of a line, the line is split and the
heading or an item at point, the new heading/item is created @emph{before} rest of the line becomes the new item or headline. If you do not want the
the current line. If the command is used at the @emph{end} of a folded line to be split, customize @code{org-M-RET-may-split-line}.
subtree (i.e., behind the ellipses at the end of a headline), then a headline
will be inserted after the end of the subtree.
Calling this command with @kbd{C-u C-u} will unconditionally respect the Calling the command with a @kbd{C-u} prefix unconditionally inserts a new
headline's content and create a new item at the end of the parent subtree. heading at the end of the current subtree, thus preserving its contents.
With a double @kbd{C-u C-u} prefix, the new heading is created at the end of
If point is at the beginning of a normal line, turn this line into a heading. the parent subtree instead.
@orgcmd{C-@key{RET},org-insert-heading-respect-content} @orgcmd{C-@key{RET},org-insert-heading-respect-content}
Just like @kbd{M-@key{RET}}, except when adding a new heading below the Insert a new heading at the end of the current subtree.
current heading, the new heading is placed after the body instead of before
it. This command works from anywhere in the entry.
@orgcmd{M-S-@key{RET},org-insert-todo-heading} @orgcmd{M-S-@key{RET},org-insert-todo-heading}
@vindex org-treat-insert-todo-heading-as-state-change @vindex org-treat-insert-todo-heading-as-state-change
Insert new TODO entry with same level as current heading. See also the Insert new TODO entry with same level as current heading. See also the