summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Schulte <schulte.eric@gmail.com>2010-07-14 09:53:59 -0700
committerEric Schulte <schulte.eric@gmail.com>2010-07-14 09:53:59 -0700
commite6a274824d18761f26ed2bfd2a1eaa77aef1d42a (patch)
tree33fd0c557e6f4d3a0489d1d2ade3058cf4a955b4
parentbca27d9215d987517de1aab26d2712bab03329ba (diff)
downloadorg-mode-e6a274824d18761f26ed2bfd2a1eaa77aef1d42a.tar.gz
babel doc: cleaned up documentation on "Evaluating code blocks"
-rw-r--r--doc/org.texi32
1 files changed, 13 insertions, 19 deletions
diff --git a/doc/org.texi b/doc/org.texi
index 27d1874..ded3c37 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -11144,29 +11144,23 @@ of tangled code files.
@cindex code block, evaluating
@cindex source code, evaluating
-@quotation
-Whenever code is evaluated there is a potential for that code to do harm.
-Org-mode provides a number of safeguards to ensure that it only evaluates
-code with explicit confirmation from the user. For information on these
-safeguards (and on how to disable them) see @ref{Code evaluation security}.
-@end quotation
-
-Code blocks can be evaluated and the results placed in the Org-mode buffer.
-By default, evaluation is only turned on for @code{emacs-lisp} code blocks,
-however support exists for evaluating blocks in many languages. See
+Code blocks can be evaluated@footnote{Whenever code is evaluated there is a
+potential for that code to do harm. Org-mode provides a number of safeguards
+to ensure that it only evaluates code with explicit confirmation from the
+user. For information on these safeguards (and on how to disable them) see
+@ref{Code evaluation security}.} and the results placed in the Org-mode
+buffer. By default, evaluation is only turned on for @code{emacs-lisp} code
+blocks, however support exists for evaluating blocks in many languages. See
@ref{Languages} for a list of supported languages. See @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 @kbd{C-c C-c} or @kbd{C-c C-v e} with the point on a code block. This
-will call the @code{org-babel-execute-src-block} function to evaluate the
-block and insert its results into the Org-mode buffer.
-
-@quotation
-The @code{org-babel-no-eval-on-ctrl-c-ctrl-c} variable can be used to remove
-code evaluation from the @kbd{C-c C-c} key binding.
-@end quotation
+There are a number of ways to evaluate code blocks. The simplest is to press
+@kbd{C-c C-c} or @kbd{C-c C-v e} with the point on a code block@footnote{The
+@code{org-babel-no-eval-on-ctrl-c-ctrl-c} variable can be used to remove code
+evaluation from the @kbd{C-c C-c} key binding.}. This will call the
+@code{org-babel-execute-src-block} function to evaluate the block and insert
+its results into the Org-mode buffer.
It is also possible to evaluate named code blocks from anywhere in an
Org-mode buffer or an Org-mode table. @code{#+call} (or synonymously