summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3build
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-08-04 20:54:38 +0000
committerKarl Berry <karl@freefriends.org>2018-08-04 20:54:38 +0000
commite701677aa361258a69f40dad5187444352c6e14b (patch)
treeb4ff67b9a9fe0330e3f30b2d4a83acee43730681 /Master/texmf-dist/source/latex/l3build
parentb37c9b96f81e82408f83040ed006fb21a236538e (diff)
l3build (4aug18)
git-svn-id: svn://tug.org/texlive/trunk@48348 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/l3build')
-rw-r--r--Master/texmf-dist/source/latex/l3build/l3build.dtx50
1 files changed, 35 insertions, 15 deletions
diff --git a/Master/texmf-dist/source/latex/l3build/l3build.dtx b/Master/texmf-dist/source/latex/l3build/l3build.dtx
index f15e1b970a9..5032e78ce5c 100644
--- a/Master/texmf-dist/source/latex/l3build/l3build.dtx
+++ b/Master/texmf-dist/source/latex/l3build/l3build.dtx
@@ -152,6 +152,7 @@
\luavarseparator
\luavarset{asciiengines}{\{"pdftex"\}}{Engines which should log as sure ASCII}
\luavarset{checkruns} {1} {Number of runs to complete for a test before comparing the log}
+\luavarset{ctanzip}{ctanpkg ... "-ctan"}{Name of the zip file created for upload to CTAN}
\luavarset{epoch} {1463734800} {Epoch (Unix date) to set for test runs}
\luavarset{flatten} {true} {Switch to flatten any source structure when sending to CTAN}
\luavarset{maxprintline}{79} {Length of line to use in log files}
@@ -221,7 +222,7 @@
% }^^A
% }
%
-% \date{Released 2018-08-02}
+% \date{Released 2018-08-04}
%
% \maketitle
% \tableofcontents
@@ -329,6 +330,8 @@
% \item |--force| (|-f|) Force checks to run even if sanity
% checks fail, \emph{e.g.}~when |--engine| is not given in
% \luavar{checkengines}
+% \item |--full| Instructs the \texttt{install} target to include the
+% \texttt{doc} and \texttt{source} trees
% \item |--halt-on-error| (|-H|) Specifies that checks
% should stop as soon as possible, rather than running all requested
% tests; the difference file is printed in the terminal directly in the case of failure
@@ -1122,10 +1125,10 @@
% \item Removal of blank lines
% \end{itemize}
%
-% Testing on the result of typesetting \texttt{.pvt} files is carried out using
-% only the standard engine, as aspects of PDF files are not identical between
-% engines. To allow platform-independence, PDF-based tests must use only
-% Type1 or OpenType fonts: Type3 fonts are system-dependent.
+% To allow platform-independence, PDF-based tests must use only Type~1 or
+% OpenType fonts: Type3 fonts are system-dependent. PDF files are
+% engine-specific, thus one |.tpf| file should be stored per engine to be
+% tested.
%
% \section{Release-focussed features}
%
@@ -1251,16 +1254,22 @@
% \toprule
% Entry & Type \\
% \midrule
-% \var{date} & String \\
-% \var{engine} & Table \\
-% \var{force} & Boolean \\
-% \var{halt} & Boolean \\
-% \var{help} & Boolean \\
-% \var{names} & Table \\
-% \var{quiet} & Boolean \\
-% \var{rerun} & Boolean \\
-% \var{testfiledir} & Table \\
-% \var{version} & String \\
+% \var{config} & Table \\
+% \var{date} & String \\
+% \var{dirty} & Boolean \\
+% \var{dry-run} & Boolean \\
+% \var{engine} & Table \\
+% \var{epoch} & String \\
+% \var{first} & Boolean \\
+% \var{force} & Boolean \\
+% \var{full} & Boolean \\
+% \var{halt-on-error} & Boolean \\
+% \var{help} & Boolean \\
+% \var{names} & Table \\
+% \var{quiet} & Boolean \\
+% \var{rerun} & Boolean \\
+% \var{shuffle} & Boolean \\
+% \var{texmfhome} & String \\
% \bottomrule
% \end{tabular}
% \end{center}
@@ -1452,6 +1461,17 @@
% |target| in this table is ignored.
% \end{function}
%
+% \begin{function}{install_files()}
+% \begin{syntax}
+% |install_files(|\meta{target},\meta{full},\meta{dry-run}|)|
+% \end{syntax}
+% Installs the files from the module into the TDS root \meta{target}.
+% If \meta{full} is \texttt{true}, all files are copied: if it is
+% \texttt{false}, the \texttt{doc} and \texttt{source} trees are skipped.
+% If \meta{dry-run} is \texttt{true}, no files are copied, but instead the
+% files which would be copied are reported.
+% \end{function}
+%
% \subsection{Customising the target list}
%
% The targets known to \pkg{l3build} are stored in the global table