summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKyle Meyer <kyle@kyleam.com>2020-03-15 21:11:57 +0000
committerKyle Meyer <kyle@kyleam.com>2020-03-17 23:40:05 -0400
commit4b26289f00d2f67dc5652e5ab50c5bc74f2da105 (patch)
treec8eeb43d7e1013a2e418612e497ccbb4995fb6c4
parent73bd246ca7978b9c90d9d0f26584727c40350a44 (diff)
downloadorg-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.org31
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: