From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: org-babel header documentation Date: Tue, 26 Mar 2013 06:54:51 -1000 Message-ID: References: <5151B804.5040109@easy-emacs.de> <87ehf25g2q.fsf@gmail.com> <5151CA14.9070503@easy-emacs.de> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:57307) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UKX9h-0003NK-CE for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 12:55:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UKX9f-00030F-JT for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 12:55:25 -0400 Received: from oproxy9.bluehost.com ([69.89.24.6]:57474) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1UKX9f-0002zy-B6 for emacs-orgmode@gnu.org; Tue, 26 Mar 2013 12:55:23 -0400 In-Reply-To: (John Hendy's message of "Tue, 26 Mar 2013 11:23:45 -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 , Eric Schulte Aloha all, John Hendy writes: >> Hi Eric, >> >> thanks a lot BTW for all you've done. >> >> What about to have a list editable for all interested >> w/ comments to all header args in alphabetical order? >> >> Might participate and write it down the way it's understood. >> You and others may correct it on the fly. >> >> Maybe someone starts a headers.org in Worg? > > I'm happy to help with this. Will take me a bit to get to (~1wk), but > could definitely help. I'm really trying to help more with Worg as my > return for all the code and support others write. One problem with > this, though, is that some of these are language specific. I ran into > this before: > - http://lists.gnu.org/archive/html/emacs-orgmode/2012-07/msg00260.html > > So... this table might be more complicated than you realize, unless > you're only talking about system-wide arguments. > Another way to approach this would be two-pronged: 1) patch the Org manual where appropriate, and 2) augment (or draft) the language-specific guides on Worg. Most of the language guides are stubs waiting for detailed content from users. There are still many languages without a guide (see http://orgmode.org/worg/org-contrib/babel/languages.html). The template for language guides (http://orgmode.org/w/?p=worg.git;a=blob;f=org-contrib/babel/languages/ob-doc-template.org;hb=HEAD) has a section for header arguments, so there is a structure in place. All the best, Tom -- Thomas S. Dye http://www.tsdye.com