diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3msg.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3msg.dtx | 28 |
1 files changed, 26 insertions, 2 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx b/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx index 635c1a0a827..fd58910af9a 100644 --- a/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx +++ b/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx @@ -35,7 +35,7 @@ % %<*driver|package> \RequirePackage{l3names} -\GetIdInfo$Id: l3msg.dtx 2601 2011-08-16 23:20:27Z bruno $ +\GetIdInfo$Id: l3msg.dtx 2728 2011-09-05 19:13:18Z joseph $ {L3 Experimental messages} %</driver|package> %<*driver> @@ -74,7 +74,7 @@ % % The system used by \pkg{l3msg} to create messages divides the process % into two distinct parts. Named messages are created in the first part -% of the process; at this stage, no decision is made about the type +% of the process; at this stage, no decision is made about the type of % output that the message will produce. The second part of the process % is actually producing a message. At this stage a choice of message % \emph{class} has to be made, for example \texttt{error}, @@ -388,6 +388,30 @@ % \end{function} % % \section{Redirecting messages} +% +% Each message has a \enquote{name}, which can be used to alter the behaviour +% of the message when it is given. Thus we might have +% \begin{verbatim} +% \msg_new:nnnn { module } { my-message } { Some~text } { Some~more~text } +% \end{verbatim} +% to define a message, with +% \begin{verbatim} +% \msg_error:nn { module } { my-message } +% \end{verbatim} +% when it is used. With no filtering, this will raise an error. However, we +% could alter the behaviour with +% \begin{verbatim} +% \msg_redirect_class:nn { error } { warning } +% \end{verbatim} +% to turn all errors into warnings, or with +% \begin{verbatim} +% \msg_redirect_module:nnn { module } { error } { warning } +% \end{verbatim} +% to alter just those messages for module, or even +% \begin{verbatim} +% \msg_redirect_name:nnn { module } { my-message } { warning } +% \end{verbatim} +% to target just one message. % % \begin{function}{\msg_redirect_class:nn} % \begin{syntax} |