From mboxrd@z Thu Jan  1 00:00:00 1970
From: tsd@tsdye.com (Thomas S. Dye)
Subject: Re: No mention of ":results graphics" in docs on code blocks
Date: Sun, 19 Oct 2014 18:44:31 -1000
Message-ID: <m21tq3wdsg.fsf@tsdye.com>
References: <alpine.DEB.2.02.1410200000410.21470@shell.miskatonic.org>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:40774)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <tsd@tsdye.com>) id 1Xg4vN-0001Lf-T8
	for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 00:50:35 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <tsd@tsdye.com>) id 1Xg4vI-0004CF-Gj
	for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 00:50:29 -0400
Received: from gproxy5-pub.mail.unifiedlayer.com ([67.222.38.55]:42906)
	by eggs.gnu.org with smtp (Exim 4.71) (envelope-from <tsd@tsdye.com>)
	id 1Xg4vI-0004Br-9r
	for emacs-orgmode@gnu.org; Mon, 20 Oct 2014 00:50:24 -0400
In-Reply-To: <alpine.DEB.2.02.1410200000410.21470@shell.miskatonic.org>
	(William Denton's message of "Mon, 20 Oct 2014 00:07:59 -0400 (EDT)")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=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 <wtd@pobox.com>
Cc: emacs-orgmode@gnu.org

Aloha Bill,

William Denton <wtd@pobox.com> writes:

> I just noticed there's no mention of the ":results graphics" header
> argument in the Org manual.
>
> This worg documentation about source code blocks and R does mention it:
>
> http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html
>
> "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.

When I grep "graphics" in the Org mode lisp directory I see that
:results graphics is recognized by ob-core.el, but that the only
language that uses it is R.  I think this might be the reason :results
graphics is described with the R documentation and not in the main
manual. 

> Working with R code blocks in Org is great.

+1

All the best,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com