manual: Further rewrite :session doc.

* doc/org.texi (session): Spruce up.
This commit is contained in:
Aaron Ecay 2015-01-16 22:36:00 -05:00
parent b919d06ad7
commit d18ea6e30a
1 changed files with 12 additions and 9 deletions

View File

@ -15570,20 +15570,23 @@ execution.
@subsubsection @code{:session} @subsubsection @code{:session}
@cindex @code{:session}, src header argument @cindex @code{:session}, src header argument
The @code{:session} header argument starts a (possibly named) session for an interpreted The @code{:session} header argument starts a (possibly named) session for an
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. interpreted language where the interpreters 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 @itemize @bullet
@item @code{none} @item @code{none}
The default. Each block is evaluated in its own session. The session is The default. Each block is evaluated in its own interpreter process, which
not preserved after the evaluation. is terminated after the evaluation.
@item @code{other} @item @code{other}
Any other string passed to the @code{:session} header argument will give the 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 session a name. For example, @code{:session mysession}. If @code{:session}
to the language used in the block. All blocks with the same session name is given but no name string is specified, the session is named according to
share the same session. Using different session name enables concurrent the language used in the block. All blocks with the same session name share
sessions (even for the same interpreted language). E.g., @code{:session the same session. Using different session names enables concurrent sessions
mysession}. (even for the same interpreted language).
@end itemize @end itemize
@node noweb @node noweb