[latex3-commits] [latex3/latex3] msg-scope: Deprecate global msg setting (ac16fe5b7)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : msg-scope
Link       : https://github.com/latex3/latex3/commit/ac16fe5b78a1724f7eaace7f3be365275b4f0afc

>---------------------------------------------------------------

commit ac16fe5b78a1724f7eaace7f3be365275b4f0afc
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed Jan 17 07:35:48 2024 +0000

    Deprecate global msg setting


>---------------------------------------------------------------

ac16fe5b78a1724f7eaace7f3be365275b4f0afc
 l3kernel/CHANGELOG.md       |  1 +
 l3kernel/doc/l3obsolete.txt |  2 ++
 l3kernel/l3deprecation.dtx  | 15 +++++++++++++++
 l3kernel/l3msg.dtx          | 20 ++++++--------------
 4 files changed, 24 insertions(+), 14 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index bff54eb7a..8b55a27c3 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -17,6 +17,7 @@ this project uses date-based 'snapshot' version identifiers.
 
 ### Deprecated
 - `\keys_set_filter:nnn(nN)` in favor of  `\keys_set_exclude_groups:nnn(nN)`
+- `\msg_gset:nnn(n)`
 
 ## [2024-01-04]
 
diff --git a/l3kernel/doc/l3obsolete.txt b/l3kernel/doc/l3obsolete.txt
index a6a046256..56ebbe707 100644
--- a/l3kernel/doc/l3obsolete.txt
+++ b/l3kernel/doc/l3obsolete.txt
@@ -53,6 +53,8 @@ Function                            Date deprecated
 \l_keys_path_tl                          2020-02-08
 \l_text_accents_tl                       2023-02-07
 \l_text_letterlike_tl                    2023-02-07
+\msg_gset:nnn                            2024-01-11
+\msg_gset:nnnn                           2024-01-11
 \peek_catcode_ignore_spaces:N            2022-01-11
 \peek_catcode_remove_ignore_spaces:N     2022-01-11
 \peek_charcode_ignore_spaces:N           2022-01-11
diff --git a/l3kernel/l3deprecation.dtx b/l3kernel/l3deprecation.dtx
index 49f2dc8a2..9ba572beb 100644
--- a/l3kernel/l3deprecation.dtx
+++ b/l3kernel/l3deprecation.dtx
@@ -313,6 +313,21 @@
 % \end{macro}
 % \end{macro}
 %
+% \subsection{Deprecated \pkg{l3msg} functions}
+%
+%    \begin{macrocode}
+%<@@=msg>
+%    \end{macrocode}
+%
+% \begin{macro}[deprecated]{\msg_gset:nnnn, \msg_gset:nnn}
+%    \begin{macrocode}
+\__kernel_patch_deprecation:nnNNpn { 2024-01-17 } { \msg_set:nnnn }
+\cs_new_protected:Npn \msg_gset:nnnn { \msg_set:nnnn }
+\__kernel_patch_deprecation:nnNNpn { 2024-01-17 } { \msg_set:nnn }
+\cs_new_protected:Npn \msg_gset:nnn { \msg_set:nnn }
+%    \end{macrocode}
+% \end{macro}
+%
 % \subsection{Deprecated \pkg{l3pdf} functions}
 %
 %    \begin{macrocode}
diff --git a/l3kernel/l3msg.dtx b/l3kernel/l3msg.dtx
index b123bf889..acf92d5dc 100644
--- a/l3kernel/l3msg.dtx
+++ b/l3kernel/l3msg.dtx
@@ -120,7 +120,7 @@
 %   used. An error is raised if the \meta{message} already exists.
 % \end{function}
 %
-% \begin{function}{\msg_set:nnnn, \msg_set:nnn, \msg_gset:nnnn, \msg_gset:nnn}
+% \begin{function}{\msg_set:nnnn, \msg_set:nnn}
 %   \begin{syntax}
 %     \cs{msg_set:nnnn} \Arg{module} \Arg{message} \Arg{text} \Arg{more text}
 %   \end{syntax}
@@ -809,15 +809,17 @@
 %     \msg_new:nnnn, \msg_new:nnee, \msg_new:nnxx,
 %     \msg_new:nnn,  \msg_new:nne,  \msg_new:nnx
 %   }
-% \begin{macro}{\msg_gset:nnnn, \msg_gset:nnn}
 % \begin{macro}{\msg_set:nnnn, \msg_set:nnn}
 %   Setting a message simply means saving the appropriate text
 %   into two functions. A sanity check first.
 %    \begin{macrocode}
-\cs_new_protected:Npn \msg_new:nnnn #1#2
+\cs_new_protected:Npn \msg_new:nnnn #1#2#3#4
   {
     \@@_chk_free:nn {#1} {#2}
-    \msg_gset:nnnn {#1} {#2}
+    \cs_gset:cpn { \c_@@_text_prefix_tl #1 / #2 }
+      ##1##2##3##4 {#3}
+    \cs_gset:cpn { \c_@@_more_text_prefix_tl #1 / #2 }
+      ##1##2##3##4 {#4}
   }
 \cs_generate_variant:Nn \msg_new:nnnn { nnee , nnxx }
 \cs_new_protected:Npn \msg_new:nnn #1#2#3
@@ -832,19 +834,9 @@
   }
 \cs_new_protected:Npn \msg_set:nnn #1#2#3
   { \msg_set:nnnn {#1} {#2} {#3} { } }
-\cs_new_protected:Npn \msg_gset:nnnn #1#2#3#4
-  {
-    \cs_gset:cpn { \c_@@_text_prefix_tl #1 / #2 }
-      ##1##2##3##4 {#3}
-    \cs_gset:cpn { \c_@@_more_text_prefix_tl #1 / #2 }
-      ##1##2##3##4 {#4}
-  }
-\cs_new_protected:Npn \msg_gset:nnn #1#2#3
-  { \msg_gset:nnnn {#1} {#2} {#3} { } }
 %    \end{macrocode}
 % \end{macro}
 % \end{macro}
-% \end{macro}
 %
 % \subsection{Messages: support functions and text}
 %