From mboxrd@z Thu Jan 1 00:00:00 1970 From: Aaron Ecay Subject: Re: [PATCH] Second proposal for ":session" doc Date: Wed, 10 Dec 2014 16:58:00 -0500 Message-ID: <87d27r417b.fsf@gmail.com> References: <86388r3f7u.fsf@Evon.thierry-pelle.eu> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38627) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XypGm-0006p0-Ry for emacs-orgmode@gnu.org; Wed, 10 Dec 2014 16:58:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XypGl-0005sf-C1 for emacs-orgmode@gnu.org; Wed, 10 Dec 2014 16:58:04 -0500 Received: from mail-qc0-x229.google.com ([2607:f8b0:400d:c01::229]:36717) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XypGl-0005sU-6R for emacs-orgmode@gnu.org; Wed, 10 Dec 2014 16:58:03 -0500 Received: by mail-qc0-f169.google.com with SMTP id w7so2917625qcr.0 for ; Wed, 10 Dec 2014 13:58:02 -0800 (PST) In-Reply-To: <86388r3f7u.fsf@Evon.thierry-pelle.eu> 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: abonnements@thierry-pelle.eu, emacs-orgmode@gnu.org Hi Thierry, 2014ko abenudak 7an, Thierry Pell=C3=A9-ek idatzi zuen: >=20 > Hi, here is a proposal for some change on the ":session" header doc. >=20 > Comments are welcome! > Thierry >=20 >=20 > 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=20 > 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 ^ ^^ ^^^^ 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 quite= accurate =E2=80=93 it=E2=80=99s until the interpreter process exits, which could happen becaus= e the user kills it, it crashes, a piece of code which is executed tells it to exit, ... >=20=20 > @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 I think something should be said like =E2=80=9CIf the session name is empty= , 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 leaving :session empty does not generate a buffer named =E2=80=9C=E2=80=9D (the emp= ty string). (It=E2=80=99s also a perverse but true fact that if you specify the same se= ssion 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 sessi= ons > +(for the same interpreted language). E.g., @code{:session mysession} or= @code{:session}. > @end itemize >=20=20 > @node noweb Thanks, --=20 Aaron Ecay PhD candidate, Linguistics University of Pennsylvania