From 926a24aab5963f96f1ce94c9c295e2c7c3273f27 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 2 Jan 2012 11:10:48 -0700 Subject: [PATCH] documentation of *org-babel-use-quick-and-dirty-noweb-expansion* * doc/org.texi (Noweb reference syntax): Adding documentation of the *org-babel-use-quick-and-dirty-noweb-expansion* variable. --- doc/org.texi | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/doc/org.texi b/doc/org.texi index 37817de18..6eb769a4a 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -13991,7 +13991,8 @@ When a code block is tangled or evaluated, whether or not ``noweb'' references are expanded depends upon the value of the @code{:noweb} header argument. If @code{:noweb yes}, then a Noweb reference is expanded before evaluation. If @code{:noweb no}, the default, then the reference is not -expanded before evaluation. +expanded before evaluation. See the @ref{noweb-ref} header argument for +a more flexible way to resolve noweb references. Note: the default value, @code{:noweb no}, was chosen to ensure that correct code is not broken in a language, such as Ruby, where @@ -13999,6 +14000,12 @@ correct code is not broken in a language, such as Ruby, where syntactically valid in languages that you use, then please consider setting the default value. +Note: if noweb tangling is slow in large Org-mode files consider setting the +@code{*org-babel-use-quick-and-dirty-noweb-expansion*} variable to true. +This will result in faster noweb reference resolution at the expense of not +correctly resolving inherited values of the @code{:noweb-ref} header +argument. + @node Key bindings and useful functions, Batch execution, Noweb reference syntax, Working With Source Code @section Key bindings and useful functions @cindex code block, key bindings -- 2.11.4.GIT