* No mention of ":results graphics" in docs on code blocks
@ 2014-10-20 4:07 William Denton
2014-10-20 4:44 ` Thomas S. Dye
2014-10-20 5:00 ` John Hendy
0 siblings, 2 replies; 3+ messages in thread
From: William Denton @ 2014-10-20 4:07 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: TEXT/PLAIN, Size: 891 bytes --]
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.
Working with R code blocks in Org is great.
Bill
--
William Denton ↔ Toronto, Canada ↔ https://www.miskatonic.org/
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: No mention of ":results graphics" in docs on code blocks
2014-10-20 4:07 No mention of ":results graphics" in docs on code blocks William Denton
@ 2014-10-20 4:44 ` Thomas S. Dye
2014-10-20 5:00 ` John Hendy
1 sibling, 0 replies; 3+ messages in thread
From: Thomas S. Dye @ 2014-10-20 4:44 UTC (permalink / raw)
To: William Denton; +Cc: emacs-orgmode
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
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: No mention of ":results graphics" in docs on code blocks
2014-10-20 4:07 No mention of ":results graphics" in docs on code blocks William Denton
2014-10-20 4:44 ` Thomas S. Dye
@ 2014-10-20 5:00 ` John Hendy
1 sibling, 0 replies; 3+ messages in thread
From: John Hendy @ 2014-10-20 5:00 UTC (permalink / raw)
To: William Denton; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1716 bytes --]
On Oct 19, 2014 11:08 PM, "William Denton" <wtd@pobox.com> 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 ↔ Toronto, Canada ↔ https://www.miskatonic.org/
[-- Attachment #2: Type: text/html, Size: 2342 bytes --]
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2014-10-20 5:00 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-10-20 4:07 No mention of ":results graphics" in docs on code blocks William Denton
2014-10-20 4:44 ` Thomas S. Dye
2014-10-20 5:00 ` John Hendy
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).