> I do think it should be better documented. Attached is a patch for the documentation.
-- Paul
>From 0126cca49f2be223e53b3c290f1eca23e949377c Mon Sep 17 00:00:00 2001 From: Paul Bryan <[email protected]> Date: Tue, 30 Jun 2026 15:18:22 +1000 Subject: [PATCH] doc/org-manual.org: document noweb expansion suppressed in commented subtrees * doc/org-manual.org (Noweb Reference Syntax): document noweb expansion suppressed in commented subtrees TINYCHANGE Reported-by: "Grant Shoshin Shangreaux" <[email protected]> Link: https://list.orgmode.org/[email protected]/ --- doc/org-manual.org | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 9201a341a..9db5e1e8d 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -20244,7 +20244,9 @@ of that block. #+cindex: @samp{noweb}, header argument The =noweb= header argument controls expansion of noweb syntax references. Expansions occur when source code blocks are evaluated, -tangled, or exported. +tangled, or exported. However, if the block being referenced is under +a commented subtree (see [[*Comment Lines]]), the expansion does not +occur. - =no= :: -- 2.54.0
