[PATCH] Proposal for «session» documentation

[PATCH] Proposal for «session» documentation

[Thierry Pellé]

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

Re: [PATCH] Proposal for «session» documentation

[Aaron Ecay]

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

Re: [PATCH] Proposal for «session» documentation

[Aaron Ecay]

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

Re: [PATCH] Proposal for «session» documentation

[abonnements]

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" ( :-) )

Re: [PATCH] Proposal for «session» documentation

[Achim Gratz]

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

Re: [PATCH] Proposal for «session» documentation

[Rasmus]

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