From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Hendy Subject: Re: No mention of ":results graphics" in docs on code blocks Date: Mon, 20 Oct 2014 00:00:23 -0500 Message-ID: References: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a1135e5ee97ddc10505d39714 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42325) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xg550-0002Xm-Tf for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 01:00:28 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xg54z-0007bn-Mn for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 01:00:26 -0400 Received: from mail-la0-x232.google.com ([2a00:1450:4010:c03::232]:43325) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xg54z-0007bP-68 for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 01:00:25 -0400 Received: by mail-la0-f50.google.com with SMTP id s18so3227510lam.23 for ; Sun, 19 Oct 2014 22:00:23 -0700 (PDT) In-Reply-To: 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: William Denton Cc: emacs-orgmode --001a1135e5ee97ddc10505d39714 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Oct 19, 2014 11:08 PM, "William Denton" wrote: > > I just noticed there's no mention of the ":results graphics" header argument in the Org manual. I said the same in 2012: - http://comments.gmane.org/gmane.emacs.orgmode/57643 > This worg documentation about source code blocks and R does mention it: > > http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html > This was the reply then, too. Basically, the org header arguments manual page mentions that language-specific arguments are on the appropriate page in worg babel. If you click that link, then the link to the lust of supported languages, that gets you to a table and to ob-doc-R. Maybe not ideal, but I think the intent is not to clutter the manual with every specific arg possible. Sorry it was confusing. > "If the value is :results graphics then 'base' graphics output is captured on disk, and a link to the graphics file is inserted into the Org Mode buffer (as is also the case with the graphics-only languages such as gnuplot, ditaa, dot, and asymptote.)" > > (It goes on to say ":results output graphics" is necessary with ggplot2 images, but that's no longer true.) > > I'm afraid I don't know enough about this header argument or its use elsewhere to offer a documentation patch, so I'm just pointing it out. > For changes, there's good info on worg about editing and pushing to worg, which is on git. The manual requires patching, but that's documented as well. - http://orgmode.org/worg/org-contribute.html Hope that helps, John > Working with R code blocks in Org is great. > > Bill > -- > William Denton =E2=86=94 Toronto, Canada =E2=86=94 https://www.miskaton= ic.org/ --001a1135e5ee97ddc10505d39714 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable


On Oct 19, 2014 11:08 PM, "William Denton" <wtd@pobox.com> wrote:
>
> I just noticed there's no mention of the ":results graphics&q= uot; header argument in the Org manual.

I said the same in 2012:
- http://co= mments.gmane.org/gmane.emacs.orgmode/57643

> This worg documentation about source code blocks and R = does mention it:
>
> http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html
>

This was the reply then, too. Basically, the org header argu= ments manual page mentions that language-specific arguments are on the appr= opriate page in worg babel. If you click that link, then the link to the lu= st of supported languages, that gets you to a table and to ob-doc-R.

Maybe not ideal, but I think the intent is not to clutter th= e manual with every=C2=A0 specific arg possible. Sorry it was confusing.

> "If the value is :results graphics then 'base&= #39; graphics output is captured on disk, and a link to the graphics file i= s inserted into the Org Mode buffer (as is also the case with the graphics-= only languages such as gnuplot, ditaa, dot, and asymptote.)"
>
> (It goes on to say ":results output graphics" is necessary w= ith ggplot2 images, but that's no longer true.)
>
> I'm afraid I don't know enough about this header argument or i= ts use elsewhere to offer a documentation patch, so I'm just pointing i= t out.
>

For changes, there's good info on worg about editing and= pushing to worg, which is on git. The manual requires patching, but that&#= 39;s documented as well.
- http://orgmode.or= g/worg/org-contribute.html

Hope that helps,
John

> Working with R code blocks in Org is great.
>
> Bill
> --
> William Denton =E2=86=94=C2=A0 Toronto, Canada =E2=86=94=C2=A0 https://www.miskatonic.org/

--001a1135e5ee97ddc10505d39714--