l3build (30jul19)

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

1 files changed, 72 insertions, 12 deletions

diff --git a/Master/texmf-dist/source/latex/l3build/l3build.dtx b/Master/texmf-dist/source/latex/l3build/l3build.dtx
index 4ca84094d6e..563051ac4b6 100644
--- a/Master/texmf-dist/source/latex/l3build/l3build.dtx
+++ b/Master/texmf-dist/source/latex/l3build/l3build.dtx
@@ -153,6 +153,8 @@
 \luavarset{recordstatus}{false}       {Switch to include error level from test runs in \texttt{.tlg} files}
 \luavarset{manifestfile}        {"MANIFEST.md"} {Filename to use for the manifest file}
 \luavarseparator
+\luavarset{tdslocations}{\{ \}}{Map for non-standard file installations}
+\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}
 \luavarseparator
@@ -227,7 +229,7 @@
 %    }^^A
 % }
 %
-% \date{Released 2019-06-27}
+% \date{Released 2019-07-30}
 %
 % \maketitle
 % \tableofcontents
@@ -1214,6 +1216,47 @@
 %
 % \section{Release-focussed features}
 %
+% \subsection{Installation structure}
+%
+% With the standard settings, \pkg{l3build} will install files within
+% the \TeX{} directory structure (TDS) as follows
+% \begin{itemize}
+%   \item \var{installfiles} within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{tex/\meta{format}}
+%   \item \var{sourcefiles} within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{source/\meta{format}}
+%   \item Typeset PDFs within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{doc/\meta{format}}
+%   \item \var{bstfiles} within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{bibtex/bst}
+%   \item \var{bibfiles} within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{bibtex/bib}
+%   \item \var{makeindexfiles} within a \texttt{\meta{bundle}/\meta{module}}
+%     (or \texttt{\meta{module}}) directory inside \texttt{makeindex}
+% \end{itemize}
+%
+% For more complex set ups, this can be customised using the
+% \luavar{tdslocations} table. Each entry there should be a glob specifying the
+% TDS position of a file or files. Any files not specified in the table
+% will use the standard locations above. For example, to place some files
+% in the generic tree, some in the plain \TeX{} tree and some in the \LaTeX{}
+% tree, one might use the set up shown in Figure~\ref{fig:tds}.
+% \begin{figure}
+%   \begin{lstlisting}[frame=single,language={[5.2]Lua},gobble = 6]
+%     tdslocations = 
+%       {
+%         "tex/generic/mypkg/*.generic.tex" ,
+%         "tex/plain/mypkg/*.plain.tex"    ,
+%         "tex/latex/mypkg/*.latex.tex"
+%       }
+%   \end{lstlisting}
+%   \caption{Example \texttt{tdslocations} table.}
+%   \label{fig:tds}
+% \end{figure}
+%
+% The table is read in order, and thus specific file names should come before
+% potential wild-card matches.
+%
 % \subsection{Automatic tagging}
 % \label{sec:tagging}
 %
@@ -1580,6 +1623,13 @@
 %   all files in the \meta{path}.
 % \end{function}
 %
+% \begin{function}{glob_to_pattern()}
+%   \begin{syntax}
+%     |glob_to_pattern(|\meta{glob}|)|
+%   \end{syntax}
+%   Returns the \meta{glob} converted to a Lua pattern.
+% \end{function}
+%
 % \begin{function}{jobname()}
 %   \begin{syntax}
 %     |jobname(|\meta{file}|)|
@@ -2246,15 +2296,20 @@
       \relax
   \fi
 \else
-  \special{%
-    pdf: docinfo
-      <<
-        /Creator        (TeX)
-        /CreationDate   ()
-        /ModDate        ()
-        /Producer       (\ifx\XeTeXversion\@undefined\else x\fi dvipdfmx)
-      >>
-  }
+  \ifnum 0%
+  \ifx\XeTeXversion\@undefined\else 1\fi
+  \ifx\kanjiskip\@undefined\else 1\fi
+  >0 %
+    \special{%
+      pdf: docinfo
+        <<
+          /Creator        (TeX)
+          /CreationDate   ()
+          /ModDate        ()
+          /Producer       (\ifx\XeTeXversion\@undefined\else x\fi dvipdfmx)
+        >>
+    }
+  \fi
 \fi
 %    \end{macrocode}
 %
@@ -2272,8 +2327,13 @@
     \pdfvariable objcompresslevel=0 %
   \fi
 \else
-  \special{dvipdfmx:config z 0}% Compress level
-  \special{dvipdfmx:config C 0x40}% Object compression
+  \ifnum 0%
+  \ifx\XeTeXversion\@undefined\else 1\fi
+  \ifx\kanjiskip\@undefined\else 1\fi
+  >0 %
+    \special{dvipdfmx:config z 0}% Compress level
+    \special{dvipdfmx:config C 0x40}% Object compression
+  \fi
 \fi
 %    \end{macrocode}
 %