inconsistency with :eval yes in orgmode.org and gnu.org manuals for org 9.6, 9.5?

inconsistency with :eval yes in orgmode.org and gnu.org manuals for org 9.6, 9.5?

[Dan Drake]

[-- Attachment #1: Type: text/plain, Size: 951 bytes --]

The online manuals for 16.5 Evaluating Code Blocks seem inconsistent and
include a header argument that seems to no longer be respected.

https://orgmode.org/manual/Evaluating-Code-Blocks.html, for version 9.6,
right now says you can specify a header argument ":eval yes" on source code
blocks to bypass confirmation.

However, neither
https://www.gnu.org/software/emacs/manual/html_node/org/Evaluating-Code-Blocks.html
and
https://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/org/Evaluating-Code-Blocks.html
mention that. They are both for version 9.5.

It seems like ":eval yes" was removed some time ago -- see
https://emacs.stackexchange.com/a/3570/19526.

Did that get re-added? It seems like it was replaced by the
org-confirm-babel-evaluate mechanism --
https://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/org/Code-Evaluation-Security.html.


Just curious/confused. Thanks!

Dan



-- 
Ceci n'est pas une .signature.

[-- Attachment #2: Type: text/html, Size: 1750 bytes --]

Re: inconsistency with :eval yes in orgmode.org and gnu.org manuals for org 9.6, 9.5?

[Ihor Radchenko]

[-- Attachment #1: Type: text/plain, Size: 624 bytes --]

Dan Drake <dan.drake@gmail.com> writes:

> It seems like ":eval yes" was removed some time ago -- see
> https://emacs.stackexchange.com/a/3570/19526.
>
> Did that get re-added? It seems like it was replaced by the
> org-confirm-babel-evaluate mechanism --
> https://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/org/Code-Evaluation-Security.html.

It did not really get removed.
But its meaning indeed changed slightly, despite what the current manual
says.

:eval yes evaluates the code blocks, but not unconditionally. It still
obeys org-confirm-babel-evaluate.

Does the attached patch clarify the situation?

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-org-manual-Clarify-that-eval-yes-obeys-org-confirm-b.patch --]
[-- Type: text/x-patch, Size: 1054 bytes --]

From 3867672d6b38b3c0ccba0b5da8e4a3adb7f111b1 Mon Sep 17 00:00:00 2001
Message-Id: <3867672d6b38b3c0ccba0b5da8e4a3adb7f111b1.1677517512.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Mon, 27 Feb 2023 20:02:50 +0300
Subject: [PATCH] org-manual: Clarify that :eval yes obeys
 `org-confirm-babel-evaluate'

* doc/org-manual.org (Limit code block evaluation): Clarify :eval yes
value.

Reported-by: Dan Drake <dan.drake@gmail.com>
Link: https://orgmode.org/list/CAKqbAeFRGDzQQQkXHKvDPtgM7NYybWgxpJj3yoRKnuD2bSwyVw@mail.gmail.com
---
 doc/org-manual.org | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 6a625b42a..1c97d6aa8 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -18123,7 +18123,8 @@ *** Limit code block evaluation
 
 - =yes= ::
 
-  Org always evaluates the source code without asking permission.
+  Org evaluates the source code, possibly asking permission according
+  to ~org-confirm-babel-evaluate~.
 
 - =never= or =no= ::
 
-- 
2.39.1


[-- Attachment #3: Type: text/plain, Size: 224 bytes --]


-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Re: inconsistency with :eval yes in orgmode.org and gnu.org manuals for org 9.6, 9.5?

[Ihor Radchenko]

Ihor Radchenko <yantar92@posteo.net> writes:

> Subject: [PATCH] org-manual: Clarify that :eval yes obeys
>  `org-confirm-babel-evaluate'
>
> * doc/org-manual.org (Limit code block evaluation): Clarify :eval yes
> value.

Applied, onto bugfix.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?h=bugfix&id=911d6a1027784ab081cb41b40c08826e62066c73

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>