[latex3-commits] [latex3/l3build] main: Document dynamicfiles and glob behaviour (fixes #250) (17c44be)

[github at latex-project.org]

Repository : https://github.com/latex3/l3build
On branch  : main
Link       : https://github.com/latex3/l3build/commit/17c44be052ce5f8dddc9aeb23d8418875483660e

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

commit 17c44be052ce5f8dddc9aeb23d8418875483660e
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Sun Jul 16 21:15:03 2023 +0100

    Document dynamicfiles and glob behaviour (fixes #250)


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

17c44be052ce5f8dddc9aeb23d8418875483660e
 l3build.dtx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/l3build.dtx b/l3build.dtx
index 3d135b4..57d7023 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -676,6 +676,14 @@
 % tests such that they do not use the same names for such files: this may lead
 % to variable outcomes depending on the order in which tests are run.
 %
+% Where files need to be removed between different engine tests, they should
+% be listed in |dynamicfiles|. If the files are generated in a directory
+% structure, e.g.~by \pkg{minted}, then a recursive glob will be needed,
+% for example
+% \begin{Verbatim}
+%   dynamicfiles = {"_minted-*/**"}
+% \end{Verbatim}
+%
 % \subsection{Selective running of tests}
 %
 % The variables |includetests| and |excludetests| may be used to select which