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

[Ihor Radchenko <yantar92@posteo.net>]

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>