From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kyle Meyer Subject: =?UTF-8?B?UmU6IEJ1ZzogT3JnIG1hbnVhbDogU3RydWN0dXJlIEVkaXRpbmc6?= =?UTF-8?B?IENsYXJpZnkgY29tbWFuZHMgd2hpY2ggdXNlIHRoZSBUcmFuc2llbnQgTWFy?= =?UTF-8?B?ayByZWdpb24gWzkuMy42ICg5LjMuNi0yMy1nMDFlZTI1LWVscGFwbHVzIEAg?= =?UTF-8?B?L3RtcC8uZW1hY3MuZC50bXAuOTk3MTJhZDQtNjFmNC00NDY0LWIwMDMtZDZk?= =?UTF-8?B?NGVlYTliOThmL29yZy1wbHVzLWNvbnRyaWItMjAyMDAzMDkvKV0=?= Date: Sun, 15 Mar 2020 21:11:57 +0000 Message-ID: <87v9n58grm.fsf@kyleam.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:41439) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jDaYM-0007SK-JZ for emacs-orgmode@gnu.org; Sun, 15 Mar 2020 17:12:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jDaYK-0003hc-70 for emacs-orgmode@gnu.org; Sun, 15 Mar 2020 17:12:10 -0400 Received: from pb-smtp21.pobox.com ([173.228.157.53]:60497) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jDaYJ-0003XO-RF for emacs-orgmode@gnu.org; Sun, 15 Mar 2020 17:12:08 -0400 In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org Sender: "Emacs-orgmode" To: B Goodr , emacs-orgmode@gnu.org B Goodr writes: > The essential issue is this: The paragraph at the very bottom of the > Structure Editing page of the manual is misleading: It leads a user to > believe that all of the commands use the Transient Mark region, but some = of > them do not or should not. I agree with your assessment, in particular that this comment could easily be interpreted as applying to org-promote-subtree and org-demote-subtree. > One possibility to fix this is to mention, inside each described > command in that page, which ones respect the region, and which ones do > not, possibly using footnotes for more details. Sounds good to me. As far as I can tell, this comment applies only to org-do-promote and org-do-demote, so I think moving the comment into a shared entry for those commands would make things clearer: =E2=80=98M-=E2=80=99 (=E2=80=98org-do-promote=E2=80=99), =E2=80=98M= -=E2=80=99 (=E2=80=98org-do-demote=E2=80=99) Promote or demote current heading by one level. =20=20 When there is an active region=E2=80=94i.e., when Transient Mark mod= e is active=E2=80=94promotion and demotion work on all headlines in the r= egion. 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. I'll apply the patch to do so in a day or two if no one raises an objection. Thanks for reporting the issue! -- >8 -- Subject: [PATCH] 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 --- doc/org-manual.org | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 4c8dff5ee..c62fd58b4 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -689,6 +689,7 @@ ** Structure Editing #+cindex: sorting, of subtrees #+cindex: subtrees, cut and paste =20 +#+attr_texinfo: :sep , - {{{kbd(M-RET)}}} (~org-meta-return~) :: =20 #+kindex: M-RET @@ -743,17 +744,23 @@ ** Structure Editing level. Yet another {{{kbd(TAB)}}}, and you are back to the initial level. =20 -- {{{kbd(M-LEFT)}}} (~org-do-promote~) :: +- {{{kbd(M-LEFT)}}} (~org-do-promote~), {{{kbd(M-RIGHT)}}} (~org-do-demote= ~) :: =20 #+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. =20 - {{{kbd(M-S-LEFT)}}} (~org-promote-subtree~) :: =20 @@ -889,16 +896,8 @@ ** Structure Editing Finally, if the first line is a headline, remove the stars from all headlines in the region. =20 -#+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. =20 ** Sparse Trees :PROPERTIES: --=20 2.25.1