diff options
author | Aaron Ecay <aaronecay@gmail.com> | 2015-01-16 22:36:00 -0500 |
---|---|---|
committer | Aaron Ecay <aaronecay@gmail.com> | 2015-01-16 22:37:48 -0500 |
commit | d18ea6e30a81e1405db25f98ff2feeaf439edebe (patch) | |
tree | 28250fac48510c826ac85136f7a62abf83bd5f39 | |
parent | b919d06ad73bb9e6141c7d920add97ce22e84ff8 (diff) | |
download | org-mode-d18ea6e30a81e1405db25f98ff2feeaf439edebe.tar.gz |
manual: Further rewrite :session doc.
* doc/org.texi (session): Spruce up.
-rw-r--r-- | doc/org.texi | 21 |
1 files changed, 12 insertions, 9 deletions
diff --git a/doc/org.texi b/doc/org.texi index b588d3c..f6b30f8 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -15570,20 +15570,23 @@ execution. @subsubsection @code{:session} @cindex @code{:session}, src header argument -The @code{:session} header argument starts a (possibly named) session for an interpreted -language where state is preserved. All code blocks sharing the same name are exectuted by the same interpreter process. By default, a session is not started. +The @code{:session} header argument starts a (possibly named) session for an +interpreted language where the interpreter’s state is preserved. All code +blocks sharing the same name are exectuted by the same interpreter process. +By default, a session is not started. @itemize @bullet @item @code{none} -The default. Each block is evaluated in its own session. The session is -not preserved after the evaluation. +The default. Each block is evaluated in its own interpreter process, which +is terminated after the evaluation. @item @code{other} Any other string passed to the @code{:session} header argument will give the -session a name. If the given name is empty, the session is named according -to the language used in the block. All blocks with the same session name -share the same session. Using different session name enables concurrent -sessions (even for the same interpreted language). E.g., @code{:session -mysession}. +session a name. For example, @code{:session mysession}. If @code{:session} +is given but no name string is specified, the session is named according to +the language used in the block. All blocks with the same session name share +the same session. Using different session names enables concurrent sessions +(even for the same interpreted language). + @end itemize @node noweb |