summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Schulte <eric.schulte@gmx.com>2012-01-02 11:10:48 -0700
committerBastien Guerry <bzg@altern.org>2012-01-03 09:20:07 +0100
commit926a24aab5963f96f1ce94c9c295e2c7c3273f27 (patch)
tree2b877af4fa672d7a52e1b8209713bb5f61b36a62
parent89169dff4cce045d82d2a4cb6880611d5e0029f9 (diff)
downloadorg-mode-926a24aab5963f96f1ce94c9c295e2c7c3273f27.tar.gz
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.
-rw-r--r--doc/org.texi9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/org.texi b/doc/org.texi
index 37817de..6eb769a 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