From 787e2746a55a8506c3cd27466d5709cae1b78441 Mon Sep 17 00:00:00 2001 From: Dan Davison Date: Sun, 11 Apr 2010 12:42:43 -0400 Subject: [PATCH] Convert level 4 headings to subsubheadings. Also some promotion of some of the most deeply nested headings. --- doc/source-code-chapter.texi | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/doc/source-code-chapter.texi b/doc/source-code-chapter.texi index aeee0f545..90851c0aa 100644 --- a/doc/source-code-chapter.texi +++ b/doc/source-code-chapter.texi @@ -287,7 +287,7 @@ each more specific than the last. : 4 @end example -**** alternate argument syntax +@subsubheading alternate argument syntax :PROPERTIES: :CUSTOM_ID: alternate-argument-syntax :END: @@ -369,7 +369,7 @@ each more specific than the last. *Note:* only one option from each type may be supplied per source code block. -**** collection +@subsubheading collection :PROPERTIES: :CUSTOM_ID: header-argument-results-collection :END: @@ -388,7 +388,7 @@ each more specific than the last. block. This header argument places Org-babel in scripting mode. E.g., =:results output=. -**** type +@subsubheading type The following options are mutually exclusive and specify what type of results the code block will return. By default, results are inserted as either a *table* or *scalar* depending on their @@ -419,7 +419,7 @@ each more specific than the last. enclosed in a code block. This option currently supports Emacs Lisp, python, and ruby. E.g., =:results value pp=. -**** handling +@subsubheading handling The following results options indicate what Org-babel should do with the results once they are collected. @@ -479,7 +479,7 @@ each more specific than the last. #+end_src @end example -**** Remote execution +@subsubheading Remote execution A directory on a remote machine can be specified using [[http://www.gnu.org/software/tramp/#Filename-Syntax][tramp filename syntax]], in which case the code will be executed on the remote machine[fn:2]. An example is @@ -508,7 +508,7 @@ thanks to [[http://www.gnu.org/software/tramp/][tramp]]. Those using XEmacs, or version 23 may need to install tramp separately in order for the above features to work correctly. -**** Further points +@subsubheading Further points - If =:dir= is used in conjunction with =:session=, although it will determine the starting directory for a new session as expected, no attempt is currently made to alter the directory @@ -584,7 +584,7 @@ above features to work correctly. - =yes= :: all [[noweb-reference-syntax][noweb syntax]] references in the body of the source code block will be expanded before the block is evaluated. -**** Noweb Prefix Lines +@subsubheading Noweb Prefix Lines Noweb insertions are now placed behind the line prefix of the =<>=. @@ -652,8 +652,8 @@ above features to work correctly. non-session is returned to Org-mode as a table (a one- or two-dimensional vector of strings or numbers) when appropriate. -**** Non-session -***** =:results value= +@subsection Non-session +@subsubsection =:results value= This is the default. Internally, the value is obtained by wrapping the code in a function definition in the external language, and evaluating that function. Therefore, code should be @@ -665,21 +665,21 @@ above features to work correctly. This is the only one of the four evaluation contexts in which the code is automatically wrapped in a function definition. -***** =:results output= +@subsubsection =:results output= The code is passed to the interpreter as an external process, and the contents of the standard output stream are returned as text. (In certain languages this also contains the error output stream; this is an area for future work.) -**** =:session= -***** =:results value= +@subsection =:session= +@subsubsection =:results value= The code is passed to the interpreter running as an interactive Emacs inferior process. The result returned is the result of the last evaluation performed by the interpreter. (This is obtained in a language-specific manner: the value of the variable =_= in python and ruby, and the value of =.Last.value= in R). -***** =:results output= +@subsubsection =:results output= The code is passed to the interpreter running as an interactive Emacs inferior process. The result returned is the concatenation of the sequence of (text) output from the interactive @@ -688,6 +688,7 @@ above features to work correctly. non-interactive interpreter running as an external process. For example, compare the following two blocks: + @example #+begin_src python :results output print "hello"