Request for addition to "structure editing" manual section

Request for addition to "structure editing" manual section

[Tim Braun]

[-- Attachment #1: Type: text/plain, Size: 995 bytes --]

Hello,

There is a useful but undocumented feature in org-mode related to structure editing. Occasionally one may need to move a sub-item within a file but outside its current parent heading. There is an existing function and native keybinding for this: M-S <up> and M-S <down>. This isn't listed, however, on the https://orgmode.org/manual/Structure-Editing.html page or the packaged info with org.el. ...at least so far as I can tell. Could this be added to one or both? I think the html manual is more used, but I don't know...


Thank you,


Tim Braun

________________________________
CONFIDENTIALITY WARNING:: This e-mail may contain proprietary, privileged, or sensitive information of Applied Physical Sciences Corp. Any unauthorized use or disclosure of this communication is prohibited. Contractual restrictions may also apply to third parties. If you believe that you have received this email in error, please notify the sender immediately and delete it from your system.

[-- Attachment #2: Type: text/html, Size: 1989 bytes --]

Re: Request for addition to "structure editing" manual section

[Ihor Radchenko]

Tim Braun <TBraun@aphysci.com> writes:

> There is a useful but undocumented feature in org-mode related to
> structure editing. Occasionally one may need to move a sub-item within
> a file but outside its current parent heading. There is an existing
> function and native keybinding for this: M-S <up> and M-S <down>. This
> isn't listed, however, on the
> https://orgmode.org/manual/Structure-Editing.html page or the packaged
> info with org.el. ...at least so far as I can tell. Could this be
> added to one or both? I think the html manual is more used, but I
> don't know...

M-S-up/down does not look into headings. It simply moves current line
up/down, except when on a clock line or on a table line where it
performs other actions (documented in other sections in the manual)

So, the way you use it just happens to work for your Org
files. Presumably because your headings happen to have no contents.

I see no reason to put it into "structure editing" section of the
manual. Maybe somewhere else, but, as you see, the command does not do
what you use it for (or rather do it just for your specific
scenarios). So, I am not sure if we need to add this specific line
moving behavior into the manual at all.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>