tec/org-mode
tec
/
org-mode
forked from mirrors/org-mode
1
0
Fork 0
Code Pull Requests Releases Activity

manual: Clarify which structure editing commands use the region 

* doc/org-manual.org (Structure Editing): Combine org-do-promote and
org-do-demote into a single entry that includes the remark about their
treatment of an active region.

At the end of the structure editing node, there is a note that
promotion and demotion works on the region, if active, but that
applies only to org-do-demote and org-do-promote, not
org-promote-subtree and org-demote-subtree.  Reposition this comment
to avoid any confusion.

Suggested-by: B Goodr <bgoodr@gmail.com>
This commit is contained in:
Kyle Meyer 2020-03-15 21:11:57 +00:00
parent 73bd246ca7
commit 4b26289f00
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
doc/org-manual.org
View File

@ -689,6 +689,7 @@ The following commands jump to other headlines in the buffer.
#+cindex: sorting, of subtrees
#+cindex: subtrees, cut and paste
#+attr_texinfo: :sep ,
- {{{kbd(M-RET)}}} (~org-meta-return~) ::
#+kindex: M-RET
@ -743,17 +744,23 @@ The following commands jump to other headlines in the buffer.
level. Yet another {{{kbd(TAB)}}}, and you are back to the initial
level.
- {{{kbd(M-LEFT)}}} (~org-do-promote~) ::
- {{{kbd(M-LEFT)}}} (~org-do-promote~), {{{kbd(M-RIGHT)}}} (~org-do-demote~) ::
#+kindex: M-LEFT
#+findex: org-do-promote
Promote current heading by one level.
- {{{kbd(M-RIGHT)}}} (~org-do-demote~) ::
#+kindex: M-RIGHT
#+findex: org-do-demote
Demote current heading by one level.
Promote or demote current heading by one level.
#+cindex: region, active
#+cindex: active region
#+cindex: transient mark mode
When there is an active region---i.e., when Transient Mark mode is
active---promotion and demotion work on all headlines in the region.
To select a region of headlines, it is best to place both point and
mark at the beginning of a line, mark at the beginning of the first
headline, and point at the line just after the last headline to
change.
- {{{kbd(M-S-LEFT)}}} (~org-promote-subtree~) ::
@ -889,16 +896,8 @@ The following commands jump to other headlines in the buffer.
Finally, if the first line is a headline, remove the stars from all
headlines in the region.
#+cindex: region, active
#+cindex: active region
#+cindex: transient mark mode
When there is an active region---i.e., when Transient Mark mode is
active---promotion and demotion work on all headlines in the region.
To select a region of headlines, it is best to place both point and
mark at the beginning of a line, mark at the beginning of the first
headline, and point at the line just after the last headline to
change. Note that when point is inside a table (see [[*Tables]]), the
Meta-Cursor keys have different functionality.
Note that when point is inside a table (see [[*Tables]]), the Meta-Cursor
keys have different functionality.
** Sparse Trees
:PROPERTIES: