CTAN sync 201909150300

1 files changed, 43 insertions, 5 deletions

diff --git a/macros/latex-dev/base/lterror.dtx b/macros/latex-dev/base/lterror.dtx
index daf645b8b8..3f6c436970 100644
--- a/macros/latex-dev/base/lterror.dtx
+++ b/macros/latex-dev/base/lterror.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright 1993-2018
+% Copyright (C) 1993-2019
 % The LaTeX3 Project and any individual authors listed elsewhere
 % in this file.
 %
@@ -13,7 +13,7 @@
 % The latest version of this license is in
 %    https://www.latex-project.org/lppl.txt
 % and version 1.3c or later is part of all distributions of LaTeX
-% version 2005/12/01 or later.
+% version 2008 or later.
 %
 % This file has the LPPL maintenance status "maintained".
 %
@@ -32,7 +32,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{lterror.dtx}
-             [2018/08/05 v1.2p LaTeX Kernel (errors)]
+             [2019/08/30 v1.2q LaTeX Kernel (errors)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{lterror.dtx}
@@ -87,7 +87,7 @@
 % \changes{v1.2p}{2016/10/15}
 %         {Require e\TeX{}}
 %
-% \section{Error handling}
+% \section{Error handling and tracing}
 %
 % This section defines \LaTeX's error commands.
 %
@@ -738,7 +738,6 @@ Type  H <return>  for immediate help.}%
 %    out, since we decided to use catcode 15 instead.
 %    \begin{macrocode}
 %\def\@invalidchar{\@latex@error{Invalid character in input}\@ehc}
-%</2ekernel>
 %    \end{macrocode}
 % \end{macro}
 %
@@ -759,5 +758,44 @@ Type  H <return>  for immediate help.}%
 % In output routine, caused by a float environment or
 % |\marginpar| occurring in inner vertical mode.
 %
+%
+% \subsection{Tracing}
+%
+%    The \texttt{trace} package implements the commands \cs{traceon}
+%    and \cs{traceoff} that work similar to \cs{tracingall} but skip
+%    certain code blocks that produce a lot of tracing output being of no
+%    interest during debugging (for example loading a font).
+%    Code blocks that should be hidden during tracing need
+%    to be surrounded by the macros \cs{conditionally@traceoff}
+%    and \cs{contionally@traceon}.
+%
+%    For the kernel code the \texttt{trace} package then redefines a
+%    number of macros to  include this tracing support.
+%
+%    However, in order to allow any macro package to react to
+%    \cs{traceon} we also provide dummy definitions for the two
+%    commands in the kernel so that they can be used by external
+%    packages without the
+%    need to distinguish between \texttt{trace} being loaded or not.
+%
+
+%  \begin{macro}{\conditionally@traceon}
+% \changes{v1.2q}{2019/08/30}{Macro added}
+%  \begin{macro}{\conditionally@traceoff}
+% \changes{v1.2q}{2019/08/30}{Macro added}
+%    These are only dummy definitions. For  details see the
+%    \texttt{trace} package.
+%    \begin{macrocode}
+\let\conditionally@traceon\@empty
+\let\conditionally@traceoff\@empty
+%    \end{macrocode}
+%  \end{macro}
+%  \end{macro}
+%
+%    
+%    \begin{macrocode}
+%</2ekernel>
+%    \end{macrocode}
+%
 %\Finale
 \endinput