From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eric Schulte Subject: Re: org-babel header documentation Date: Tue, 26 Mar 2013 09:35:57 -0600 Message-ID: <87ehf25g2q.fsf@gmail.com> References: <5151B804.5040109@easy-emacs.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:34639) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UKVv3-0001D6-Ag for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 11:36:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UKVv1-0008VH-DK for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 11:36:13 -0400 Received: from mail-pb0-f50.google.com ([209.85.160.50]:37015) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UKVv1-0008V8-6v for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 11:36:11 -0400 Received: by mail-pb0-f50.google.com with SMTP id jt11so540918pbb.37 for ; Tue, 26 Mar 2013 08:36:06 -0700 (PDT) In-Reply-To: (John Hendy's message of "Tue, 26 Mar 2013 10:23:33 -0500") 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: John Hendy Cc: emacs-orgmode John Hendy writes: > On Tue, Mar 26, 2013 at 10:00 AM, Andreas R=C3=B6hler > wrote: >> Hi all, >> >> while digging through the org-babel stuff, which is quite exiting, have = some >> difficulties to grasp the functionality of different header arguments. >> >> Info 14.8 Header arguments >> >> is useful so far. Still miss an explanation the way >> >> Setting X to Y will cause.... >> >> Maybe missing the right spot still? > > I tend to agree. I typically just follow the matching tutorial for > whatever language I'm using and stick to it... but I don't always > understand (like why I need =3D:results output graphics=3D in R vs. just > output). Perhaps you could inquire about a particular header setting, > someone could respond, and you could add the info to Worg somewhere > (something like a "layman's guide to header arguments")? > The evolution of the code block functionality over the years has been driven almost exclusively by this mailing list. The best way to find the reasoning behind any particular baroque combination of header arguments is to search through the archives of this list. Sadly we don't do a good enough job of ensuring that the content generated here makes its way to Worg. I'm certainly guilty of this myself, but there are only so many hours in the day. --=20 Eric Schulte http://cs.unm.edu/~eschulte