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

2013-03-31 Thread Aaron Ecay
* 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
+@uref{http://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




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

2013-04-03 Thread Eric Schulte
Aaron Ecay  writes:

> * doc/org.texi: Document how :var introduces code block dependencies.

I've committed this patch, although I then simplified your discussion of
code block re-execution.

Thanks!

-- 
Eric Schulte
http://cs.unm.edu/~eschulte