l3build (4aug18)

git-svn-id: svn://tug.org/texlive/trunk@48348 c570f23f-e606-0410-a88d-b1316a301751

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