how to set file and language default header args
authorEric Schulte <schulte.eric@gmail.com>
Fri, 29 Mar 2013 17:55:09 +0000 (11:55 -0600)
committerEric Schulte <schulte.eric@gmail.com>
Fri, 29 Mar 2013 17:55:56 +0000 (11:55 -0600)
org-contrib/babel/header-args.org
org-contrib/babel/index.org

index bb7c9db..ba596a2 100644 (file)
@@ -3,29 +3,13 @@
 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) noexport(n)
 #+TITLE:      Header arguments and result types in Org Babel
-#+AUTHOR:     Thorsten Jolitz
+#+AUTHOR:     Thorsten Jolitz, Eric Schulte
 #+EMAIL:      tj[at]data-driven[dot]de
 #+LANGUAGE:   en
-#+STYLE:      <style type="text/css">#outline-container-introduction{ clear:both; }</style>
-#+LINK_UP:    index.html
+#+LINK_UP:    index.php
 #+LINK_HOME:  http://orgmode.org/worg/
 #+EXPORT_EXCLUDE_TAGS: noexport
 
-# #+name: banner
-# #+begin_html
-#   <div id="subtitle" style="float: center; text-align: center;">
-#   <p>
-#   Org Mode support for <a href="http://picolisp.com/5000/!wiki?home/">PicoLisp</a>
-#   </p>
-#   <p>
-#   <a href="http://picolisp.com/5000/!wiki?home/">
-#   <img src="http://picolisp.com/5000/wiki/logo.png"/>
-#   </a>
-#   </p>
-#   </div>
-# #+end_html
-
-
 * Common combinations of header-args and result types
    Many combinations of header arguments and result types are
    supported by Org Babel. Individual languages may even define
     | :eval      | never    | query   |          |         |
 
 
+* Setting language and file specific default header argument values
+This may be useful to e.g., have all Python code blocks in a file use
+the same session.  The following file-local-variable syntax should be
+used, placing the customization at the end of the Org-mode file.
+
+: #+Title: Example of default file and language session
+: 
+: The value in this buffer is...
+: #+begin_src emacs-lisp
+:   org-babel-default-header-args:Python
+: #+end_src
+: 
+: #+RESULTS:
+: | (:session . foo) |
+: 
+: # Local Variables:
+: # eval: (setq-local org-babel-default-header-args:Python '((:session . "foo")))
+: # End:
index 8734eda..ef85e9c 100644 (file)
@@ -24,8 +24,8 @@ Schulte. The secondary author is Dan Davison.
   setup instructions, as well as an overview of the main features of
   Babel, with plenty of examples.
 - [[http://orgmode.org/manual/Working-With-Source-Code.html#Working-With-Source-Code][Reference and Documentation]]: is available online and in Chapter 14
-  of the Org-mode manual. A tabular listing of header args and result
-  types for Babel code blocks can be found [[file:header-args.org][here]].  
+  of the Org-mode manual. Some more information on using header args
+  and result types for Babel code blocks can be found [[file:header-args.org][here]].
 - [[file:languages.org][Languages]]: list of supported languages with information on
   requirements, configuration instructions, and pointers to language
   specific documentation.