mirrors/org-mode
0
0
Fork 1
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-07-16 10:46:27 +00:00
Code Releases Activity

documentation of *org-babel-use-quick-and-dirty-noweb-expansion*

Browse source 
* 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 references are expanded depends upon the value of the @code{:noweb} header
argument. If @code{:noweb yes}, then a Noweb reference is expanded before argument. If @code{:noweb yes}, then a Noweb reference is expanded before
evaluation. If @code{:noweb no}, the default, then the reference is not 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 Note: the default value, @code{:noweb no}, was chosen to ensure that
correct code is not broken in a language, such as Ruby, where 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 syntactically valid in languages that you use, then please consider setting
the default value. 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 @node Key bindings and useful functions, Batch execution, Noweb reference syntax, Working With Source Code
@section Key bindings and useful functions @section Key bindings and useful functions
@cindex code block, key bindings @cindex code block, key bindings