From mboxrd@z Thu Jan 1 00:00:00 1970 From: Aaron Ecay Subject: [PATCH 10/10] Document how :var introduces code block dependencies. Date: Mon, 1 Apr 2013 01:42:24 -0400 Message-ID: <1364794944-13826-11-git-send-email-aaronecay@gmail.com> References: <1364794944-13826-1-git-send-email-aaronecay@gmail.com> Return-path: Received: from eggs.gnu.org ([208.118.235.92]:37780) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UMXVz-0002w8-FW for emacs-orgmode@gnu.org; Mon, 01 Apr 2013 01:42:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UMXVu-0000xT-It for emacs-orgmode@gnu.org; Mon, 01 Apr 2013 01:42:43 -0400 Received: from mail-qa0-f53.google.com ([209.85.216.53]:38405) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UMXVu-0000xJ-Dl for emacs-orgmode@gnu.org; Mon, 01 Apr 2013 01:42:38 -0400 Received: by mail-qa0-f53.google.com with SMTP id k4so709597qaq.19 for ; Sun, 31 Mar 2013 22:42:38 -0700 (PDT) In-Reply-To: <1364794944-13826-1-git-send-email-aaronecay@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org * 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