Ihor Radchenko <[email protected]> writes: > I think commented headings are pretty clear. They should be > ignored. That's the purpose of comment after all. Same with other > comment markup. The manual clearly says: > > Finally, a ‘COMMENT’ keyword at the beginning of an entry, but after > any other keyword or priority cookie, comments out the entire subtree. > In this case, the subtree is not exported and no code block within it is > executed either(1). The command below helps changing the comment status > of a headline.
Speaking of "pretty clear", about the attached patch? :) Rudy
>From 5f5a342f9b8603ed7e73297b553b8a95f753bfa0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rudolf=20Adamkovi=C4=8D?= <[email protected]> Date: Fri, 2 Jan 2026 13:18:40 +0100 Subject: [PATCH] doc/org-manual: Clarify COMMENT behavior with respect to tangling * doc/org-manual.org (Comment Lines): Explain how COMMENT suppresses not only source block execution but also tangling. --- doc/org-manual.org | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 64d739d77..f4aa6e2b3 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -12939,9 +12939,9 @@ ** Comment Lines Finally, a =COMMENT= keyword at the beginning of an entry, but after any other keyword or priority cookie, comments out the entire subtree. In this case, the subtree is not exported and no code block within it -is executed either[fn:: For a less drastic behavior, consider using a -select tag (see [[*Export Settings]]) instead.]. The command below -helps to change the comment status of a headline. +is executed or tangled[fn:: For less restrictive export limitations, +consider using a select tag (see [[*Export Settings]]) instead.]. The +command below helps to change the comment status of a headline. - {{{kbd(C-c ;)}}} (~org-toggle-comment~) :: #+kindex: C-c ; -- 2.50.1 (Apple Git-155)
-- "Simplicity is complexity resolved." --- Constantin Brâncuși, 1876-1957 Rudolf Adamkovič <[email protected]> [he/him] http://adamkovic.org
