From 9371465aabaf10fe948f4bf2e4f107a18eb958d5 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 5 Mar 2012 14:54:56 -0700 Subject: [PATCH] describe the ability to execute noweb references in the manual * doc/org.texi (Noweb reference syntax): Describe the ability to execute noweb references in the manual. --- doc/org.texi | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/org.texi b/doc/org.texi index 61e6707b0..170a55255 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -14057,6 +14057,14 @@ evaluation. If @code{:noweb no}, the default, then the reference is not expanded before evaluation. See the @ref{noweb-ref} header argument for a more flexible way to resolve noweb references. +It is possible to include the @emph{results} of a code block rather than the +body. This is done by appending parenthesis to the code block name which may +optionally contain arguments to the code block as shown below. + +@example +<> +@end example + Note: the default value, @code{:noweb no}, was chosen to ensure that correct code is not broken in a language, such as Ruby, where @code{<>} is a syntactically valid construct. If @code{<>} is not -- 2.11.4.GIT