Another attempt,

/PA

On Thu, 5 Feb 2026 at 17:59, Pedro Andres Aranda Gutierrez <
[email protected]> wrote:

> HI again,
>
> maybe a more "drastic" rework does a better job...
>
> /PA
>
> On Thu, 5 Feb 2026 at 16:56, Jacob S. Gordon <[email protected]>
> wrote:
>
>> On 2026-02-05 04:49, Pedro Andres Aranda Gutierrez wrote:
>> > The important part is the reason why you stop exporting code blocks,
>> > so put it at the beginning of the sentence
>>
>> +1
>>
>> IMO the second sentence could be improved (missing word, some may be
>> not be remembering this fact):
>>
>>   For greater security, [you can prevent] Org from evaluating code
>>   blocks [by] setting the ~org-export-use-babel~ variable to ~nil~[,
>>   but note that] header arguments will have no effect in this case.
>>
>> Thanks,
>>
>> --
>> Jacob S. Gordon
>> [email protected]
>> Please don’t send me HTML emails or MS Office/Apple iWork documents.
>> https://useplaintext.email/#etiquette
>> https://www.fsf.org/campaigns/opendocument
>>
>
>
> --
> Fragen sind nicht da, um beantwortet zu werden,
> Fragen sind da um gestellt zu werden
> Georg Kreisler
>
> "Sagen's Paradeiser" (ORF: Als Radiohören gefährlich war) => write BE!
> Year 2 of the New Koprocracy
>
>

-- 
Fragen sind nicht da, um beantwortet zu werden,
Fragen sind da um gestellt zu werden
Georg Kreisler

"Sagen's Paradeiser" (ORF: Als Radiohören gefährlich war) => write BE!
Year 2 of the New Koprocracy
From fe490a39d8a72ffa566a1b2d46b5e9b4364b930c Mon Sep 17 00:00:00 2001
From: "Pedro A. Aranda" <[email protected]>
Date: Thu, 9 Feb 2026 17:56:03 +0100
Subject: [PATCH] doc/org-manual.org: Rephrase code block evaluation control

doc/org-manual.org: 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 | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 818bf0b59..5f085781c 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -19564,11 +19564,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=.

Reply via email to