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: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:57345)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <th@evon.thierry-pelle.eu>) 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 <th@evon.thierry-pelle.eu>) 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 <th@evon.thierry-pelle.eu>) 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 <th@evon.thierry-pelle.eu>) id 1XxZR7-0000hR-Qa
	for emacs-orgmode@gnu.org; Sun, 07 Dec 2014 11:51:34 +0100
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=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