CTAN sync 202204170303

9 files changed, 27 insertions, 5 deletions

diff --git a/support/arara/README.md b/support/arara/README.md
index 80b3c81f17..51ace5b5b5 100644
--- a/support/arara/README.md
+++ b/support/arara/README.md
@@ -1,6 +1,6 @@
 ![arara](https://i.stack.imgur.com/hjUsN.png)
 
-# arara v6.1.6
+# arara v6.1.7
 
 ![Language: Kotlin](https://img.shields.io/badge/Language-Kotlin-blue.svg?style=flat-square)
 ![Minimum JRE: 8.0](https://img.shields.io/badge/Minimum_JRE-8-blue.svg?style=flat-square)
diff --git a/support/arara/doc/arara-manual.pdf b/support/arara/doc/arara-manual.pdf
index ce61fca281..9eb91c3953 100644
--- a/support/arara/doc/arara-manual.pdf
+++ b/support/arara/doc/arara-manual.pdf
diff --git a/support/arara/doc/arara-quickstart.pdf b/support/arara/doc/arara-quickstart.pdf
index 99b1165e35..b9894ed75f 100644
--- a/support/arara/doc/arara-quickstart.pdf
+++ b/support/arara/doc/arara-quickstart.pdf
diff --git a/support/arara/doc/arara.1 b/support/arara/doc/arara.1
index db01d9cc9c..8bc4f6065b 100644
--- a/support/arara/doc/arara.1
+++ b/support/arara/doc/arara.1
@@ -1,4 +1,4 @@
-.TH ARARA 1 "27 February 2022" "v6.1.6"
+.TH ARARA 1 "16 April 2022" "v6.1.7"
 .SH NAME
 arara \- a TeX automation tool based on rules and directives.
 .SH SYNOPSIS
diff --git a/support/arara/doc/chapters/rules.tex b/support/arara/doc/chapters/rules.tex
index 244ecac2b1..f2f04b7879 100644
--- a/support/arara/doc/chapters/rules.tex
+++ b/support/arara/doc/chapters/rules.tex
@@ -1731,6 +1731,8 @@ This rule runs the new \rbox{xelatex} \TeX\ engine on the provided \mtbox{curren
 \item[\povalue{stable}] This value, as the name implies, enables the stable engine format branch. Note that this is the default format.
 
 \item[\povalue{developer}] For experienced users, this value enables the experimental, developer engine format branch.
+
+\item[\povalue{unsafe}] This value enables the unsafe engine format branch. According to the documentation, at all costs, avoid using this, or any, unsafe invocation with documents off the net or that are otherwise untrusted in any way.
 \end{description}
 
 \item[\abox{interaction}] This option alters the underlying engine behaviour. If this option is omitted, \TeX\ will prompt the user for interaction in the event of an error. Possible values are, in order of increasing user interaction (courtesy of our master Enrico Gregorio):
@@ -1760,6 +1762,14 @@ This rule runs the new \rbox{xelatex} \TeX\ engine on the provided \mtbox{curren
 This rule runs the \rbox{xetex} \TeX\ engine on the provided \mtbox{currentFile} reference, generating a corresponding file in the Portable Document Format, as expected.
 
 \begin{description}
+\item[\rpbox{branch}{stable}] This option allows branching formats for the current engine, mainly focused on package development. Users of current \TeX\ distributions might benefit from format branching in order to easily test documents and code against the upcoming releases. Possible values are:
+
+\begin{description}
+\item[\povalue{stable}] This value, as the name implies, enables the stable engine format branch. Note that this is the default format.
+
+\item[\povalue{unsafe}] This value enables the unsafe engine format branch. According to the documentation, at all costs, avoid using this, or any, unsafe invocation with documents off the net or that are otherwise untrusted in any way.
+\end{description}
+
 \item[\abox{interaction}] This option alters the underlying engine behaviour. If this option is omitted, \TeX\ will prompt the user for interaction in the event of an error. Possible values are, in order of increasing user interaction (courtesy of our master Enrico Gregorio):
 
 \begin{description}
diff --git a/support/arara/doc/version.tex b/support/arara/doc/version.tex
index 3af67b5cb5..cb6b1ffdc8 100644
--- a/support/arara/doc/version.tex
+++ b/support/arara/doc/version.tex
@@ -1 +1 @@
-6.1.6
\ No newline at end of file
+6.1.7
\ No newline at end of file
diff --git a/support/arara/scripts/arara.sh b/support/arara/scripts/arara.sh
index 1582f531e7..1582f531e7 100644..100755
--- a/support/arara/scripts/arara.sh
+++ b/support/arara/scripts/arara.sh
diff --git a/support/arara/scripts/rules/arara-rule-xelatex.yaml b/support/arara/scripts/rules/arara-rule-xelatex.yaml
index 03ab0d0af0..12d1864602 100644
--- a/support/arara/scripts/rules/arara-rule-xelatex.yaml
+++ b/support/arara/scripts/rules/arara-rule-xelatex.yaml
@@ -19,7 +19,8 @@ arguments:
 - identifier: branch
   flag: >
     @{
-        engines = [ 'stable' : 'xelatex', 'developer' : 'xelatex-dev' ];
+        engines = [ 'stable' : 'xelatex', 'developer' : 'xelatex-dev',
+                    'unsafe' : 'xelatex-unsafe' ];
         if (engines.keySet().contains(parameters.branch)) {
             return engines.get(parameters.branch);
         } else {
diff --git a/support/arara/scripts/rules/arara-rule-xetex.yaml b/support/arara/scripts/rules/arara-rule-xetex.yaml
index 7cc315f3ce..e3956f48e3 100644
--- a/support/arara/scripts/rules/arara-rule-xetex.yaml
+++ b/support/arara/scripts/rules/arara-rule-xetex.yaml
@@ -12,10 +12,21 @@ commands:
 - name: XeTeX engine
   command: >
     @{
-        return getCommand('xetex', interaction, shell,
+        return getCommand(branch, interaction, shell,
                synctex, options, reference.getName());
     }
 arguments:
+- identifier: branch
+  flag: >
+    @{
+        engines = [ 'stable' : 'xetex', 'unsafe' : 'xetex-unsafe' ];
+        if (engines.keySet().contains(parameters.branch)) {
+            return engines.get(parameters.branch);
+        } else {
+            throwError('The valid branch values are: ' + engines.keySet());
+        }
+    }
+  default: 'stable'
 - identifier: interaction
   flag: >
     @{