From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thomas S. Dye" Subject: :cache documentation patch Date: Sat, 1 Jan 2011 11:33:35 -1000 Message-ID: Mime-Version: 1.0 (Apple Message framework v936) Content-Type: multipart/mixed; boundary=Apple-Mail-6--69680507 Return-path: Received: from [140.186.70.92] (port=38606 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PZ95E-0002bA-KL for emacs-orgmode@gnu.org; Sat, 01 Jan 2011 16:33:53 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PZ95C-0001d1-UI for emacs-orgmode@gnu.org; Sat, 01 Jan 2011 16:33:51 -0500 Received: from cpoproxy1-pub.bluehost.com ([69.89.21.11]:52872) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1PZ95C-0001cR-O5 for emacs-orgmode@gnu.org; Sat, 01 Jan 2011 16:33:50 -0500 Received: from cpe-66-91-68-127.hawaii.res.rr.com ([66.91.68.127] helo=[192.168.1.2]) by box472.bluehost.com with esmtpa (Exim 4.69) (envelope-from ) id 1PZ95A-00008L-4K for emacs-orgmode@gnu.org; Sat, 01 Jan 2011 14:33:48 -0700 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Org Mode --Apple-Mail-6--69680507 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Aloha all, The attached patch documents the behavior of the :cache header argument. All the best, Tom --Apple-Mail-6--69680507 Content-Disposition: attachment; filename=babel-cache-doc.patch Content-Type: application/octet-stream; x-unix-mode=0644; name="babel-cache-doc.patch" Content-Transfer-Encoding: 7bit Changes in HEAD Modified doc/org.texi diff --git a/doc/org.texi b/doc/org.texi index f324d04..35e79b7 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -12150,6 +12150,30 @@ executions of the code block. If the code block has not changed since the last time it was evaluated, it will not be re-evaluated. @end itemize +Code block caches notice if the value of a variable argument +to the code block has changed. If this is the case, the cache is +invalidated and the code block is re-run. In the following example, +@code{caller} will not be re-run unless the results of @code{random} have +changed since it was last run. + +@example + #+srcname: random + #+begin_src R :cache yes + runif(1) + #+end_src + + #+results[a2a72cd647ad44515fab62e144796432793d68e1]: random + 0.4659510825295 + + #+srcname: caller + #+begin_src emacs-lisp :var x=random :cache yes + x + #+end_src + + #+results[bec9c8724e397d5df3b696502df3ed7892fc4f5f]: caller + 0.254227238707244 +@end example + @node sep, hlines, cache, Specific header arguments @subsubsection @code{:sep} --Apple-Mail-6--69680507 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit --Apple-Mail-6--69680507 Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-orgmode mailing list Please use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode --Apple-Mail-6--69680507--