summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3build
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-26 22:19:01 +0000
committerKarl Berry <karl@freefriends.org>2017-01-26 22:19:01 +0000
commit532511086aea4b0e4fa585e4833441b0ede48dc4 (patch)
treed69be26f97f21b9e1a547b7787814856d1e99072 /Master/texmf-dist/source/latex/l3build
parent356a18118efafa980a184866ea7dd4fc17391747 (diff)
l3build (26jan17)
git-svn-id: svn://tug.org/texlive/trunk@43054 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/l3build')
-rw-r--r--Master/texmf-dist/source/latex/l3build/l3build.dtx89
-rw-r--r--Master/texmf-dist/source/latex/l3build/l3build.ins28
2 files changed, 74 insertions, 43 deletions
diff --git a/Master/texmf-dist/source/latex/l3build/l3build.dtx b/Master/texmf-dist/source/latex/l3build/l3build.dtx
index 8f1d7b1c0de..9d90382b555 100644
--- a/Master/texmf-dist/source/latex/l3build/l3build.dtx
+++ b/Master/texmf-dist/source/latex/l3build/l3build.dtx
@@ -1,46 +1,31 @@
% \iffalse
-%%
-%% File l3build.dtx (C) Copyright 2014-2016 The LaTeX3 Project
-%%
-%% It may be distributed and/or modified under the conditions of the
-%% LaTeX Project Public License (LPPL), either version 1.3c of this
-%% license or (at your option) any later version. The latest version
-%% of this license is in the file
-%%
-%% http://www.latex-project.org/lppl.txt
-%%
-%% This file is part of the "l3build bundle" (The Work in LPPL)
-%% and all files in that bundle must be distributed together.
-%%
-%% The released version of this bundle is available from CTAN.
-%%
-%% -----------------------------------------------------------------------
-%%
-%% The development version of the bundle can be found at
-%%
-%% http://www.latex-project.org/svnroot/experimental/trunk/
-%%
-%% for those people who are interested.
-%%
-%%%%%%%%%%%
-%% NOTE: %%
-%%%%%%%%%%%
-%%
-%% Snapshots taken from the repository represent work in progress and may
-%% not work or may contain conflicting material! We therefore ask
-%% people _not_ to put them into distributions, archives, etc. without
-%% prior consultation with the LaTeX Project Team.
-%%
-%% -----------------------------------------------------------------------
-%%
%
+% File l3build.dtx (C) Copyright 2014-2017 The LaTeX3 Project
+%
+% It may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License (LPPL), either version 1.3c of this
+% license or (at your option) any later version. The latest version
+% of this license is in the file
+%
+% http://www.latex-project.org/lppl.txt
+%
+% This file is part of the "l3build bundle" (The Work in LPPL)
+% and all files in that bundle must be distributed together.
+%
+% -----------------------------------------------------------------------
+%
+% The development version of the bundle can be found at
+%
+% https://github.com/latex3/latex3
+%
+% for those people who are interested.
%
%<*driver>
\RequirePackage{expl3}
\def\ExplFileName{l3build}
\def\ExplFileDescription{L3 Regression test suite}
-\def\ExplFileDate{2016/11/21}
-\def\ExplFileVersion{6760}
+\def\ExplFileDate{2017/01/25}
+\def\ExplFileVersion{6826}
\documentclass[full]{l3doc}
\renewcommand\partname{Part}
\usepackage{multicol,needspace}
@@ -327,6 +312,7 @@
% \item \texttt{--quiet} (\texttt{-q}) Suppresses output from unpacking
% \item \texttt{--release} (\texttt{-r}) Release string to use when setting
% version data
+% \item \texttt{--textfiledir} (\texttt{-t}) Select a specific set of tests
% \end{itemize}
%
% \begin{buildcmd}{check}
@@ -605,6 +591,35 @@
%
% \luavartypeset
%
+% \subsection{Multiple sets of tests}
+%
+% In most cases, a single set of tests will be appropriate for the module, with
+% a common set of configuration settings applying. However, there are situations
+% where you may need entirely independent sets of tests which have different
+% setting values, for example using different formats or where the entire set
+% will be engine-dependent. To support this, \pkg{l3build} offers the |--testfiledir|
+% (|-t|) command line option. When this is given with a directory argument it
+% overrides the \var{testfiledir} variable. Moreover, before the tests are run,
+% \pkg{l3build} will read |config.lua| within the directory (if available). This
+% should comprise a list of settings which apply to the tests in place of those in
+% the main build script.
+%
+% For example, for the core \LaTeXe{} tests the main test files are contained
+% in a directory |testfiles| and have \var{checksearch} set \var{false}. To test
+% font loading for \XeTeX{} and \LuaTeX{} there are a second set of tests in
+% |testfiles-TU| which use the short |config.lua| file shown in
+% Figure~\ref{fig:testfiledir}. These additional tests are then run using
+% |texlua build.lua check --testfiledir=testfiles-TU|.
+% \begin{figure}
+% \begin{lstlisting}[frame=single,language={[5.2]Lua},gobble = 6]
+% -- Special config for these tests
+% checksearch = true
+% checkengines = {"xetex","luatex"}
+% \end{lstlisting}
+% \caption{The build script for the \pkg{xparse} module.}
+% \label{fig:testfiledir}
+% \end{figure}
+%
% \subsection{Dependencies}
%
% If you have multiple packages that are developed separately but still interact in some way, it's often desirable to integrate them when performing regression tests.
@@ -1179,7 +1194,7 @@
% Is this necessary any more? Probably too late to remove it.
% \begin{macrocode}
\def\STARTMESSAGE{This is a generated file for the l3build validation system.}
-\def\START{\LONGTYPEOUT{START-TEST-LOG^^J^^J%
+\def\START{\LONGTYPEOUT{^^JSTART-TEST-LOG^^J^^J%
\STARTMESSAGE%
^^J^^JDon't change this file in any respect.%
^^J^^J}}
diff --git a/Master/texmf-dist/source/latex/l3build/l3build.ins b/Master/texmf-dist/source/latex/l3build/l3build.ins
index 852c19381d7..e943feb036e 100644
--- a/Master/texmf-dist/source/latex/l3build/l3build.ins
+++ b/Master/texmf-dist/source/latex/l3build/l3build.ins
@@ -1,6 +1,6 @@
\iffalse meta-comment
-File l3build.ins Copyright (C) 2014 The LaTeX3 Project
+File l3build.ins Copyright (C) 2014,2016 The LaTeX3 Project
It may be distributed and/or modified under the conditions of the
LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -12,7 +12,18 @@ of this license is in the file
This file is part of the "l3build bundle" (The Work in LPPL)
and all files in that bundle must be distributed together.
-The released version of this bundle is available from CTAN.
+-----------------------------------------------------------------------
+
+The development version of the bundle can be found at
+
+ https://github.com/latex3/latex3
+
+for those people who are interested.
+
+-----------------------------------------------------------------------
+
+Any modification of this file should ensure that the copyright and
+license information is placed in the derived files.
\fi
@@ -21,12 +32,17 @@ The released version of this bundle is available from CTAN.
\preamble
-EXPERIMENTAL CODE
+Copyright (C) 2014-2016 The LaTeX3 Project
-Do not distribute this file without also distributing the
-source files specified above.
+It may be distributed and/or modified under the conditions of
+the LaTeX Project Public License (LPPL), either version 1.3c of
+this license or (at your option) any later version. The latest
+version of this license is in the file:
-Do not distribute a modified version of this file.
+ http://www.latex-project.org/lppl.txt
+
+This file is part of the "l3build bundle" (The Work in LPPL)
+and all files in that bundle must be distributed together.
\endpreamble
% stop docstrip adding \endinput