diff options
author | Kyle Meyer <kyle@kyleam.com> | 2020-03-15 21:11:57 +0000 |
---|---|---|
committer | Kyle Meyer <kyle@kyleam.com> | 2020-03-17 23:40:05 -0400 |
commit | 4b26289f00d2f67dc5652e5ab50c5bc74f2da105 (patch) | |
tree | c8eeb43d7e1013a2e418612e497ccbb4995fb6c4 | |
parent | 73bd246ca7978b9c90d9d0f26584727c40350a44 (diff) | |
download | org-mode-4b26289f00d2f67dc5652e5ab50c5bc74f2da105.tar.gz |
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>
-rw-r--r-- | doc/org-manual.org | 31 |
1 files changed, 15 insertions, 16 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org index 357251f..696441c 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -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: |