ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

manual: Rewrite :session doc. 

* doc/org.texi (session): Spruce up.
This commit is contained in:
Thierry Pellé 2014-12-22 10:39:16 +01:00 committed by Aaron Ecay
parent d36bd8dc53
commit b919d06ad7
1 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/org.texi
View File

@ -15570,14 +15570,21 @@ execution.
@subsubsection @code{:session}
@cindex @code{:session}, src header argument
The @code{:session} header argument starts a session for an interpreted
language where state is preserved.
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.
By default, a session is not started.
A string passed to the @code{:session} header argument will give the session
a name. This makes it possible to run concurrent sessions for each
interpreted language.
@itemize @bullet
@item @code{none}
The default. Each block is evaluated in its own session. The session is
not preserved 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}.
@end itemize
@node noweb
@subsubsection @code{:noweb}