From: tsd@tsdye.com (Thomas S. Dye)
To: Sebastien Vauban
<public-wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@plane.gmane.org>
Cc: public-emacs-orgmode-mXXj517/zsQ@plane.gmane.org
Subject: Re: Two modifications for source blocks processing (will be in 7.9.2)
Date: Wed, 26 Sep 2012 10:47:14 -1000 [thread overview]
Message-ID: <m1lifwh5pp.fsf@tsdye.com> (raw)
In-Reply-To: <807grgmt8n.fsf@somewhere.org> (Sebastien Vauban's message of "Wed, 26 Sep 2012 22:20:08 +0200")
"Sebastien Vauban"
<wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@public.gmane.org> writes:
> Hi Thomas,
>
> A (very) quick answer...
>
> Thomas S. Dye wrote:
>> Sebastien Vauban writes:
>>> Bastien wrote:
>>>> this is to advertize two small modifications wrt source blocks
>>>> processing.
>>>>
>>>> 1) Please use ":results drawer" instead of ":results wrap" to insert
>>>> results like this:
>>>>
>>>> #+BEGIN_SRC emacs-lisp :results drawer
>>>> (message "a")
>>>> #+END_SRC
>>>>
>>>> #+RESULTS:
>>>> :RESULTS:
>>>> a
>>>> :END:
>>>
>>> OK. That name is clearly better!
>>>
>>>> 2) Support for ":results org" has been removed.
>>>
>>> Why don't we have anymore "#+begin/end_org" blocks while we still have
>>> "#+begin_html" and "#+begin_LaTeX" blocks? Org as the language seemed normal
>>> to insert blocks in Org-syntax.
>>>
>>> How will Org constructs be supported, for example headlines in the old
>>> "#+begin/end_org" blocks -- with the "," used for protecting the export?
>>>
>>> #+begin_src org
>>> ,* This is an headline
>>> ,This is some text.
>>> #+end_src
>>>
>>>> You can either insert the results with ":results raw" or "results drawer"
>>>> if you need to tell the exporter to include/exclude the results (by
>>>> including/excluding the :RESULTS: drawer from export.)
>>>
>>> Will ":RESULTS:" drawers be included by default, to mimic the current support
>>> of "#+begin/end_org" blocks?
>>
>> :results org was a synonym for :results raw
>
> No!
>
> With :results raw, the raw output is inserted directly into the Org mode
> buffer. This is a good option if your code block will output *Org mode
> formatted text* (this will even be fontified as Org text you would have typed
> yourself).
>
> As there are *no obvious markers to delimit the results* in the Org mode file,
> there is no way to know where raw results begin or end: raw results *cannot be
> removed* from the buffer.
>
> With :results org, raw Org mode results will be harmlessly *wrapped in a Org
> mode block*. The "#+begin/end_org" block wrapper makes it possible for the
> entirety of the results to be clearly located and replaced upon code block
> re-evaluation.
>
>> so I think "small change" here probably means that support for the synonym
>> was dropped.
>
> Hence, not a synonym.
>
Sorry. I must have looked at an old version of the manual.
>> #+begin/end_org blocks should still work with the :wrap header argument,
>> which hasn't been altered, IIUC.
>
> No. AFAICT:
>
> - "wrap" will disappear (renamed as "drawer"),
>
> - "drawer" is not the same as the old "org" option (as the results gets
> inserted into a drawer, not into a block).
Isn't it ":results wrap" that has disappeared? Will ":wrap org" also
disappear? Or, am I hopelessly confused?
All the best,
Tom
--
Thomas S. Dye
http://www.tsdye.com
next prev parent reply other threads:[~2012-09-26 20:47 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-09-26 7:44 Two modifications for source blocks processing (will be in 7.9.2) Bastien
2012-09-26 8:17 ` Sebastien Vauban
2012-09-26 9:09 ` Bastien
[not found] ` <1348655499.WXHGMQZGWMUF@spammotel.com>
2012-09-26 11:06 ` Bastien
2012-09-26 11:57 ` Nicolas Goaziou
2012-09-26 16:28 ` Thomas S. Dye
2012-09-26 20:20 ` Sebastien Vauban
2012-09-26 20:47 ` Thomas S. Dye [this message]
2012-09-26 20:51 ` Eric Schulte
2012-09-26 21:54 ` Bastien
2012-09-27 23:28 ` Thomas S. Dye
2012-09-27 5:34 ` Achim Gratz
2012-09-27 8:07 ` Bastien
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=m1lifwh5pp.fsf@tsdye.com \
--to=tsd@tsdye.com \
--cc=public-emacs-orgmode-mXXj517/zsQ@plane.gmane.org \
--cc=public-wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@plane.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).