From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: Two modifications for source blocks processing (will be in 7.9.2) Date: Thu, 27 Sep 2012 13:28:00 -1000 Message-ID: References: <876271cjpb.fsf@bzg.ath.cx> <80haql8afw.fsf@somewhere.org> <807grgmt8n.fsf@somewhere.org> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:43333) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1THNVI-0005lO-UN for emacs-orgmode@gnu.org; Thu, 27 Sep 2012 19:28:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1THNVH-0001sZ-Ex for emacs-orgmode@gnu.org; Thu, 27 Sep 2012 19:28:24 -0400 Received: from plane.gmane.org ([80.91.229.3]:39626) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1THNVH-0001sD-43 for emacs-orgmode@gnu.org; Thu, 27 Sep 2012 19:28:23 -0400 Received: from public by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1THNVD-0002pp-Iz for emacs-orgmode@gnu.org; Fri, 28 Sep 2012 01:28:19 +0200 In-Reply-To: <807grgmt8n.fsf@somewhere.org> (Sebastien Vauban's message of "Wed, 26 Sep 2012 22:20:08 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Sebastien Vauban Cc: public-emacs-orgmode-mXXj517/zsQ@plane.gmane.org "Sebastien Vauban" 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. > >> #+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). > > Best regards, > Seb Thanks Seb, I appreciate your help and patience as I worked out the implications of the changes. I think I've got it straight now :) All the best, Tom -- Thomas S. Dye http://www.tsdye.com