summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3msg.dtx')
-rw-r--r--Master/texmf-dist/source/latex/l3kernel/l3msg.dtx55
1 files changed, 30 insertions, 25 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx b/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx
index fd58910af9a..4b75c2ce925 100644
--- a/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx
+++ b/Master/texmf-dist/source/latex/l3kernel/l3msg.dtx
@@ -9,7 +9,7 @@
%%
%% http://www.latex-project.org/lppl.txt
%%
-%% This file is part of the "expl3 bundle" (The Work in LPPL)
+%% This file is part of the "l3kernel bundle" (The Work in LPPL)
%% and all files in that bundle must be distributed together.
%%
%% The released version of this bundle is available from CTAN.
@@ -35,7 +35,7 @@
%
%<*driver|package>
\RequirePackage{l3names}
-\GetIdInfo$Id: l3msg.dtx 2728 2011-09-05 19:13:18Z joseph $
+\GetIdInfo$Id: l3msg.dtx 2812 2011-09-12 09:19:26Z bruno $
{L3 Experimental messages}
%</driver|package>
%<*driver>
@@ -100,7 +100,7 @@
% where it will help to show meaning. In particular, |\\| may be
% used to force a new line and \verb*|\ | forces an explicit space.
%
-% \begin{function}{\msg_new:nnnn, \msg_new:nnn}
+% \begin{function}[updated = 2011-08-16]{\msg_new:nnnn, \msg_new:nnn}
% \begin{syntax}
% \cs{msg_new:nnnn} \Arg{module} \Arg{message} \Arg{text}
% ~~\Arg{more text}
@@ -134,7 +134,7 @@
%
% \section{Contextual information for messages}
%
-% \begin{function}[EXP]{\msg_line_context:}
+% \begin{function}[rEXP]{\msg_line_context:}
% \begin{syntax}
% \cs{msg_line_context:}
% \end{syntax}
@@ -239,7 +239,7 @@
% Messages behave differently depending on the message class. A number
% of standard message classes are supplied, but more can be
% created.
-%
+%
% When issuing messages, any arguments passed should use
% \cs{tl_to_str:n} or \cs{token_to_str:N} to prevent unwanted expansion
% of the material.
@@ -388,7 +388,7 @@
% \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}
@@ -397,7 +397,7 @@
% to define a message, with
% \begin{verbatim}
% \msg_error:nn { module } { my-message }
-% \end{verbatim}
+% \end{verbatim}
% when it is used. With no filtering, this will raise an error. However, we
% could alter the behaviour with
% \begin{verbatim}
@@ -411,7 +411,7 @@
% \begin{verbatim}
% \msg_redirect_name:nnn { module } { my-message } { warning }
% \end{verbatim}
-% to target just one message.
+% to target just one message.
%
% \begin{function}{\msg_redirect_class:nn}
% \begin{syntax}
@@ -426,8 +426,7 @@
%
% \begin{function}{\msg_redirect_module:nnn}
% \begin{syntax}
-% \cs{msg_redirect_module:nnn} \Arg{module} \Arg{class one}
-% ~~\Arg{class two}
+% \cs{msg_redirect_module:nnn} \Arg{module} \Arg{class one} \Arg{class two}
% \end{syntax}
% Redirects message of \meta{class one} for \meta{module} to act as
% though they were from \meta{class two}. Messages of \meta{class one}
@@ -467,7 +466,7 @@
% will not include any additional printing information in the message:
% contrast with |\\| in messages. The |two| version adds two lines.
% \end{function}
-%
+%
% \begin{function}{\msg_interrupt:xxx}
% \begin{syntax}
% \cs{msg_interrupt:xxx} \Arg{first line} \Arg{text} \Arg{extra text}
@@ -478,12 +477,12 @@
% !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
% !
% ! <first line>
-% !
+% !
% ! <text>
-% !...............................................
+% !...............................................
% \end{verbatim}
% where the \meta{text} will be wrapped to fit within the current
-% line length. The user may then request more information, at which
+% line length. The user may then request more information, at which
% stage the \meta{extra text} will be shown in the terminal in the
% format
% \begin{verbatim}
@@ -506,7 +505,7 @@
% .................................................
% \end{verbatim}
% where the \meta{text} will be wrapped to fit within the current
-% line length.
+% line length.
% \end{function}
%
% \begin{function}{\msg_term:x}
@@ -521,7 +520,7 @@
% *************************************************
% \end{verbatim}
% where the \meta{text} will be wrapped to fit within the current
-% line length.
+% line length.
% \end{function}
%
% \section{Kernel-specific functions}
@@ -530,10 +529,10 @@
% but have their own functions. This allows some text to be pre-defined,
% and also ensures that serious errors can be handled properly.
%
-% \begin{function}{\msg_kernel_new:nnnn, \msg_kernel_new:nnn}
+% \begin{function}[updated = 2011-08-16]
+% {\msg_kernel_new:nnnn, \msg_kernel_new:nnn}
% \begin{syntax}
-% \cs{msg_kernel_new:nnnn} \Arg{module} \Arg{message} \Arg{text}
-% ~~\Arg{more text}
+% \cs{msg_kernel_new:nnnn} \Arg{module} \Arg{message} \Arg{text} \Arg{more text}
% \end{syntax}
% Creates a kernel \meta{message} for a given \meta{module}.
% The message will be defined to first give \meta{text} and then
@@ -548,8 +547,7 @@
%
% \begin{function}{\msg_kernel_set:nnnn, \msg_kernel_set:nnn}
% \begin{syntax}
-% \cs{msg_kernel_set:nnnn} \Arg{module} \Arg{message} \Arg{text}
-% ~~\Arg{more text}
+% \cs{msg_kernel_set:nnnn} \Arg{module} \Arg{message} \Arg{text} \Arg{more text}
% \end{syntax}
% Sets up the text for a kernel \meta{message} for a given \meta{module}.
% The message will be defined to first give \meta{text} and then
@@ -641,7 +639,8 @@
% normal error messages, as none of the tools to print to the terminal
% or the log file are expandable.
%
-% \begin{function}{\msg_expandable_error:n}
+% \begin{function}[added = 2011-08-11, updated = 2011-08-13]
+% {\msg_expandable_error:n}
% \begin{syntax}
% \cs{msg_expandable_error:n} \Arg{error message}
% \end{syntax}
@@ -673,7 +672,7 @@
\package_check_loaded_expl:
%</package>
% \end{macrocode}
-%
+%
% \begin{variable}{\l_msg_tmp_tl}
% A general scratch for the module.
% \begin{macrocode}
@@ -1537,7 +1536,7 @@
\c_msg_return_text_tl
}
% \end{macrocode}
-%
+%
% Messages for earlier kernel modules.
% \begin{macrocode}
\msg_kernel_new:nnnn { kernel } { bad-number-of-arguments }
@@ -1631,7 +1630,7 @@
% (with category code $7$) and keep tokens until that space character,
% dropping everything else until \cs{q_stop}. The \cs{c_zero} prevents
% losing braces around the user-inserted text if any, and stops the
-% expansion of \cs{tex_romannumeral:D}.
+% expansion of \tn{romannumeral}.
% \begin{macrocode}
\group_begin:
\char_set_catcode_math_superscript:N \^
@@ -1667,7 +1666,9 @@
% \begin{macro}{\msg_class_new:nn}
% This is only ever used in a |set| fashion.
% \begin{macrocode}
+%<*deprecated>
\cs_new_eq:NN \msg_class_new:nn \msg_class_set:nn
+%</deprecated>
% \end{macrocode}
% \end{macro}
%
@@ -1679,11 +1680,13 @@
% The performance here is never going to be good enough for tracing
% code, so let's be realistic.
% \begin{macrocode}
+%<*deprecated>
\cs_new_eq:NN \msg_trace:nnxxxx \msg_log:nnxxxx
\cs_new_eq:NN \msg_trace:nnxxx \msg_log:nnxxx
\cs_new_eq:NN \msg_trace:nnxx \msg_log:nnxx
\cs_new_eq:NN \msg_trace:nnx \msg_log:nnx
\cs_new_eq:NN \msg_trace:nn \msg_log:nn
+%</deprecated>
% \end{macrocode}
%\end{macro}
%
@@ -1696,6 +1699,7 @@
% \begin{macro}{\msg_direct_term:xx}
% These were all too low-level.
% \begin{macrocode}
+%<*deprecated>
\cs_new_protected:Npn \msg_generic_new:nnn #1#2#3 { \deprecated }
\cs_new_protected:Npn \msg_generic_new:nn #1#2 { \deprecated }
\cs_new_protected:Npn \msg_generic_set:nnn #1#2#3 { \deprecated }
@@ -1703,6 +1707,7 @@
\cs_new_protected:Npn \msg_direct_interrupt:xxxxx #1#2#3#4#5 { \deprecated }
\cs_new_protected:Npn \msg_direct_log:xx #1#2 { \deprecated }
\cs_new_protected:Npn \msg_direct_term:xx #1#2 { \deprecated }
+%</deprecated>
% \end{macrocode}
% \end{macro}
% \end{macro}