branch: externals/org
commit 7f0e6729b376aee3d50bd460d2660d6024971e18
Author: Pedro A. Aranda <[email protected]>
Commit: Ihor Radchenko <[email protected]>
doc/org-manual.org: Rephrase code block evaluation control
* doc/org-manual.org (Exporting Code Blocks): Put the reasons why one
might need to stop code block evaluation at the beginning of the
sentence for more clarity.
---
doc/org-manual.org | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index fbe6ff970d..75412b26e4 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -19561,11 +19561,14 @@ Note that all the links pointing to a source block
exported using
unless broken links are allowed during export (see [[*Export Settings]]).
#+vindex: org-export-use-babel
-To stop Org from evaluating code blocks to speed up export, use the
-header argument =:eval never-export= (see [[*Evaluating Code Blocks]]).
-To stop Org from evaluating code blocks for greater security, set the
-~org-export-use-babel~ variable to ~nil~, but understand that header
-arguments will have no effect.
+You can prevent Org from evaluating code blocks for speed or security
+reasons:
+
+- To speed up export, use the header argument =:eval never-export=
+ (see [[*Evaluating Code Blocks]]).
+- For greater security, set the ~org-export-use-babel~ variable to
+ ~nil~, but understand that header arguments will have no effect in
+ this case.
If results of evaluation are not marked for export (=:exports code= or
=:exports none=), Org will not evaluate them, even for =:eval yes=.
