Re: [O] [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