emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: tsd@tsdye.com (Thomas S. Dye)
To: Sebastien Vauban
	<public-wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@plane.gmane.org>
Cc: public-emacs-orgmode-mXXj517/zsQ@plane.gmane.org
Subject: Re: are babel python sessions and inlined images incompatible?
Date: Thu, 25 Apr 2013 06:27:03 -1000	[thread overview]
Message-ID: <m138uefueg.fsf@poto.westell.com> (raw)
In-Reply-To: <86r4hzgisn.fsf@somewhere.org> (Sebastien Vauban's message of "Thu, 25 Apr 2013 09:40:08 +0200")



Aloha Seb,

"Sebastien Vauban"
<wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@public.gmane.org> writes:

>
> Well, I *now* know it's not described in the Org manual...
>
>   ╭──── http://lists.gnu.org/archive/html/emacs-orgmode/2013-03/msg01181.html
>   │
>   │ - :results graphics makes the list even longer, yes?  :-) I'm not
>   │   sure that every language supports it and I don't believe it's
>   │   currently in the manual.
>   ╰────
>
> Though, it's described in many different posts on this ML, and in some
> tutorials on Worg...
>
>   ╭──── http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html
>   │
>   │ If a :file filename.ext header argument is provided to an R source
> block, then
>   │ the output from the source block will go to the named file. What that output
>   │ is depends on the value of the :results header argument.
>   │
>   │ 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.)
>   ╰────
>
> I thought it was a "core" option value for all general-purpose languages (e.g.
> emacs-lisp, python, R, ruby, sh), required when your code block outputs a
> graphics.
>
> After checking, I only found it in those files:
>
> ./ob-maxima.el:117:  (and (member "graphics" (cdr (assq :result-params params)))
> ./ob-octave.el:272:  (and (member "graphics" (cdr (assq :result-params params)))
> ./ob-R.el:234:  (and (member "graphics" (cdr (assq :result-params params)))

The language documentation on Worg, such as
http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html, is
meant to be documentation, rather than tutorial.  It is structured this
way so the manual doesn't need to be updated every time support for a
new language is added, or changes are made to a language-specific file.

The template for this documentation includes a slot for default header
arguments and also one for language-specific header arguments, because
these are often changed by the language-specific modules.

I think the hope and expectation is that the user community take over
the tasks of creating and tending the language-specific code.  If
:results graphics makes good sense for Python, then users should feel
free to add it to ob-python.el.  With the examples you point out, it
shouldn't be too difficult.

hth,
Tom
 
-- 
Thomas S. Dye
http://www.tsdye.com

  reply	other threads:[~2013-04-25 16:27 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-04-23  4:10 Rodrigo Amestica
2013-04-23 13:29 ` Eric Schulte
2013-04-23 22:17   ` Rodrigo Amestica
2013-04-24 21:06     ` Sebastien Vauban
2013-04-24 23:33       ` Rodrigo Amestica
2013-04-25  7:40         ` Sebastien Vauban
2013-04-25 16:27           ` Thomas S. Dye [this message]
2013-04-26 13:21             ` Sebastien Vauban
2013-04-26 22:13               ` Rasmus
2013-04-27  6:27               ` Achim Gratz
2013-04-27  6:40                 ` Sebastien Vauban

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=m138uefueg.fsf@poto.westell.com \
    --to=tsd@tsdye.com \
    --cc=public-emacs-orgmode-mXXj517/zsQ@plane.gmane.org \
    --cc=public-wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@plane.gmane.org \
    --subject='Re: are babel python sessions and inlined images incompatible?' \
    /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

Code repositories for project(s) associated with this 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).