[O] [Patch] Documentation, was Re: Spurious source-code output?

2011-05-05 Thread Thomas S. Dye

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?

2011-05-05 Thread Nick Dokos
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?

2011-05-05 Thread Thomas S. Dye
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?

2011-05-05 Thread Nick Dokos
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?

2011-05-05 Thread Eric Schulte
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?

2011-05-05 Thread Nick Dokos
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?

2011-05-05 Thread Nick Dokos
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