- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

14.8.2.10 :noweb

The :noweb header argument controls expansion of “noweb” style (see section 14.10 Noweb reference syntax) references in a code block. This header argument can have one of three values: yes no or tangle.

yes
All “noweb” syntax references in the body of the code block will be expanded before the block is evaluated, tangled or exported.
no
The default. No “noweb” syntax specific action is taken on evaluating code blocks, However, noweb references will still be expanded during tangling.
tangle
All “noweb” syntax references in the body of the code block will be expanded before the block is tangled, however “noweb” references will not be expanded when the block is evaluated or exported.

Noweb prefix lines

Noweb insertions are now placed behind the line prefix of the <<reference>>. This behavior is illustrated in the following example. Because the <<example>> noweb reference appears behind the SQL comment syntax, each line of the expanded noweb reference will be commented.

This code block:

-- <<example>>

expands to:

-- this is the
-- multi-line body of example

Note that noweb replacement text that does not contain any newlines will not be affected by this change, so it is still possible to use inline noweb references.

ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition