[O] [Patch] Documentation, was Re: Spurious source-code output?
Hi Nick, Thanks for fixing the documentation link. Here is a patch that adds a reference to language-specific header arguments. All the best, Tom 0001-Refer-to-language-specific-Babel-header-arguments.patch Description: Binary data On May 5, 2011, at 7:45 AM, Nick Dokos wrote: Thomas S. Dye t...@tsdye.com wrote: Hi Nick, Without claiming to be a babel expert, :results graphics is a language- specific option used for e.g. R code blocks. You can find it documented in the appropriate language-specific sections. OK - thanks for the clarification! It might be a good idea to note (perhaps in section 14.8.2, Specific header arguments, or perhaps its parent?) that individual languages might provide extensions to the standard header args. Also, the link in the manual (section 14.7, Languages) to language-specific documentation should probably be changed to http://orgmode.org/worg/org-contrib/babel/languages.html which provides some useful context. The current link just takes you to the directory listing. Trivial patch for the latter problem is appended. Thanks, Nick diff --git a/doc/org.texi b/doc/org.texi index a0f6638..8cf5535 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -11639,7 +11639,7 @@ Code blocks in the following languages are supported. Language-specific documentation is available for some languages. If available, it can be found at -@uref{http://orgmode.org/worg/org-contrib/babel/languages}. +@uref{http://orgmode.org/worg/org-contrib/babel/languages.html}. The @code{org-babel-load-languages} controls which languages are enabled for evaluation (by default only @code{emacs-lisp} is enabled). This variable can
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Thomas S. Dye t...@tsdye.com wrote: Hi Nick, Thanks for fixing the documentation link. Here is a patch that adds a reference to language-specific header arguments. I think it's still the case that attachments of MIME type application/octet-stream will not be recorded in patchwork. Please use one of the types that patchwork will recognize (text/plain is the best - remember the Orgmode motto!) or just insert it inline. See http://thread.gmane.org/gmane.emacs.orgmode/25727. I'll add a note to that effect to org-contribute.html on Worg unless somebody tells me otherwise. Nick
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Ack. There were problems earlier with my Mac Mail client and line breaks, IIRC, but here is the patch in-line. I'm not sure how to make attachments follow specific MIME requirements. All the best, Tom From 825fe69d493dd2e7eef414b85340e8e27400f78d Mon Sep 17 00:00:00 2001 From: Tom Dye t...@tsdye.com Date: Thu, 5 May 2011 08:24:24 -1000 Subject: [PATCH] Refer to language specific Babel header arguments --- doc/org.texi |3 +++ 1 files changed, 3 insertions(+), 0 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 7142ce0..98842ba 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -11885,6 +11885,9 @@ The following header arguments are defined: * eval::Limit evaluation of specific code blocks @end menu +Additional header arguments are defined on a language-specific basis, see +@ref{Languages}. + @node var, results, Specific header arguments, Specific header arguments @subsubsection @code{:var} The @code{:var} header argument is used to pass arguments to code blocks. -- 1.7.1 On May 5, 2011, at 9:09 AM, Nick Dokos wrote: Thomas S. Dye t...@tsdye.com wrote: Hi Nick, Thanks for fixing the documentation link. Here is a patch that adds a reference to language-specific header arguments. I think it's still the case that attachments of MIME type application/octet-stream will not be recorded in patchwork. Please use one of the types that patchwork will recognize (text/plain is the best - remember the Orgmode motto!) or just insert it inline. See http://thread.gmane.org/gmane.emacs.orgmode/25727. I'll add a note to that effect to org-contribute.html on Worg unless somebody tells me otherwise. Nick
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Thomas S. Dye t...@tsdye.com wrote: Ack. There were problems earlier with my Mac Mail client and line breaks, IIRC, but here is the patch in-line. I'm not sure how to make attachments follow specific MIME requirements. And as you feared, the line-break ogre struck again. They add all these shiny knobs on the dashboard and make the wheels square: that's progress... Nick
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Applied, Thanks -- Eric Thomas S. Dye t...@tsdye.com writes: Hi Nick, Thanks for fixing the documentation link. Here is a patch that adds a reference to language-specific header arguments. All the best, Tom On May 5, 2011, at 7:45 AM, Nick Dokos wrote: Thomas S. Dye t...@tsdye.com wrote: Hi Nick, Without claiming to be a babel expert, :results graphics is a language- specific option used for e.g. R code blocks. You can find it documented in the appropriate language-specific sections. OK - thanks for the clarification! It might be a good idea to note (perhaps in section 14.8.2, Specific header arguments, or perhaps its parent?) that individual languages might provide extensions to the standard header args. Also, the link in the manual (section 14.7, Languages) to language-specific documentation should probably be changed to http://orgmode.org/worg/org-contrib/babel/languages.html which provides some useful context. The current link just takes you to the directory listing. Trivial patch for the latter problem is appended. Thanks, Nick diff --git a/doc/org.texi b/doc/org.texi index a0f6638..8cf5535 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -11639,7 +11639,7 @@ Code blocks in the following languages are supported. Language-specific documentation is available for some languages. If available, it can be found at -@uref{http://orgmode.org/worg/org-contrib/babel/languages}. +@uref{http://orgmode.org/worg/org-contrib/babel/languages.html}. The @code{org-babel-load-languages} controls which languages are enabled for evaluation (by default only @code{emacs-lisp} is enabled). This variable can -- Eric Schulte http://cs.unm.edu/~eschulte/
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Nick Dokos nicholas.do...@hp.com wrote: Thomas S. Dye t...@tsdye.com wrote: Hi Nick, Thanks for fixing the documentation link. Here is a patch that adds a reference to language-specific header arguments. I think it's still the case that attachments of MIME type application/octet-stream will not be recorded in patchwork. Please use one of the types that patchwork will recognize (text/plain is the best - remember the Orgmode motto!) or just insert it inline. See http://thread.gmane.org/gmane.emacs.orgmode/25727. I'll add a note to that effect to org-contribute.html on Worg unless somebody tells me otherwise. Note added: http://orgmode.org/worg/org-contribute.html#sec-4 Nick
Re: [O] [Patch] Documentation, was Re: Spurious source-code output?
Here is Tom's patch as a text/plain attachment (I can't get to the patchwork server right now - anybody? - but note that the version on patchwork is probably line-break damaged). Nick From 825fe69d493dd2e7eef414b85340e8e27400f78d Mon Sep 17 00:00:00 2001 From: Tom Dye t...@tsdye.com Date: Thu, 5 May 2011 08:24:24 -1000 Subject: [PATCH] Refer to language specific Babel header arguments --- doc/org.texi |3 +++ 1 files changed, 3 insertions(+), 0 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 7142ce0..98842ba 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -11885,6 +11885,9 @@ The following header arguments are defined: * eval::Limit evaluation of specific code blocks @end menu +Additional header arguments are defined on a language-specific basis, see +@ref{Languages}. + @node var, results, Specific header arguments, Specific header arguments @subsubsection @code{:var} The @code{:var} header argument is used to pass arguments to code blocks. -- 1.7.1