From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thomas S. Dye" Subject: [Patch] Documentation, was Re: Spurious source-code output? Date: Thu, 5 May 2011 08:28:02 -1000 Message-ID: References: <30278.1304610901@alphaville.dokosmarshall.org> <362D0563-7247-4C15-91DC-5A994FD9896B@tsdye.com> <607.1304617504@alphaville.dokosmarshall.org> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: multipart/mixed; boundary=Apple-Mail-40--104631669 Return-path: Received: from eggs.gnu.org ([140.186.70.92]:58911) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QI3HX-0006ga-A2 for emacs-orgmode@gnu.org; Thu, 05 May 2011 14:28:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QI3HW-0004Kb-28 for emacs-orgmode@gnu.org; Thu, 05 May 2011 14:28:11 -0400 Received: from oproxy1-pub.bluehost.com ([66.147.249.253]:39270) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1QI3HV-0004Jd-Rg for emacs-orgmode@gnu.org; Thu, 05 May 2011 14:28:10 -0400 In-Reply-To: <607.1304617504@alphaville.dokosmarshall.org> 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: nicholas.dokos@hp.com Cc: Ken.Williams@thomsonreuters.com, emacs-orgmode@gnu.org --Apple-Mail-40--104631669 Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit 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 --Apple-Mail-40--104631669 Content-Disposition: attachment; filename=0001-Refer-to-language-specific-Babel-header-arguments.patch Content-Type: application/octet-stream; x-unix-mode=0644; name="0001-Refer-to-language-specific-Babel-header-arguments.patch" Content-Transfer-Encoding: quoted-printable =46rom=20825fe69d493dd2e7eef414b85340e8e27400f78d=20Mon=20Sep=2017=20= 00:00:00=202001=0AFrom:=20Tom=20Dye=20=0ADate:=20Thu,=205=20= May=202011=2008:24:24=20-1000=0ASubject:=20[PATCH]=20Refer=20to=20= language=20specific=20Babel=20header=20arguments=0A=0A---=0A=20= doc/org.texi=20|=20=20=20=203=20+++=0A=201=20files=20changed,=203=20= insertions(+),=200=20deletions(-)=0A=0Adiff=20--git=20a/doc/org.texi=20= b/doc/org.texi=0Aindex=207142ce0..98842ba=20100644=0A---=20= a/doc/org.texi=0A+++=20b/doc/org.texi=0A@@=20-11885,6=20+11885,9=20@@=20= The=20following=20header=20arguments=20are=20defined:=0A=20*=20eval::=20=20= =20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20Limit=20= evaluation=20of=20specific=20code=20blocks=0A=20@end=20menu=0A=20=0A= +Additional=20header=20arguments=20are=20defined=20on=20a=20= language-specific=20basis,=20see=0A+@ref{Languages}.=20=0A+=0A=20@node=20= var,=20results,=20Specific=20header=20arguments,=20Specific=20header=20= arguments=0A=20@subsubsection=20@code{:var}=0A=20The=20@code{:var}=20= header=20argument=20is=20used=20to=20pass=20arguments=20to=20code=20= blocks.=0A--=20=0A1.7.1=0A=0A= --Apple-Mail-40--104631669 Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit On May 5, 2011, at 7:45 AM, Nick Dokos wrote: > Thomas S. Dye 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 --Apple-Mail-40--104631669--