From: Aaron Ecay <aaronecay@gmail.com>
To: abonnements@thierry-pelle.eu, emacs-orgmode@gnu.org
Subject: Re: [PATCH] Second proposal for ":session" doc
Date: Wed, 10 Dec 2014 16:58:00 -0500 [thread overview]
Message-ID: <87d27r417b.fsf@gmail.com> (raw)
In-Reply-To: <86388r3f7u.fsf@Evon.thierry-pelle.eu>
Hi Thierry,
2014ko abenudak 7an, Thierry Pellé-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
>
> 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, “as long as Emacs runs” is not quite accurate –
it’s until the interpreter process exits, which could happen because the
user kills it, it crashes, a piece of code which is executed tells it to
exit, ...
>
> @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 “If the session name is empty, a
default name based on the block’s language will be used.” The session
name also becomes the interpreter process’s buffer name, and leaving
:session empty does not generate a buffer named “” (the empty string).
(It’s also a perverse but true fact that if you specify the same 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’s
default name.)
> +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
Thanks,
--
Aaron Ecay
PhD candidate, Linguistics
University of Pennsylvania
next prev parent reply other threads:[~2014-12-10 21:58 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-12-07 10:51 [PATCH] Second proposal for ":session" doc Thierry Pellé
2014-12-10 21:58 ` Aaron Ecay [this message]
2014-12-11 7:46 ` abonnements
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87d27r417b.fsf@gmail.com \
--to=aaronecay@gmail.com \
--cc=abonnements@thierry-pelle.eu \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.