emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[O] [PATCH 10/10] Document how :var introduces code block dependencies.


From: Aaron Ecay
Subject: [O] [PATCH 10/10] Document how :var introduces code block dependencies.
Date: Mon, 1 Apr 2013 01:42:24 -0400

* doc/org.texi: Document how :var introduces code block dependencies.
---
 doc/org.texi | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/org.texi b/doc/org.texi
index 6791570..dda922e 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -13211,6 +13211,15 @@ include anything in the Org mode file that takes a 
@code{#+NAME:},
 @code{#+BEGIN_EXAMPLE} blocks, other code blocks, and the results of other
 code blocks.
 
+When a reference is made to another code block, the referenced block will be
+evaluated whenever needed, in order to supply its value to the referencing
+block.  If the referenced block is cached (see @ref{cache}), its value will
+be reused if possible, instead of being re-calculated.  If the referring code
+block is cached, its hash value will depend on the value of all the code
+blocks it references.  This system can thus be used to create a system of
+as-needed re-evaluation among code blocks similar to that provided by
address@hidden://yihui.name/knitr/, knitr} or Sweave.
+
 Argument values can be indexed in a manner similar to arrays (see @ref{var,
 Indexable variable values}).
 
-- 
1.8.2




reply via email to

[Prev in Thread] Current Thread [Next in Thread]