emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Joe Riel <joer@san.rr.com>
To: emacs-orgmode@gnu.org
Subject: Re: obtain ob-template.el for Babel language extension
Date: Fri, 11 Sep 2015 21:13:05 -0700	[thread overview]
Message-ID: <20150911211305.295d8ff4@gauss> (raw)
In-Reply-To: <m2bnd9q6y3.fsf@tsdye.com>

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

> Aloha Joe,
> 
> Joe Riel <joer@san.rr.com> writes:
> 
> > On Thu, 10 Sep 2015 20:38:12 -1000
> > Thomas S. Dye <tsd@tsdye.com> wrote:
> >
> >> Aloha Joe,
> >> 
> >> Joe Riel <joer@san.rr.com> 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

  parent reply	other threads:[~2015-09-12  4:13 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-09-11  5:23 obtain ob-template.el for Babel language extension Joe Riel
2015-09-11  6:38 ` Thomas S. Dye
2015-09-11 14:37   ` Joe Riel
2015-09-11 16:03     ` Thomas S. Dye
2015-09-11 19:30       ` Marco Maggesi
2015-09-13 17:45         ` Joe Riel
2015-09-15  2:37         ` Thomas S. Dye
2015-09-16 15:43           ` Joe Riel
2015-09-12  4:13       ` Joe Riel [this message]
2015-09-12 17:15         ` Thomas S. Dye
2015-09-12 17:39           ` Joe Riel
2015-09-12 18:50           ` [PATCH] small improvements to info page, Working with source code Joe Riel
2015-09-13 17:32             ` [PATCH] small improvements to info page, Working with source code; add TINYCHANG Joe Riel
2015-09-13 18:24               ` Rasmus

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20150911211305.295d8ff4@gauss \
    --to=joer@san.rr.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).