doc: more explicit about the mechanism through which interactive evaluation of code is performed

Thanks to Herbert Sitz for stressing the importance of this point.

* doc/org.texi (Results of evaluation): More explicit about the
  mechanism through which interactive evaluation of code is performed.
This commit is contained in:
Eric Schulte 2011-06-21 11:05:02 -07:00
parent 3f3fc513b7
commit d315f253d4
1 changed files with 13 additions and 5 deletions

View File

@ -12789,11 +12789,19 @@ future work.)
@subsection Session @subsection Session
@subsubsection @code{:results value} @subsubsection @code{:results value}
The code is passed to the interpreter running as an interactive Emacs The code is passed to an interpreter running as an interactive Emacs inferior
inferior process. The result returned is the result of the last evaluation process. Only languages which provide tools for interactive evaluation of
performed by the interpreter. (This is obtained in a language-specific code have session support, so some language (e.g., C and ditaa) do not
manner: the value of the variable @code{_} in Python and Ruby, and the value support the @code{:session} header argument, and in other languages (e.g.,
of @code{.Last.value} in R). Python and Haskell) which have limitations on the code which may be entered
into interactive sessions, those limitations apply to the code in code blocks
using the @code{:session} header argument as well.
Unless the @code{:results output} option is supplied (see below) 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 @code{_} in Python and Ruby, and the value of @code{.Last.value}
in R).
@subsubsection @code{:results output} @subsubsection @code{:results output}
The code is passed to the interpreter running as an interactive Emacs The code is passed to the interpreter running as an interactive Emacs