Changelogs, version bump.

Plus minor changes: * Docs: `biblatex` key. * Docs: a changelog section with links to MarkDown documents.
sasozivanovic · Mar 15, 2024 · 2c48b1e · 2c48b1e
1 parent 9916f3d
commit 2c48b1e
Show file tree

Hide file tree

Showing 18 changed files with 92 additions and 43 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,28 @@
 For the development history, see [Memoize's GitHub
 repository](https://github.com/sasozivanovic/memoize).
 
+## 2024/03/15 v1.2.0
+
+* Biblatex support:
+  * Allow for entries containing verbatim material.
+  * Support `\volcite` commands.
+  * Implement `biblatex ccmemo cite`.
+  * Submit all known citation commands to `auto`-keys `(vol)cite(s)`.
+	* The support must be explicitly loaded by `\mmzset{biblatex}`.
+* Minor changes:
+	* Separate generic PGF support out of TikZ support.
+	* Support `latexmk`.
+	* Drop the obsolete workaround for package `morewrites`.
+	* Clear Memoize's `begindocument` hooks after executing them.
+* Documentation:
+  * Introduce section "Support for specific classes and packages".
+  * Improve the documentation of argument specification accepted by CollArgs'
+		command `\CollectArguments` and Advice's key `args`, in particular with
+		reference to the fact that since 2020, the functionality of package
+		`xparse` is mostly integrated into the LaTeX kernel.
+	* Add a note about `TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL`.
+	* Various minor changes.
+
 ## 2024/01/21 v1.1.2
 
 * Fix a bug in Biblatex support.

diff --git a/Makefile b/Makefile
@@ -10,10 +10,10 @@ all: ctan/memoize.zip
 # Prepare the CTAN submission.
 
 PACKAGE = memoize
-VERSION = 1.1.2
+VERSION = 1.2.0
 YEAR = 2024
-MONTH = 01
-DAY = 21
+MONTH = 03
+DAY = 15
 
 FORMAT = generic
 

diff --git a/Makefile.advice b/Makefile.advice
@@ -4,10 +4,10 @@
 # should also contain the files assigned below to SOURCE.
 
 PACKAGE = advice
-VERSION = 1.1.0
+VERSION = 1.1.1
 YEAR = 2024
-MONTH = 01
-DAY = 02
+MONTH = 03
+DAY = 15
 
 FORMAT = generic
 

diff --git a/Makefile.collargs b/Makefile.collargs
@@ -4,10 +4,10 @@
 # should also contain collargs.edtx and collargs.ins.
 
 PACKAGE = collargs
-VERSION = 1.1.0
+VERSION = 1.2.0
 YEAR = 2024
-MONTH = 01
-DAY = 02
+MONTH = 03
+DAY = 15
 
 FORMAT = generic
 

diff --git a/advice.edtx b/advice.edtx
@@ -29,14 +29,14 @@
 % \relax
 %
 %<*main>
-%<latex>\ProvidesPackage{advice}[2024/01/02 v1.1.0 Extend commands and environments]
+%<latex>\ProvidesPackage{advice}[2024/03/15 v1.1.1 Extend commands and environments]
 %<context>%D \module[
 %<context>%D         file=t-advice.tex,
-%<context>%D      version=1.1.0,
+%<context>%D      version=1.1.1,
 %<context>%D        title=Advice,
 %<context>%D     subtitle=Extend commands and environments,
 %<context>%D       author=Saso Zivanovic,
-%<context>%D         date=2024-01-02,
+%<context>%D         date=2024-03-15,
 %<context>%D    copyright=Saso Zivanovic,
 %<context>%D      license=LPPL,
 %<context>%D ]

diff --git a/collargs.edtx b/collargs.edtx
@@ -46,14 +46,14 @@
 % 
 % 
 % \paragraph{Identification}
-%<latex>\ProvidesPackage{collargs}[2024/01/02 v1.1.0 Collect arguments of any command]
+%<latex>\ProvidesPackage{collargs}[2024/03/15 v1.2.0 Collect arguments of any command]
 %<context>%D \module[
 %<context>%D         file=t-collargs.tex,
-%<context>%D      version=1.1.0,
+%<context>%D      version=1.2.0,
 %<context>%D        title=CollArgs,
 %<context>%D     subtitle=Collect arguments of any command,
 %<context>%D       author=Saso Zivanovic,
-%<context>%D         date=2024-01-02,
+%<context>%D         date=2024-03-15,
 %<context>%D    copyright=Saso Zivanovic,
 %<context>%D      license=LPPL,
 %<context>%D ]

diff --git a/doc/CHANGELOG.advice.md b/doc/CHANGELOG.advice.md
@@ -14,6 +14,10 @@ those cases, please see [Memoize's GitHub
 repository](https://github.com/sasozivanovic/memoize) for the recent
 development history.
 
+## 2024/03/15 v1.1.1
+* Bugfix in `\AdviceGetOriginal`.
+* Simplify the definition of the initial outer handler.
+
 ## 2024/01/02 v1.1.0
 * Implement `\AdviceCsnameGetOriginal`.
 * Change `\AdviceGetOriginal` to expand to the internal control sequence

diff --git a/doc/CHANGELOG.collargs.md b/doc/CHANGELOG.collargs.md
@@ -14,6 +14,16 @@ those cases, please see [Memoize's GitHub
 repository](https://github.com/sasozivanovic/memoize) for the recent
 development history.
 
+## 2024/03/15 v1.2.0
+* Argument processors:
+  * They now work without a formal argument, taking token register
+    `\collargsArg` as input. The processors taking a formal argument were
+    impossible (or at least too hard for me) to define.
+	* Remove `append/prepend pre/postwrap`, as they become useless with the above
+    change.
+* Implement keys `clear args` and `return`, and expose `\collargsArgs`.
+* Implement key `alias`.
+
 ## 2024/01/02 v1.1.0
 * Implement `brace collected`.
 

diff --git a/doc/README.advice.md b/doc/README.advice.md
@@ -15,5 +15,5 @@ any later version.  The latest version of this license is in
 https://www.latex-project.org/lppl.txt and version 1.3c or later is part of all
 distributions of LaTeX version 2008 or later.
 
-This work has the LPPL maintenance status `maintained'.  The Current Maintainer
-of this work is Sašo Živanović (saso.zivanovic@guest.arnes.si).
+This work has the LPPL maintenance status `maintained`.  The Current Maintainer
+of this work is Sašo Živanović (`saso.zivanovic@guest.arnes.si`).
diff --git a/doc/README.collargs.md b/doc/README.collargs.md
@@ -15,5 +15,5 @@ any later version.  The latest version of this license is in
 https://www.latex-project.org/lppl.txt and version 1.3c or later is part of all
 distributions of LaTeX version 2008 or later.
 
-This work has the LPPL maintenance status `maintained'.  The Current Maintainer
-of this work is Sašo Živanović (saso.zivanovic@guest.arnes.si).
+This work has the LPPL maintenance status `maintained`.  The Current Maintainer
+of this work is Sašo Živanović (`saso.zivanovic@guest.arnes.si`).
diff --git a/doc/memoize-clean.1.md b/doc/memoize-clean.1.md
@@ -2,8 +2,8 @@
 title: memoize-clean
 section: 1
 header: User Manual
-footer: memoize-clean of Memoize v1.1.2
-date: January 21, 2024
+footer: memoize-clean of Memoize v1.2.0
+date: March 15, 2024
 hyphenate: false
 ---
 

diff --git a/doc/memoize-doc.tex b/doc/memoize-doc.tex
@@ -9182,10 +9182,11 @@ \subsubsection{Beamer}
 \subsubsection{Biblatex}
 
 \begin{doc}{
-    key={name=biblatex, par=\braces{\meta{additional configuration}}, desc=style},
+    key={name=biblatex, par=\marg{additional configuration}, desc=style},
   }
-  This key loads the \pkg{biblatex} support (if package \pkg{biblatex} is
-  loaded, anywhere in the preamble).
+  This key loads the \pkg{biblatex} support, but only if package \pkg{biblatex}
+  is loaded (anywhere in the preamble); after loading the support,
+  \meta{additional configuration} is executed within \refcmd{mmzset}.
 
   When \pkg{biblatex} support is loaded, all citation commands defined by this
   package\footnote{In \pkg{biblatex} version 3.19: \cs{cite}, \cs{Cite},
@@ -9354,6 +9355,18 @@ \section{Varia}
 
 \subsectionclearpagefalse
 
+
+\subsection{Changelog}
+
+The changelogs of Memoize, Advice and CollArgs can be found in the
+documentation directory of the respective package, i.e.\ in
+\code{\meta{texmf}/doc/generic/\meta{package}/CHANGELOG.md}.  They are written
+in the MarkDown format.  Here are direct links to these changelogs on
+CTAN:
+\href{https://mirrors.ctan.org/macros/generic/memoize/CHANGELOG.md}{Memoize},
+\href{https://mirrors.ctan.org/macros/generic/advice/CHANGELOG.md}{Advice},
+\href{https://mirrors.ctan.org/macros/generic/collargs/CHANGELOG.md}{CollArgs}.
+
 \subsection{Known issues}
 \label{sec:known-issues}
 

diff --git a/doc/memoize-extract.1.md b/doc/memoize-extract.1.md
@@ -2,8 +2,8 @@
 title: memoize-extract
 section: 1
 header: User Manual
-footer: memoize-extract of Memoize v1.1.2
-date: January 21, 2024
+footer: memoize-extract of Memoize v1.2.0
+date: March 15, 2024
 hyphenate: false
 ---
 

diff --git a/memoize-clean.pl b/memoize-clean.pl
@@ -19,7 +19,7 @@
 # <texmf>/doc/generic/memoize/FILES.
 
 my $PROG = 'memoize-clean.pl';
-my $VERSION = '2024/01/21 v1.1.2';
+my $VERSION = '2024/03/15 v1.2.0';
 
 use strict;
 use Getopt::Long;

diff --git a/memoize-clean.py b/memoize-clean.py
@@ -18,7 +18,7 @@
 # The files belonging to this work and covered by LPPL are listed in
 # <texmf>/doc/generic/memoize/FILES.
 
-__version__ = '2024/01/21 v1.1.2'
+__version__ = '2024/03/15 v1.2.0'
 
 import argparse, re, sys, pathlib, os
 

diff --git a/memoize-extract.pl b/memoize-extract.pl
@@ -19,7 +19,7 @@
 # <texmf>/doc/generic/memoize/FILES.
 
 my $PROG = 'memoize-extract.pl';
-my $VERSION = '2024/01/21 v1.1.2';
+my $VERSION = '2024/03/15 v1.2.0';
 
 use strict;
 use File::Basename qw/basename/;

diff --git a/memoize-extract.py b/memoize-extract.py
@@ -18,7 +18,7 @@
 # The files belonging to this work and covered by LPPL are listed in
 # <texmf>/doc/generic/memoize/FILES.
 
-__version__ = '2024/01/21 v1.1.2'
+__version__ = '2024/03/15 v1.2.0'
 
 import argparse, re, sys, os, subprocess, itertools, traceback, platform
 from pathlib import Path, PurePath

diff --git a/memoize.edtx b/memoize.edtx
@@ -64,7 +64,7 @@
 % listing options app={basicstyle=\ttfamily\scriptsize}}}
 % 
 % \begin{tcbraster}[raster columns=100]
-%   \tcbinputlisting{raster multicolumn=55, ins listing, top=1mm, bottom=1mm, title=memoize.ins,listing file=../memoize.ins, linerange={27-39}, leftupper=1mm}
+%   \tcbinputlisting{raster multicolumn=55, ins listing, top=1mm, bottom=1mm, title=memoize.ins,listing file=../memoize.ins, linerange={27-40}, leftupper=1mm}
 %   \begin{tcboxedraster}[raster columns=1]{blankest, raster multicolumn=45}
 %     \tcbinputlisting{ins listing, title=advice.ins, listing file=../advice.ins, linerange=28-31}
 %     \tcbinputlisting{ins listing, title=collar\raisebox{0pt}[\height][0pt]{g}s.ins, listing file=../collargs.ins, linerange=29-31}
@@ -90,55 +90,55 @@
 % 
 % \paragraph{Identification} of |memoize|, |memoizable| and |nomemoize|.
 %<*mmz>
-%<latex>\ProvidesPackage{memoize}[2024/01/21 v1.1.2 Fast and flexible externalization]
+%<latex>\ProvidesPackage{memoize}[2024/03/15 v1.2.0 Fast and flexible externalization]
 %<context>%D \module[
 %<context>%D         file=t-memoize.tex,
-%<context>%D      version=1.1.2,
+%<context>%D      version=1.2.0,
 %<context>%D        title=Memoize,
 %<context>%D     subtitle=Fast and flexible externalization,
 %<context>%D       author=Saso Zivanovic,
-%<context>%D         date=2024-01-21,
+%<context>%D         date=2024-03-15,
 %<context>%D    copyright=Saso Zivanovic,
 %<context>%D      license=LPPL,
 %<context>%D ]
 %<context>\writestatus{loading}{ConTeXt User Module / memoize}
 %<context>\unprotect
 %<context>\startmodule[memoize]
-%<plain>% Package memoize 2024/01/21 v1.1.2
+%<plain>% Package memoize 2024/03/15 v1.2.0
 %</mmz>
 %<*mmzable>
-%<latex>\ProvidesPackage{memoizable}[2024/01/21 v1.1.2 A programmer's stub for Memoize]
+%<latex>\ProvidesPackage{memoizable}[2024/03/15 v1.2.0 A programmer's stub for Memoize]
 %<context>%D \module[
 %<context>%D         file=t-memoizable.tex,
-%<context>%D      version=1.1.2,
+%<context>%D      version=1.2.0,
 %<context>%D        title=Memoizable,
 %<context>%D     subtitle=A programmer's stub for Memoize,
 %<context>%D       author=Saso Zivanovic,
-%<context>%D         date=2024-01-21,
+%<context>%D         date=2024-03-15,
 %<context>%D    copyright=Saso Zivanovic,
 %<context>%D      license=LPPL,
 %<context>%D ]
 %<context>\writestatus{loading}{ConTeXt User Module / memoizable}
 %<context>\unprotect
 %<context>\startmodule[memoizable]
-%<plain>% Package memoizable 2024/01/21 v1.1.2
+%<plain>% Package memoizable 2024/03/15 v1.2.0
 %</mmzable>
 %<*nommz>
-%<latex>\ProvidesPackage{nomemoize}[2024/01/21 v1.1.2 A no-op stub for Memoize]
+%<latex>\ProvidesPackage{nomemoize}[2024/03/15 v1.2.0 A no-op stub for Memoize]
 %<context>%D \module[
 %<context>%D         file=t-nomemoize.tex,
-%<context>%D      version=1.1.2,
+%<context>%D      version=1.2.0,
 %<context>%D        title=Memoize,
 %<context>%D     subtitle=A no-op stub for Memoize,
 %<context>%D       author=Saso Zivanovic,
-%<context>%D         date=2024-01-21,
+%<context>%D         date=2024-03-15,
 %<context>%D    copyright=Saso Zivanovic,
 %<context>%D      license=LPPL,
 %<context>%D ]
 %<context>\writestatus{loading}{ConTeXt User Module / nomemoize}
 %<context>\unprotect
 %<context>\startmodule[nomemoize]
-%<mmz>% Package nomemoize 2024/01/21 v1.1.2
+%<mmz>% Package nomemoize 2024/03/15 v1.2.0
 %</nommz>
 % 
 % \paragraph{Required packages} and \hologo{LaTeX}ization of \hologo{plainTeX}