From 6d95b4a2c1bbdaea1a3802c822808f476ac5703b Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Fri, 16 Sep 2011 22:35:41 +0000
Subject: l3kernel 2828 (15sep11)

git-svn-id: svn://tug.org/texlive/trunk@23983 c570f23f-e606-0410-a88d-b1316a301751
---
 Master/texmf-dist/source/latex/l3kernel/l3msg.dtx | 55 ++++++++++++-----------
 1 file changed, 30 insertions(+), 25 deletions(-)

(limited to 'Master/texmf-dist/source/latex/l3kernel/l3msg.dtx')

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}
-- 
cgit v1.2.3

