mirrors
/
org-mode
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git
0
0
Fork 1
Code Releases Activity

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:
Eric Schulte 2012-01-02 11:10:48 -07:00
parent 15c2a50110
commit c2ee31fa44
1 changed files with 8 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/org.texi
View File

@ -14001,7 +14001,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
@ -14009,6 +14010,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