[latex3-commits] [git/LaTeX3-latex3-l3build] master: Document test interactions (fixes #56) [ci skip] (2336c93)

[Joseph Wright]

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

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

commit 2336c93a2e3704fb98be90ffecc6ceb8f3e984d7
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Mar 6 20:05:51 2018 +0000

    Document test interactions (fixes #56) [ci skip]


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

2336c93a2e3704fb98be90ffecc6ceb8f3e984d7
 l3build.dtx |    9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/l3build.dtx b/l3build.dtx
index cb4b6ee..316a5c0 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -616,6 +616,15 @@
 %
 % This section lists all variables defined in the |l3build.lua| script that are available for customisation.
 %
+% \subsection{Interaction between tests}
+%
+% Tests are run in a single directory, so whilst they are may be isolated from
+% the system \TeX{} tree they do share files. This may be significant if
+% installation-type files are generated during a test, for example by a 
+% |filecontents| environment in \LaTeX{}. Typically, you should set up your
+% 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.
+%
 % \luavartypeset
 %
 % \subsection{Multiple sets of tests}