summaryrefslogtreecommitdiff
path: root/macros/latex-dev/base/lterror.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex-dev/base/lterror.dtx')
-rw-r--r--macros/latex-dev/base/lterror.dtx48
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