emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Rudolf Adamkovič" <rudolf@adamkovic.org>
To: emacs-orgmode@gnu.org
Subject: Noisy and unreliable (de-)tangling
Date: Mon, 21 Oct 2024 23:04:41 +0200	[thread overview]
Message-ID: <m27ca1cgly.fsf@adamkovic.org> (raw)

Howdy!

So, I started (de-)tangling heavily, to get some "IDE" support, and
oh-my, what a buggy mess it is.  Not only are tangling comments
super-noisy, the `org-babel-detangle' function is *unreliable*.  If
multiple sections have the same title, such as "Implementation", it
leads to *data loss*.

I think we should rethink this functionality with *readability* and
*reliability* in mind.  The best solution, perhaps, would be to use IDs
for `:comments yes' if `org-id-link-to-org-use-id' is set.  Otherwise,
require `#+NAME', or some other reliable mechanism.  For example:

# >>> TANGLE: <id>
...
# <<< TANGLE: <id>

(Python '#' comments shown above.)

What do you think?

Also ... anyone with some spare time on their hands? :)

P.S. As a cherry on top, it would be also nice to have a minor mode that
highlights tangling comments, jumps back to the relevant Org heading,
etc.

Rudy
-- 
"The introduction of suitable abstractions is our only mental aid to
organize and master complexity."  --- Edsger Wybe Dijkstra, 1930-2002

Rudolf Adamkovič <rudolf@adamkovic.org> [he/him]
http://adamkovic.org


             reply	other threads:[~2024-10-21 21:05 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-10-21 21:04 Rudolf Adamkovič [this message]
2024-10-22 15:49 ` Noisy and unreliable (de-)tangling Ihor Radchenko
2024-10-28 22:18   ` Rudolf Adamkovič
2024-10-29 19:09     ` Ihor Radchenko

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m27ca1cgly.fsf@adamkovic.org \
    --to=rudolf@adamkovic.org \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).