Re: [O] org-babel header documentation

[Thomas S. Dye]

Aloha all,

John Hendy <address@hidden> 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