[latex3-commits] [git/LaTeX3-latex3-latex2e] master: document candidate best practice with respect to \IncludeInRelease dates and \patch at level aso fixed date for remreset inclusion (8209ee6)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : master
Link       : https://github.com/latex3/latex2e/commit/8209ee63a07f4e76457f14155b94af91bff68ed7

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

commit 8209ee63a07f4e76457f14155b94af91bff68ed7
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Fri Mar 16 14:36:20 2018 +0100

    document candidate best practice with respect to \IncludeInRelease dates and \patch at level
    aso fixed date for remreset inclusion


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

8209ee63a07f4e76457f14155b94af91bff68ed7
 base/ltcounts.dtx                   |    2 +-
 base/ltvers.dtx                     |   25 +++++++++++++++++++++++--
 base/testfiles/tlb-remreset-001.lvt |    3 +--
 base/testfiles/tlb-remreset-002.lvt |    3 +--
 base/testfiles/tlb-remreset-003.lvt |    3 +--
 5 files changed, 27 insertions(+), 9 deletions(-)

diff --git a/base/ltcounts.dtx b/base/ltcounts.dtx
index 9aaa0a5..5e9e644 100644
--- a/base/ltcounts.dtx
+++ b/base/ltcounts.dtx
@@ -330,7 +330,7 @@
 % \begin{macro}{\@removefromreset}
 %    \changes{v1.1k}{2018/03/08}{Interface added}
 %    \begin{macrocode}
-%<latexrelease>\IncludeInRelease{2018/03/01}{\@removefromreset}{Add interfaces}%
+%<latexrelease>\IncludeInRelease{2018/02/01}{\@removefromreset}{Add interfaces}%
 %<*2ekernel|latexrelease>
 %    \end{macrocode}
 %    
diff --git a/base/ltvers.dtx b/base/ltvers.dtx
index d8162ca..6c4c328 100644
--- a/base/ltvers.dtx
+++ b/base/ltvers.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright 1993-2016
+% Copyright 1993-2018
 % The LaTeX3 Project and any individual authors listed elsewhere
 % in this file.
 %
@@ -33,7 +33,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltvers.dtx}
-             [2018/01/08 v1.1a LaTeX Kernel (Version Info)]
+             [2018/03/16 v1.1a LaTeX Kernel (Version Info)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltvers.dtx}
@@ -84,7 +84,27 @@
 %
 % \begin{macro}{\fmtname}
 % \begin{macro}{\fmtversion}
+% \begin{macro}{\latexreleaseversion}
 % \begin{macro}{\patch at level}
+%    A |\patch at level| of \texttt{0} or higher denotes an official
+%    public release. A negative value indicates a candidate release
+%    that is not distributed.
+%
+%    If we put code updates into the kernel that are supposed to go
+%    into the next release we set the |\patch at level| to \texttt{-1}
+%    and the |\fmtversion| / |\latexreleaseversion| to  the dated of
+%    the next release (guessed, the real value is not so important and
+%    will get corrected when we make the release official).
+%
+%    If the |\patch at level| is already at \texttt{-1} we do nothing
+%    here and use the |\fmtversion| date for  any new|\IncludeInRelease|
+%    line when we add further code.
+%
+%    Finally, if we do make a public release we either just set the
+%    |\patch at level| to zero (if our initial guess was good) or we also
+%    change the date and then have to additionally change to that date
+%    on all the |\IncludeInRelease| statements that used the
+%    ``guessed'' date.
 %    \begin{macrocode}
 %<*2ekernel>
 \def\fmtname{LaTeX2e}
@@ -100,6 +120,7 @@
 % \end{macro}
 % \end{macro}
 % \end{macro}
+% \end{macro}
 %
 % Check that the format being made is not too old.
 % The error message complains about `more than 5 years'
diff --git a/base/testfiles/tlb-remreset-001.lvt b/base/testfiles/tlb-remreset-001.lvt
index 876f01d..935733e 100644
--- a/base/testfiles/tlb-remreset-001.lvt
+++ b/base/testfiles/tlb-remreset-001.lvt
@@ -1,6 +1,5 @@
 %
-% Check that latexrelease generates no errors,
-% eg from mis-matched \(End)IncludeInRelease
+% Tests for \@removefromreset
 
 \documentclass{article}
 
diff --git a/base/testfiles/tlb-remreset-002.lvt b/base/testfiles/tlb-remreset-002.lvt
index 1d29c68..2523b9d 100644
--- a/base/testfiles/tlb-remreset-002.lvt
+++ b/base/testfiles/tlb-remreset-002.lvt
@@ -1,6 +1,5 @@
 %
-% Check that latexrelease generates no errors,
-% eg from mis-matched \(End)IncludeInRelease
+% Check counter numbered within and without ...
 
 \documentclass{article}
 
diff --git a/base/testfiles/tlb-remreset-003.lvt b/base/testfiles/tlb-remreset-003.lvt
index 8651e46..4c1d45b 100644
--- a/base/testfiles/tlb-remreset-003.lvt
+++ b/base/testfiles/tlb-remreset-003.lvt
@@ -1,6 +1,5 @@
 %
-% Check that latexrelease generates no errors,
-% eg from mis-matched \(End)IncludeInRelease
+% Check counter numbered within and without ...
 
 \documentclass{article}