diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3msg.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3msg.dtx | 55 |
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} |