From: firstname.lastname@example.org (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: <email@example.com> (raw) In-Reply-To: <firstname.lastname@example.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
next prev parent 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 \ --email@example.com \ --firstname.lastname@example.org \ --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).