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: [no followups] expand[flat|nested] mbox.gz Atom feed
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).