From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: [PATCH] Re: Capitalisation and good taste ? Date: Wed, 11 Jan 2012 11:26:25 -1000 Message-ID: References: <87k4509rc1.fsf@iro.umontreal.ca> <87aa5wcitv.fsf@norang.ca> <23144.1326172391@gamaville.dokosmarshall.org> <8762gk9l27.fsf@iro.umontreal.ca> <87wr8zwdz1.fsf@gnu.org> <87pqergxf6.fsf@gmx.com> <87ehv7wcx5.fsf@gnu.org> <87fwfmntan.fsf@gnu.org> <878vlenf03.fsf@gmx.com> <8739bmneis.fsf@gmx.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([140.186.70.92]:40903) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rl5gn-0003X1-BY for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 16:26:34 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Rl5gm-0002AF-6I for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 16:26:33 -0500 Received: from oproxy4-pub.bluehost.com ([69.89.21.11]:60607) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1Rl5gl-00029g-T6 for emacs-orgmode@gnu.org; Wed, 11 Jan 2012 16:26:32 -0500 In-Reply-To: <8739bmneis.fsf@gmx.com> (Eric Schulte's message of "Wed, 11 Jan 2012 13:57:31 -0700") 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: Eric Schulte Cc: Bastien , =?utf-8?Q?Fran=C3=A7ois?= Pinard , nicholas.dokos@hp.com, emacs-orgmode@gnu.org, Bernt Hansen --=-=-= Aloha all, The attached patch to the manual includes information on the RESULTS keyword. All the best, Tom --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-org.texi-RESULTS-now-user-configurable.patch Content-Description: Manual patch >From 7fbabd20ed1477e706633945c98400ee48fb0ab2 Mon Sep 17 00:00:00 2001 From: Thomas Dye Date: Wed, 11 Jan 2012 11:23:19 -1000 Subject: [PATCH] * doc/org.texi: #+RESULTS now user-configurable --- doc/org.texi | 17 ++++++++++++----- 1 files changed, 12 insertions(+), 5 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index a9f0139..2229358 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -12629,17 +12629,24 @@ of tangled code files. @section Evaluating code blocks @cindex code block, evaluating @cindex source code, evaluating +@cindex #+RESULTS Code blocks can be evaluated@footnote{Whenever code is evaluated there is a potential for that code to do harm. Org mode provides safeguards to ensure that code is only evaluated after explicit confirmation from the user. For information on these safeguards (and on how to disable them) see @ref{Code evaluation security}.} and the results of evaluation optionally placed in the -Org mode buffer. By default, the evaluation facility is only enabled for -Lisp code blocks specified as @code{emacs-lisp}. However, source code blocks -in many languages can be evaluated within Org mode (see @ref{Languages} for a -list of supported languages and @ref{Structure of code blocks} for -information on the syntax used to define a code block). +Org mode buffer. The results of evaluation are placed following a line that +begins by default with @code{#+RESULTS} and optionally a cache identifier +and/or the name of the evaluated code block. The default value of +@code{#+RESULTS} can be changed with the customizable variable +@code{org-babel-results-keyword}. + +By default, the evaluation facility is only enabled for Lisp code blocks +specified as @code{emacs-lisp}. However, source code blocks in many languages +can be evaluated within Org mode (see @ref{Languages} for a list of supported +languages and @ref{Structure of code blocks} for information on the syntax +used to define a code block). @kindex C-c C-c There are a number of ways to evaluate code blocks. The simplest is to press -- 1.7.5.4 --=-=-= Eric Schulte writes: >> >> I'm going to push up a patch which will change to inserting #+RESULTS: >> by default as well as a user-configurable variable which can be used to >> customize this behavior. > > Done. This variable is named `org-babel-results-keyword' > > ,---- > | org-babel-results-keyword's value is "RESULTS" > | > | Documentation: > | Keyword used to name results generated by code blocks. > | Should be either RESULTS or NAME however any capitalization may > | be used. > | > | You can customize this variable. > | > | [back] > `---- > > Best, -- Thomas S. Dye http://www.tsdye.com --=-=-=--