[latex3-commits] [latex3/latex3] main: Add details on resrcited escape and fobidden commands (d4d4d7032)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/d4d4d70321322757793a9f5b65ab286ecb93abf5

>---------------------------------------------------------------

commit d4d4d70321322757793a9f5b65ab286ecb93abf5
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Thu Nov 16 05:46:26 2023 +0000

    Add details on resrcited escape and fobidden commands
    
    See #1339.


>---------------------------------------------------------------

d4d4d70321322757793a9f5b65ab286ecb93abf5
 l3kernel/l3sys.dtx | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/l3kernel/l3sys.dtx b/l3kernel/l3sys.dtx
index fc041a25d..5ac9696d5 100644
--- a/l3kernel/l3sys.dtx
+++ b/l3kernel/l3sys.dtx
@@ -260,6 +260,11 @@
 %   \meta{shell command}.  The \cs{sys_get_shell:nnNTF} conditional
 %   inserts the \meta{true code} if the shell is available and no quote is
 %   detected, and the \meta{false code} otherwise.
+%
+%   \emph{Note}: It is not possible to tell from \TeX{} is a comand is allowed
+%   in resticted shell escape. If restricted escape is enabled, the
+%   \texttt{true} branch is taken: if the command is forbidden at this stage, a
+%   low-level \TeX{} error will arise.
 % \end{function}
 %
 % \begin{variable}[added = 2017-05-27]{\c_sys_shell_escape_int}