* [PATCH] Proposal for «session» documentation
@ 2014-12-21 9:54 Thierry Pellé
2014-12-22 3:27 ` Aaron Ecay
2014-12-22 10:50 ` Rasmus
0 siblings, 2 replies; 6+ messages in thread
From: Thierry Pellé @ 2014-12-21 9:54 UTC (permalink / raw)
To: emacs-orgmode, aaronecay
Hi,
I added description for empty names and used the suggestion of Aaron.
Hope it's not too frenchy ;-)
diff --git a/doc/org.texi b/doc/org.texi
index 3612bba..72ad0d9 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -15559,8 +15559,8 @@ execution.
@subsubsection @code{:session}
@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.
+The @code{:session} header argument starts a (possibly named) session for an interpreted
+language where state is preserved. All code blocks sharing the same name are exectuted by the same interpreter process. By default, a session is not started.
@itemize @bullet
@item @code{none}
@@ -15568,9 +15568,10 @@ 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. If the given name is empty, the session is named as the
+language used in the block. 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}.
@end itemize
@node noweb
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] Proposal for «session» documentation
2014-12-21 9:54 [PATCH] Proposal for «session» documentation Thierry Pellé
@ 2014-12-22 3:27 ` Aaron Ecay
[not found] ` <5497D44F.9040105@thierry-pelle.eu>
2014-12-22 10:50 ` Rasmus
1 sibling, 1 reply; 6+ messages in thread
From: Aaron Ecay @ 2014-12-22 3:27 UTC (permalink / raw)
To: abonnements, emacs-orgmode
Hi Thierry,
Juts a two comments and one question.
2014ko abenudak 21an, Thierry Pellé-ek idatzi zuen:
>
> Hi,
> I added description for empty names and used the suggestion of Aaron.
>
> Hope it's not too frenchy ;-)
>
>
> diff --git a/doc/org.texi b/doc/org.texi
> index 3612bba..72ad0d9 100644
> --- a/doc/org.texi
> +++ b/doc/org.texi
> @@ -15559,8 +15559,8 @@ execution.
> @subsubsection @code{:session}
> @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.
> +The @code{:session} header argument starts a (possibly named) session for an interpreted
> +language where state is preserved. All code blocks sharing the same name are exectuted by the same interpreter process. By default, a session is not started.
>
> @itemize @bullet
> @item @code{none}
> @@ -15568,9 +15568,10 @@ 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. If the given name is empty, the session is named as the
“according to” instead of “as”
> +language used in the block. 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}.
I would move the “e.g.” directly after the sentence which ends “give the
session a name.”
Can you send a patch generated with “git format-patch”? This way you
can write and include a commit message. The procedure is described
here: <http://orgmode.org/worg/org-contribute.html#unnumbered-4>.
Thanks,
--
Aaron Ecay
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Proposal for «session» documentation
2014-12-21 9:54 [PATCH] Proposal for «session» documentation Thierry Pellé
2014-12-22 3:27 ` Aaron Ecay
@ 2014-12-22 10:50 ` Rasmus
1 sibling, 0 replies; 6+ messages in thread
From: Rasmus @ 2014-12-22 10:50 UTC (permalink / raw)
To: emacs-orgmode
Hi,
th@evon.thierry-pelle.eu (Thierry Pellé) writes:
Thanks for the patch. In addition to Aaron's comments I think there's a typo.
> diff --git a/doc/org.texi b/doc/org.texi
> index 3612bba..72ad0d9 100644
> --- a/doc/org.texi
> +++ b/doc/org.texi
> @@ -15559,8 +15559,8 @@ execution.
> @subsubsection @code{:session}
> @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.
> +The @code{:session} header argument starts a (possibly named) session for an interpreted
> +language where state is preserved.
^^^^^ "the state" or "states". Also state of what?
Computations?
Maybe "where computations and variables are preserved", or
something like that...
> All code blocks sharing the same name are exectuted by the same interpreter process. By default, a session is not started.
—Rasmus
--
Dobbelt-A
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Proposal for «session» documentation
[not found] ` <5497EB3A.2050906@thierry-pelle.eu>
@ 2015-01-17 3:48 ` Aaron Ecay
2015-01-17 7:20 ` abonnements
0 siblings, 1 reply; 6+ messages in thread
From: Aaron Ecay @ 2015-01-17 3:48 UTC (permalink / raw)
To: abonnements; +Cc: Org-mode
Hi Thierry,
2014ko abenudak 22an, abonnements-ek idatzi zuen:
>
> Is this better?
I’m very sorry, I lost track of your email over the winter holidays and
am only now coming back to it. What’s more, you sent the latest patch
only to me and not the org list, so no one else was keeping an eye on it
either.
I think the patch looks good. I just pushed it to the master branch of
the org mode repository, along with a few other tweaks.
Thanks for your contribution,
--
Aaron Ecay
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Proposal for «session» documentation
2015-01-17 3:48 ` Aaron Ecay
@ 2015-01-17 7:20 ` abonnements
2015-01-17 9:39 ` Achim Gratz
0 siblings, 1 reply; 6+ messages in thread
From: abonnements @ 2015-01-17 7:20 UTC (permalink / raw)
To: Org-mode
Hi!
Le 17/01/2015 04:48, Aaron Ecay a écrit :
> Hi Thierry,
>
> 2014ko abenudak 22an, abonnements-ek idatzi zuen:
>> Is this better?
> I’m very sorry, I lost track of your email over the winter holidays and
> am only now coming back to it. What’s more, you sent the latest patch
> only to me and not the org list, so no one else was keeping an eye on it
> either.
Sorry about it...
>
> I think the patch looks good. I just pushed it to the master branch of
> the org mode repository, along with a few other tweaks.
>
> Thanks for your contribution,
>
Your welcome !
Thierry
PS: sorry to be curious but I can't figure out is the language behind
"2014ko abenudak 22an, abonnements-ek idatzi zuen" ( :-) )
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Proposal for «session» documentation
2015-01-17 7:20 ` abonnements
@ 2015-01-17 9:39 ` Achim Gratz
0 siblings, 0 replies; 6+ messages in thread
From: Achim Gratz @ 2015-01-17 9:39 UTC (permalink / raw)
To: emacs-orgmode
abonnements writes:
> PS: sorry to be curious but I can't figure out is the language behind
> "2014ko abenudak 22an, abonnements-ek idatzi zuen" ( :-) )
Basque.
Regards,
Achim.
--
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+
SD adaptation for Waldorf rackAttack V1.04R1:
http://Synth.Stromeko.net/Downloads.html#WaldorfSDada
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2015-01-17 9:39 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-12-21 9:54 [PATCH] Proposal for «session» documentation Thierry Pellé
2014-12-22 3:27 ` Aaron Ecay
[not found] ` <5497D44F.9040105@thierry-pelle.eu>
[not found] ` <CAFcZrT3mbz2Ny6Ge-axJ5UKzN_3qGYJippywGSxLgEUk=6T4Xw@mail.gmail.com>
[not found] ` <5497EB3A.2050906@thierry-pelle.eu>
2015-01-17 3:48 ` Aaron Ecay
2015-01-17 7:20 ` abonnements
2015-01-17 9:39 ` Achim Gratz
2014-12-22 10:50 ` Rasmus
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).