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: Tue, 10 Jul 2012 11:03:43 -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]:41877) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Socum-0008Pe-HZ for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 12:03:54 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Socuf-00008C-Qn for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 12:03:52 -0400 Received: from mail-bk0-f41.google.com ([209.85.214.41]:40581) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Socuf-00007l-HB for emacs-orgmode@gnu.org; Tue, 10 Jul 2012 12:03:45 -0400 Received: by bkcjc3 with SMTP id jc3so170039bkc.0 for ; Tue, 10 Jul 2012 09:03:43 -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 Tue, Jul 10, 2012 at 10:19 AM, Thomas S. Dye wrote: > John Hendy writes: > >> 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. > > Hi John, > > Thanks for this thought, which is indeed reasonable. I thought the > manual might lack this structure, but when I went back to the > manual I found that > http://orgmode.org/manual/Specific-header-arguments.html#Specific-header-arguments > has this at the bottom of the page: "Additional header arguments are > defined on a language-specific basis, see Languages", where "Languages" > is a link to another manual page, one with a table of supported > languages and a link to the Worg page you cite. > Wow. You see only what you look for. :embarrassed: > The language is a bit different than your proposal, but the path seems > clear enough to me. Technically the path points to http://orgmode.org/worg/org-contrib/babel/languages/; I'd point it to http://orgmode.org/worg/org-contrib/babel/languages.html as it looks cleaner vs. just looking at the directory of .html files. Either way... the manual totally does it's job and I missed it! Thanks for bearing with me! John > > Of course, there is still the issue of the languages that lack > language-specific documentation :) > > All the best, > Tom > > -- > T.S. Dye & Colleagues, Archaeologists > 735 Bishop St, Suite 315, Honolulu, HI 96813 > Tel: 808-529-0866, Fax: 808-529-0884 > http://www.tsdye.com