[latex3-commits] [git/LaTeX3-latex3-latex3] main: Update comments in l3deprecation (8847d9473)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/8847d9473359330a452e5a6258c0710b8b2a3f7f

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

commit 8847d9473359330a452e5a6258c0710b8b2a3f7f
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Jan 11 22:55:11 2022 +0000

    Update comments in l3deprecation


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

8847d9473359330a452e5a6258c0710b8b2a3f7f
 l3kernel/l3deprecation.dtx | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/l3kernel/l3deprecation.dtx b/l3kernel/l3deprecation.dtx
index 436d90117..edc0b51ad 100644
--- a/l3kernel/l3deprecation.dtx
+++ b/l3kernel/l3deprecation.dtx
@@ -54,31 +54,6 @@
 % A few commands have had to be deprecated over the years.  This module
 % defines deprecated and deleted commands to produce an error.
 %
-% The life of a deprecated command has several stages.
-% \begin{itemize}
-% \item When we decide it should be eventually removed the command's
-%   definition is put in this file \pkg{l3deprecation.dtx} and the name
-%   of the command is added to the list in \pkg{l3obsolete.txt}.  The
-%   command remains defined by default for $12$ or more months,
-%   typically until the end of a year.  During that time, if \pkg{expl3}
-%   is loaded with any of the options \texttt{check-declarations} or
-%   \texttt{log-functions} or \texttt{enable-debug} typically used in
-%   package test files, the command will produce a warning.
-% \item Then by default the command produces an error for all users,
-%   which can be suppressed for $6$ months through the option
-%   \texttt{undo-recent-deprecations}.
-% \item After this $6$-month grace period, the command irreversibly
-%   produces an error.  Its original definition can then be removed from
-%   the sources, leaving only the error definition.  In
-%   \pkg{l3obsolete.txt} its name is moved from the \enquote{Deprecated
-%   functions and variables} list to the \enquote{Removed functions and
-%   variables} list.
-% \end{itemize}
-% Package authors are encouraged to have a test file with
-% \cs{debug_on:n} |{deprecation}|, which makes commands at all stages of
-% this list into errors.  This helps detect uses of deprecated commands
-% before user complain.
-%
 % \end{documentation}
 %
 % \begin{implementation}