summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Schulte <schulte.eric@gmail.com>2014-03-15 20:44:38 -0600
committerEric Schulte <schulte.eric@gmail.com>2014-03-15 20:44:38 -0600
commit64d9ba15b60e4368a9681f5269efe8fbb3875d62 (patch)
treea207bcc837926dff666c1094df756b4af18a9e45
parent05f69e5bf8ccbce572ac0c78d35483093d9b4885 (diff)
downloadorg-mode-64d9ba15b60e4368a9681f5269efe8fbb3875d62.tar.gz
clarification of commented code block export
-rw-r--r--doc/org.texi12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/org.texi b/doc/org.texi
index 7bc0247..8331139 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -9752,8 +9752,9 @@ a horizontal line.
Lines starting with zero or more whitespace characters followed by one
@samp{#} and a whitespace are treated as comments and will never be exported.
Also entire subtrees starting with the word @samp{COMMENT} will never be
-exported. Finally, regions surrounded by @samp{#+BEGIN_COMMENT}
-... @samp{#+END_COMMENT} will not be exported.
+exported (and included code blocks will not be executed on export). Finally,
+regions surrounded by @samp{#+BEGIN_COMMENT} ... @samp{#+END_COMMENT} will
+not be exported.
@table @kbd
@kindex C-c ;
@@ -10547,7 +10548,8 @@ anywhere in a file, text before the first headline is ignored.
The tags that exclude a tree from export (@code{org-export-exclude-tags}).
The default value is @code{:noexport:}. Entries with the @code{:noexport:}
tag will be unconditionally excluded from the export, even if they have an
-@code{:export:} tag.
+@code{:export:} tag. Code blocks contained in excluded subtrees will still
+be executed during export even thought the subtree is not exported.
@item TITLE
@cindex #+TITLE
@@ -13867,6 +13869,10 @@ assumed to have their results already inserted in the buffer by manual
evaluation. This setting is useful to avoid expensive recalculations during
export, not to provide security.
+Code blocks in commented subtrees (e.g., with the @code{COMMENT} keyword)
+(@pxref{Horizontal rules}) are never evaluated on export. However, code
+blocks in subtrees excluded from export (@pxref{Export settings}) may be
+evaluated on export.
@node Extracting source code
@section Extracting source code