summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3build
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-12-09 21:05:14 +0000
committerKarl Berry <karl@freefriends.org>2021-12-09 21:05:14 +0000
commitd591e5abd44a7f052daf9e40281051f5aeeb2c02 (patch)
tree92674fe1a6f9c080c15b6d5fda2b77e8019bbdc3 /Master/texmf-dist/source/latex/l3build
parentaaf82f524c0dfe58de47f941d55875e5a7a3e8da (diff)
l3build (9dec21)
git-svn-id: svn://tug.org/texlive/trunk@61260 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/l3build')
-rw-r--r--Master/texmf-dist/source/latex/l3build/l3build.dtx22
1 files changed, 21 insertions, 1 deletions
diff --git a/Master/texmf-dist/source/latex/l3build/l3build.dtx b/Master/texmf-dist/source/latex/l3build/l3build.dtx
index 41ff08dc725..b11dc1adcb8 100644
--- a/Master/texmf-dist/source/latex/l3build/l3build.dtx
+++ b/Master/texmf-dist/source/latex/l3build/l3build.dtx
@@ -161,6 +161,7 @@
\luavarset{manifestfile} {"MANIFEST.md"} {Filename to use for the manifest file}
\luavarseparator
\luavarset{tdslocations}{\{ \}}{Map for non-standard file installations}
+\luavarset{tdsdirs}{\{ \}}{List of ready-to-use source locations}
\luavarseparator
\luavarset{uploadconfig} {\meta{table}} {Metadata to describe the package for CTAN (see Table~\ref{tab:upload-setup})}
\luavarset{uploadconfig.pkg}{ctanpkg}{Name of the CTAN package}
@@ -236,7 +237,7 @@
% }^^A
% }
%
-% \date{Released 2021-12-06}
+% \date{Released 2021-12-09}
%
% \maketitle
% \tableofcontents
@@ -774,6 +775,22 @@
% A series of example layouts and matching |build.lua| files are available from
% \url{https://github.com/latex3/l3build/tree/master/examples}.
%
+% For more complex layouts in which sources are laid out in TDS format and
+% should be used directly, the table \var{tdsdirs} is available. Each entry
+% is a source directory and the matching installation target, for example
+% \begin{Verbatim}
+% tdsdirs = {sources = "tex"}
+% \end{Verbatim}
+% This would enable a directory \texttt{sources} in the development area to
+% be used for testing and typesetting, and for it to be installed into the
+% \texttt{tex} tree when building a release. When this method is used, the
+% sources are \emph{not} copied into the local tree: like \var{texmfdir},
+% they are added directly to the areas accessible during a testing or
+% typesetting run. When using this approach, the files listed in
+% \var{typesetfiles} \emph{must} still be included in \var{docfiles}:
+% they have to be directly visible to \pkg{l3build}, not found by
+% \texttt{kpsewhich} searching.
+%
% \subsection{Non-standard formats/binaries}
%
% The standard approach used by \pkg{l3build} is to use a combination
@@ -799,6 +816,9 @@
% xetex = {binary = "texexec", format = "", options = "--xetex"}
% }
% \end{verbatim}
+% Additional tokens can also be injected before the loading of a test file using
+% the |tokens| entry: this might for example be used to select a graphics driver
+% with a DVI-based route.
%
% \subsection{Output normalisation}
% \label{sec:norm}