diff options
author | Eric Schulte <eric.schulte@gmx.com> | 2012-01-02 11:10:48 -0700 |
---|---|---|
committer | Bastien Guerry <bzg@altern.org> | 2012-01-03 09:20:07 +0100 |
commit | 926a24aab5963f96f1ce94c9c295e2c7c3273f27 (patch) | |
tree | 2b877af4fa672d7a52e1b8209713bb5f61b36a62 | |
parent | 89169dff4cce045d82d2a4cb6880611d5e0029f9 (diff) | |
download | org-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.texi | 9 |
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 |