From mboxrd@z Thu Jan 1 00:00:00 1970 From: Joe Riel Subject: Re: obtain ob-template.el for Babel language extension Date: Sat, 12 Sep 2015 10:39:07 -0700 Message-ID: <20150912103907.188adb17@gauss> References: <20150910222354.743ce9f2@gauss> <20150911073700.356f5760@gauss> <20150911211305.295d8ff4@gauss> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53530) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zaolc-0003oe-OW for emacs-orgmode@gnu.org; Sat, 12 Sep 2015 13:39:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZaolZ-0002uf-GS for emacs-orgmode@gnu.org; Sat, 12 Sep 2015 13:39:12 -0400 Received: from cdptpa-outbound-snat.email.rr.com ([107.14.166.227]:46790 helo=cdptpa-oedge-vip.email.rr.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZaolZ-0002uL-Cu for emacs-orgmode@gnu.org; Sat, 12 Sep 2015 13:39:09 -0400 In-Reply-To: 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: "Thomas S. Dye" Cc: emacs-orgmode@gnu.org On Sat, 12 Sep 2015 07:15:37 -1000 Thomas S. Dye wrote: > Aloha Joe, >=20 > Joe Riel writes: > > > > No offense, but the help pages on the code blocks could really use > > improvement. >=20 > Glad to have your help. The documentation is a community effort. Agreed. Because I'm new to this aspect of org, I'm reading the relevant manual pages for the first time. As such, it is easy to note deficiencies. I'll help to improve them.=20 >=20 > > 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? >=20 > Typically, one doesn't export a code block by itself. Instead, one > exports a document that includes one or more code blocks. How to export > a document is covered in Chapter 12, Exporting. I figured that out eventually. There should be a link from the exporting code blocks section to chapter 12; not everyone reads manual in a linear fashion 8-). I'll submit that with the other suggestion (below). > > 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 =E2=80=98emacs-lisp=E2=80=99. 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." >=20 > I think this is an improvement. IMHO it is almost always a good thing > to get rid of parenthetical statements. Would you like to submit a > patch for org.texi? You'll find instructions here: > http://orgmode.org/worg/org-contribute.html#orgheadline1 >=20 > Another problem is the outdated list of supported languages in Section > 14.7, Languages. Perhaps this could be replaced by a pointer to the > more complete list maintained on Worg? Should this section distinguish > the various levels of "support", e.g. core, contrib, and packages? >=20 > All the best, > Tom >=20 --=20 Joe Riel