emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Request for addition to "structure editing" manual section
@ 2024-08-29 14:42 Tim Braun
  2024-09-01 16:45 ` Ihor Radchenko
  0 siblings, 1 reply; 2+ messages in thread
From: Tim Braun @ 2024-08-29 14:42 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

[-- 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 --]

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: Request for addition to "structure editing" manual section
  2024-08-29 14:42 Request for addition to "structure editing" manual section Tim Braun
@ 2024-09-01 16:45 ` Ihor Radchenko
  0 siblings, 0 replies; 2+ messages in thread
From: Ihor Radchenko @ 2024-09-01 16:45 UTC (permalink / raw)
  To: Tim Braun; +Cc: emacs-orgmode@gnu.org

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>


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2024-09-01 16:45 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-08-29 14:42 Request for addition to "structure editing" manual section Tim Braun
2024-09-01 16:45 ` Ihor Radchenko

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).