From mboxrd@z Thu Jan 1 00:00:00 1970 From: abonnements Subject: Re: [PATCH] Second proposal for ":session" doc Date: Thu, 11 Dec 2014 08:46:06 +0100 Message-ID: <54894BBE.4080800@thierry-pelle.eu> References: <86388r3f7u.fsf@Evon.thierry-pelle.eu> <87d27r417b.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48096) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyySC-0007zU-5h for emacs-orgmode@gnu.org; Thu, 11 Dec 2014 02:46:36 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XyyS3-0007hy-E5 for emacs-orgmode@gnu.org; Thu, 11 Dec 2014 02:46:28 -0500 Received: from 18.mo1.mail-out.ovh.net ([46.105.35.72]:41821 helo=mo1.mail-out.ovh.net) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyyS3-0007hh-4k for emacs-orgmode@gnu.org; Thu, 11 Dec 2014 02:46:19 -0500 Received: from mail26.ha.ovh.net (gw6.ovh.net [213.251.189.206]) by mo1.mail-out.ovh.net (Postfix) with SMTP id 86246FFB6D9 for ; Thu, 11 Dec 2014 08:46:12 +0100 (CET) In-Reply-To: <87d27r417b.fsf@gmail.com> 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 Hello thanks for this. > ^ ^^ ^^^ Sorry, but my English needs to be improved, but my French is not even=20 better :-D > "...it=E2=80=99s until the interpreter process exit..." I will use your reformulation; I know just a little about the background=20 or the internals. > =E2=80=9CIf the session name is empty, a default name based on the blo= ck=E2=80=99s=20 language will be used.=E2=80=9D Same as previous, I din't know that. Thanks. Le 10/12/2014 22:58, Aaron Ecay a =C3=A9crit : > Hi Thierry, > > 2014ko abenudak 7an, Thierry Pell=C3=A9-ek idatzi zuen: >> 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 >> =20 >> The @code{:session} header argument starts a session for an interpre= ted >> -language where state is preserved. By default, a session is not star= ted. >> +language. All code block of this langage is executed into the same > ^ ^^ ^^^^ > s are by >> +interpreter process, the state of the session being preserved as long= as Emacs > ^ ^^^^^ > Start a new sentence here, and change to is >> +runs. By default, a session is not started. > On a substantive note, =E2=80=9Cas long as Emacs runs=E2=80=9D is not q= uite accurate =E2=80=93 > it=E2=80=99s until the interpreter process exits, which could happen be= cause the > user kills it, it crashes, a piece of code which is executed tells it t= o > exit, ... > >> =20 >> @itemize @bullet >> @item @code{none} >> @@ -15574,9 +15576,9 @@ The default. Each block is evaluated in its o= wn 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 (e= ven for >> -the same interpreted language). E.g., @code{:session mysession}. >> +session a name (possibly empty). All blocks with the same session na= me share > I think something should be said like =E2=80=9CIf the session name is e= mpty, a > default name based on the block=E2=80=99s language will be used.=E2=80=9D= The session > name also becomes the interpreter process=E2=80=99s buffer name, and le= aving > :session empty does not generate a buffer named =E2=80=9C=E2=80=9D (the= empty string). > > (It=E2=80=99s also a perverse but true fact that if you specify the sam= e session > name for two blocks of different languages, they will both send their > code to the same interpreter process. But for two blocks in different > languages with an empty :session, they will each use their language=E2=80= =99s > default name.) > >> +the same session. Using different session name enables concurrent se= ssions >> +(for the same interpreted language). E.g., @code{:session mysession}= or @code{:session}. >> @end itemize >> =20 >> @node noweb > Thanks, >