From d18ea6e30a81e1405db25f98ff2feeaf439edebe Mon Sep 17 00:00:00 2001 From: Aaron Ecay Date: Fri, 16 Jan 2015 22:36:00 -0500 Subject: [PATCH] manual: Further rewrite :session doc. * doc/org.texi (session): Spruce up. --- doc/org.texi | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index b588d3c3a..f6b30f8fe 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