[latex3-commits] [git/LaTeX3-latex3-l3build] master: Need a documented runcmd() for e.g. beamer (e4a100c)

[Joseph Wright]

Repository : https://github.com/latex3/l3build
On branch  : master
Link       : https://github.com/latex3/l3build/commit/e4a100c69990a24a1d801b3cb5fd2bb6b5422eb2

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

commit e4a100c69990a24a1d801b3cb5fd2bb6b5422eb2
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed Jun 26 14:55:28 2019 +0100

    Need a documented runcmd() for e.g. beamer


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

e4a100c69990a24a1d801b3cb5fd2bb6b5422eb2
 l3build-typesetting.lua |  2 +-
 l3build.dtx             | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/l3build-typesetting.lua b/l3build-typesetting.lua
index c8c00cc..5133d08 100644
--- a/l3build-typesetting.lua
+++ b/l3build-typesetting.lua
@@ -57,7 +57,7 @@ function dvitopdf(name, dir, engine, hide)
 end
 
 -- An auxiliary used to set up the environmental variables
-local function runcmd(cmd,dir,vars)
+function runcmd(cmd,dir,vars)
   local dir = dir or "."
   local dir = abspath(dir)
   local vars = vars or {}
diff --git a/l3build.dtx b/l3build.dtx
index 4058a25..7e1240d 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -1743,6 +1743,16 @@
 %   Runs \luavar{typesetexe} on the \meta{name} inside the \meta{dir}.
 % \end{function}
 %
+% \begin{function}{runcmd()}
+%   \begin{syntax}
+%     |runcmd(|\meta{cmd},\meta{dir},|{|\meta{envvars}|})|
+%   \end{syntax}
+%   A generic function which runs the \meta{cmd} in the \meta{dir}, first
+%   setting up all of the environmental variables specified to
+%   point to the |local| and |working| directories. This function is useful
+%   when creating non-standard typesetting steps.
+% \end{function}
+%
 % \subsection{Customising the target list}
 %
 % The targets known to \pkg{l3build} are stored in the global table