[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] [PATCH] Proposal for «session» documentation
From: |
Aaron Ecay |
Subject: |
Re: [O] [PATCH] Proposal for «session» documentation |
Date: |
Sun, 21 Dec 2014 22:27:20 -0500 |
User-agent: |
Notmuch/0.18.1+51~gbbbdf04 (http://notmuchmail.org) Emacs/25.0.50.2 (x86_64-unknown-linux-gnu) |
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