[latex3-commits] [l3svn] r7306 - Tell l3doc that a deprecated l3box function is deprecated

[noreply at latex-project.org]

Author: bruno
Date: 2017-06-25 20:02:54 +0200 (Sun, 25 Jun 2017)
New Revision: 7306

Modified:
   trunk/l3kernel/l3box.dtx
Log:
Tell l3doc that a deprecated l3box function is deprecated

The current situation for deprecated functions is not good, as they are
listed with removal dates in three places:

- in l3obsolete.txt,
- in their respective modules with the old implementation and
    some code producing a warning,
- in l3deprecation with code that the user can replace them with.

In principle it would be better if the removal date was computed automatically
from the date we decide to deprecate the commands but that is difficult because
l3doc needs to know and the functions themselves need to know.  In any case,
l3obsolete has to be updated by hand at the end of the day so we don't gain much.


Modified: trunk/l3kernel/l3box.dtx
===================================================================
--- trunk/l3kernel/l3box.dtx	2017-06-25 15:45:10 UTC (rev 7305)
+++ trunk/l3kernel/l3box.dtx	2017-06-25 18:02:54 UTC (rev 7306)
@@ -1984,7 +1984,7 @@
 %
 % \subsection{Deprecated functions}
 %
-% \begin{macro}{\box_resize:Nnn, \box_resize:cnn}
+% \begin{macro}[deprecated = 2018-12-31]{\box_resize:Nnn, \box_resize:cnn}
 %    \begin{macrocode}
 \cs_new_eq:NN \box_resize:Nnn \box_resize_to_wd_and_ht_plus_dp:Nnn
 \cs_new_eq:NN \box_resize:cnn \box_resize_to_wd_and_ht_plus_dp:cnn