From mboxrd@z Thu Jan 1 00:00:00 1970 From: th@evon.thierry-pelle.eu (Thierry =?utf-8?Q?Pell=C3=A9?=) Subject: [PATCH] Second proposal for ":session" doc Date: Sun, 07 Dec 2014 11:51:33 +0100 Message-ID: <86388r3f7u.fsf@Evon.thierry-pelle.eu> Reply-To: abonnements@thierry-pelle.eu Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57345) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxZRM-0000RA-SH for emacs-orgmode@gnu.org; Sun, 07 Dec 2014 05:51:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxZRG-0003UY-MY for emacs-orgmode@gnu.org; Sun, 07 Dec 2014 05:51:48 -0500 Received: from modem.thierry-pelle.eu ([109.190.80.161]:54348 helo=Evon.thierry-pelle.eu) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxZRG-0003Ty-Eq for emacs-orgmode@gnu.org; Sun, 07 Dec 2014 05:51:42 -0500 Received: from th by Evon.thierry-pelle.eu with local (Exim 4.84) (envelope-from ) id 1XxZR7-0000hR-Qa for emacs-orgmode@gnu.org; Sun, 07 Dec 2014 11:51:34 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hi, here is a proposal for some change on the ":session" header doc. Comments are welcome! Thierry diff --git a/doc/org.texi b/doc/org.texi index c1e84d4..45e177e 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -15566,7 +15566,9 @@ execution. @cindex @code{:session}, src header argument The @code{:session} header argument starts a session for an interpreted -language where state is preserved. By default, a session is not started. +language. All code block of this langage is executed into the same +interpreter process, the state of the session being preserved as long as Emacs +runs. By default, a session is not started. @itemize @bullet @item @code{none} @@ -15574,9 +15576,9 @@ 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. 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 (possibly empty). All blocks with the same session name share +the same session. Using different session name enables concurrent sessions +(for the same interpreted language). E.g., @code{:session mysession} or @code{:session}. @end itemize @node noweb