From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Hendy Subject: Re: Manual does not list :results output graphics as babel header arg Date: Mon, 9 Jul 2012 23:13:11 -0500 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Return-path: Received: from eggs.gnu.org ([208.118.235.92]:56208) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SoRp6-0002cV-As for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 00:13:17 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SoRp4-0000NN-9V for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 00:13:15 -0400 Received: from mail-bk0-f41.google.com ([209.85.214.41]:35856) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SoRp4-0000N5-0A for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 00:13:14 -0400 Received: by bkcjc3 with SMTP id jc3so8012082bkc.0 for ; Mon, 09 Jul 2012 21:13:11 -0700 (PDT) In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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: "Thomas S. Dye" Cc: emacs-orgmode On Mon, Jul 9, 2012 at 7:35 PM, Thomas S. Dye wrote: > John Hendy writes: > >> I have typically outputted graphics from R via tikzDevice manually, >> but gave my first whirl to just including things via the :file >> argument in my block header. In the process, I was trying to get this >> to work and found I needed to use: >> >> ----- >> :results output graphics >> ----- >> >> This is listed on Worg ob-R-doc: >> - http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-R.html#sec-4-3 >> >> But I didn't originally know about it, as it's not a listed header >> argument in the manual, which is where I check since they're all >> listed in one place: >> - http://orgmode.org/manual/results.html#results >> >> Does the manual only list universal babel header arguments and R is in >> a subset of ones using =:results output graphics= or should it be >> there? >> > > Hi John, > > The babel header arguments are implemented at two levels. > > There are general babel arguments that apply to all the supported > languages. These are described in the manual. > > It is also possible for the individual language implementations to > define their own header arguments. R is a good example, where the very > many arguments to the various R output devices are built into ob-R.el. > These language specific header arguments are not described in the > manual, but instead appear in the language specific documentation on > Worg. > > Re: your specific question about :results output graphics. I believe > this is an R specific header argument and that it is described in the > appropriate place in the documentation on Worg (see lines 68 and 230 > of ob-R.el). > > The manual is not a one-stop source for answers to all Babel questions. > Recourse to the language specific documentation is typically necessary, > which is why it would be great if someone could find time to work up > documentation for the 20 or so languages that still lack it :) Thanks for the clarification and that answers the question. This was a specific header argument for R. Perhaps the manual could link to this page? - http://orgmode.org/worg/org-contrib/babel/languages.html Maybe with a diddy: "Some languages feature their own unique header arguments. The above document only universal, system wide Babel header arguments and one should consult the specific language page on Worg for additional features." Just a thought. John > > hth, > Tom > >> >> >> John >> >> > > -- > Thomas S. Dye > http://www.tsdye.com