forked from mirrors/org-mode
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.
This commit is contained in:
parent
89169dff4c
commit
926a24aab5
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue