Documentation patch

From: "Thomas S. Dye" <tsd@tsdye.com>
To: Org Mode <emacs-orgmode@gnu.org>
Subject: Documentation patch
Date: Sat, 1 Jan 2011 10:21:40 -1000	[thread overview]
Message-ID: <C9BC9C2A-55E4-4F86-9483-290749F85497@tsdye.com> (raw)


[-- Attachment #1.1: Type: text/plain, Size: 218 bytes --]

Aloha all,

The attached patch documents multi-line headers for source code blocks:



Thomas S. Dye, Ph.D.
T. S. Dye & Colleagues, Archaeologists, Inc.
Phone: (808) 529-0866 Fax: (808) 529-0884
http://www.tsdye.com



[-- Attachment #1.2.1: Type: text/html, Size: 256 bytes --]

[-- Attachment #1.2.2: babel-multi-line-header.patch --]
[-- Type: application/octet-stream, Size: 1170 bytes --]

Changes in HEAD
	Modified doc/org.texi

diff --git a/doc/org.texi b/doc/org.texi
index f324d04..efa892e 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -11601,6 +11601,33 @@ Similarly, it is possible to set header arguments for inline code blocks:
 src_haskell[:exports both]@{fac 5@}
 @end example
 
+Code block header arguments can span multiple lines using =#+header:= or
+=#+headers:= lines preceding a code block or nested in between the name and
+body of a named code block.
+
+Multi-line header arguments on an un-named code block:
+@example
+ #+headers: :var data1=1
+ #+begin_src emacs-lisp :var data2=2
+   (message "data1:%S, data2:%S" data1 data2)
+ #+end_src
+
+ #+results:
+ : data1:1, data2:2
+@end example
+
+Multi-line header arguments on a named code block:
+@example
+   #+source: named-block
+   #+header: :var data=2
+   #+begin_src emacs-lisp
+     (message "data:%S" data)
+   #+end_src
+
+   #+results: named-block
+   : data:2
+@end example
+
 @node Header arguments in function calls,  , Code block specific header arguments, Using header arguments
 @comment  node-name,  next,  previous,  up
 @subsubheading Header arguments in function calls


[-- Attachment #1.2.3: Type: text/html, Size: 2109 bytes --]

[-- Attachment #2: Type: text/plain, Size: 201 bytes --]

_______________________________________________
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
