summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRick Frankel <rick@rickster.com>2013-04-07 13:45:18 -0400
committerRick Frankel <rick@rickster.com>2013-04-07 13:45:18 -0400
commitbf1f08cd41c43e351dbd56343d23a7379550c49e (patch)
treea68102e260254ba7196ddecb9927572512c73b61
parentb162dd43dbf7a0dea622087dc4801b062649615d (diff)
downloadorg-mode-bf1f08cd41c43e351dbd56343d23a7379550c49e.tar.gz
Break out description of results parameter into four section instead
of three, matching the actual code. * doc/org.texi (results): Add Format section (broken out of Type section to match code. (hlines): Remove (incorrect) Emacs Lisp exception. (colnames): Remove (incorrect) Emacs Lisp exception. Note that the actual default handling (at least for python and emacs-lisp) does not seem to match the description.
-rw-r--r--doc/org.texi22
1 files changed, 16 insertions, 6 deletions
diff --git a/doc/org.texi b/doc/org.texi
index 945bcf7..6c34fd8 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -13516,7 +13516,7 @@ Emacs Lisp, as shown in the following example.
@node results, file, var, Specific header arguments
@subsubsection @code{:results}
-There are three classes of @code{:results} header argument. Only one option
+There are four classes of @code{:results} header argument. Only one option
per class may be supplied per code block.
@itemize @bullet
@@ -13525,6 +13525,10 @@ per class may be supplied per code block.
from the code block
@item
@b{type} header arguments specify what type of result the code block will
+return---which has implications for how they will be processed before
+insertion into the Org mode buffer
+@item
+@b{format} header arguments specify what type of result the code block will
return---which has implications for how they will be inserted into the
Org mode buffer
@item
@@ -13570,6 +13574,15 @@ buffer as quoted text. E.g., @code{:results value verbatim}.
@item @code{file}
The results will be interpreted as the path to a file, and will be inserted
into the Org mode buffer as a file link. E.g., @code{:results value file}.
+@end itemize
+
+@subsubheading Format
+
+The following options are mutually exclusive and specify what type of results
+the code block will return. By default, results are inserted accoring to the
+type as specified above.
+
+@itemize @bullet
@item @code{raw}
The results are interpreted as raw Org mode code and are inserted directly
into the buffer. If the results look like a table they will be aligned as
@@ -14004,8 +14017,7 @@ values @code{yes} or @code{no}, with a default value of @code{no}.
Strips horizontal lines from the input table. In most languages this is the
desired effect because an @code{hline} symbol is interpreted as an unbound
variable and raises an error. Setting @code{:hlines no} or relying on the
-default value yields the following results. Note that the @code{:hline}
-header argument has no effect for Emacs Lisp code blocks.
+default value yields the following results.
@example
#+TBLNAME: many-cols
@@ -14057,9 +14069,7 @@ Leaves hlines in the table. Setting @code{:hlines yes} has this effect.
The @code{:colnames} header argument accepts the values @code{yes},
@code{no}, or @code{nil} for unassigned. The default value is @code{nil}.
Note that the behavior of the @code{:colnames} header argument may differ
-across languages. For example Emacs Lisp code blocks ignore the
-@code{:colnames} header argument entirely given the ease with which tables
-with column names may be handled directly in Emacs Lisp.
+across languages.
@itemize @bullet
@item @code{nil}