emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [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).