emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: John Hendy <jw.hendy@gmail.com>
To: William Denton <wtd@pobox.com>
Cc: emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: No mention of ":results graphics" in docs on code blocks
Date: Mon, 20 Oct 2014 00:00:23 -0500	[thread overview]
Message-ID: <CA+M2ft9=TogbibvQ1e6tEfZVnzHrjCTkmyC-uhywK0fBXfiQ1A@mail.gmail.com> (raw)
In-Reply-To: <alpine.DEB.2.02.1410200000410.21470@shell.miskatonic.org>

[-- 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 --]

      parent reply	other threads:[~2014-10-20  5:00 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
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 [this message]

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='CA+M2ft9=TogbibvQ1e6tEfZVnzHrjCTkmyC-uhywK0fBXfiQ1A@mail.gmail.com' \
    --to=jw.hendy@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=wtd@pobox.com \
    /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).