Re: [O] obtain ob-template.el for Babel language extension

[Joe Riel]

On Fri, 11 Sep 2015 06:03:32 -1000
Thomas S. Dye <address@hidden> wrote:

> Aloha Joe,
> 
> Joe Riel <address@hidden> writes:
> 
> > On Thu, 10 Sep 2015 20:38:12 -1000
> > Thomas S. Dye <address@hidden> wrote:
> >
> >> Aloha Joe,
> >> 
> >> Joe Riel <address@hidden> writes:
> >> 
> >> > How do I get a copy of ob-template.el?
> >> > The file can be viewed at 
> >> > http://orgmode.org/w/worg.git/blob/HEAD:/org-contrib/babel/ob-template.el
> >> > however, that is an html file and not the elisp.
> >> > I tried using git to clone http://orgmode.org/w/worg.git
> >> > but that does not work.
> >> 
> >> ~$ git clone git://orgmode.org/worg.git
> >> 
> >> You should find ob-template.el in org-contrib/babel/
> >
> > Thanks, that was helpful.  Probably mention of that fact
> > should be added to the languages.org file---currently it
> > links directly to the html file which is less useful.
> 
> Done.  Thanks.
> 
> > Are elisp files that implement the languages in worg?
> > I found the *.org files that document them, but not their
> > sources.
> 
> The language source files are distributed with Org mode.  You can find
> them at lisp/ob-*.el.

Thanks.  

No offense, but the help pages on the code blocks could really use
improvement.  For example,

Exporting code blocks
---------------------
Nowhere does this section explain *how* you can export a code block,
nor are there any links to pages that are helpful.  As a minimum it
should include the relevant commands and the key bindings for
exporting code blocks.  Where are they?

Evaluating code blocks
----------------------
The second paragraph states that only 'emacs-lisp' is enabled by
default.  Suppose I want to use something other than 'emacs-lisp',
*how* do I enable that?  The parenthetical comment states that the
Languages section lists the supoported languages but doesn't mention
that the explanation of enabling other languages is there.  Better
to not leave the reader hanging.  How about this:

"By default, the evaluation facility is only enabled for Lisp code
blocks specified as ‘emacs-lisp’.  See _Languages_ for instructions on
enabling other languages and for a list of supported languages.  See
_Structure of code blocks_ for information on the syntax used to
define a code block."





-- 
Joe Riel