texlive[68648] Master/texmf-dist: advice (25oct23)
commits+karl at tug.org
commits+karl at tug.org
Wed Oct 25 22:00:42 CEST 2023
Revision: 68648
https://tug.org/svn/texlive?view=revision&revision=68648
Author: karl
Date: 2023-10-25 22:00:42 +0200 (Wed, 25 Oct 2023)
Log Message:
-----------
advice (25oct23)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/generic/advice/FILES
trunk/Master/texmf-dist/doc/generic/advice/README.md
trunk/Master/texmf-dist/source/generic/advice/advice.edtx
trunk/Master/texmf-dist/tex/context/third/advice/t-advice.tex
trunk/Master/texmf-dist/tex/generic/advice/advice-tikz.code.tex
trunk/Master/texmf-dist/tex/latex/advice/advice.sty
trunk/Master/texmf-dist/tex/plain/advice/advice.tex
Added Paths:
-----------
trunk/Master/texmf-dist/doc/generic/advice/CHANGELOG.md
Added: trunk/Master/texmf-dist/doc/generic/advice/CHANGELOG.md
===================================================================
--- trunk/Master/texmf-dist/doc/generic/advice/CHANGELOG.md (rev 0)
+++ trunk/Master/texmf-dist/doc/generic/advice/CHANGELOG.md 2023-10-25 20:00:42 UTC (rev 68648)
@@ -0,0 +1,27 @@
+# Advice changelog
+
+This package was developed as an auxiliary package of
+[Memoize](https://ctan.org/pkg/memoize), and is documented alongside that
+package. Note, however, that the Memoize manual, `memoize-doc.pdf`, is not
+reissued for patch-level releases of Advice; the version of the Memoize manual
+fully applicable to the particular version of Advice is indicated at each
+version.
+
+Whenever the date of the Memoize manual is older than the release date of a
+particular version of Advice, the documented source of Advice shown in that
+version of `memoize-code.pdf` of course does not reflect the latest changes; in
+those cases, please see [Memoize's GitHub
+repository](https://github.com/sasozivanovic/memoize) for the recent
+development history.
+
+## 2023/10/25 v1.0.1
+* Require package `xparse`, as `\GetDocumentCommandArgSpec` is being dropped
+ from the LaTeX kernel.
+* Reimplement the tracing typeout routine (don't use `\write16`).
+
+Manual: Memoize 2023/10/10 v1.0.0
+
+## 2023/10/10 v1.0.0
+* The initial release.
+
+Manual: Memoize 2023/10/10 v1.0.0
Property changes on: trunk/Master/texmf-dist/doc/generic/advice/CHANGELOG.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/doc/generic/advice/FILES
===================================================================
--- trunk/Master/texmf-dist/doc/generic/advice/FILES 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/doc/generic/advice/FILES 2023-10-25 20:00:42 UTC (rev 68648)
@@ -1,9 +1,10 @@
doc/generic/advice/LICENCE
doc/generic/advice/INSTALL.md
+doc/generic/advice/CHANGELOG.md
doc/generic/advice/FILES
doc/generic/advice/README.md
tex/latex/advice/advice.sty
-tex/context/advice/t-advice.tex
+tex/context/third/advice/t-advice.tex
tex/plain/advice/advice.tex
tex/generic/advice/advice-tikz.code.tex
source/generic/advice/Makefile
Modified: trunk/Master/texmf-dist/doc/generic/advice/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/generic/advice/README.md 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/doc/generic/advice/README.md 2023-10-25 20:00:42 UTC (rev 68648)
@@ -6,3 +6,14 @@
[Memoize](https://ctan.org/pkg/memoize). This is why it is, somewhat
unconventionally, documented alongside that package. This applies to both the
manual and the documented code listing.
+
+# LICENCE
+
+This work may be distributed and/or modified under the conditions of the LaTeX
+Project Public License, either version 1.3c of this license or (at your option)
+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 at guest.arnes.si).
Modified: trunk/Master/texmf-dist/source/generic/advice/advice.edtx
===================================================================
--- trunk/Master/texmf-dist/source/generic/advice/advice.edtx 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/source/generic/advice/advice.edtx 2023-10-25 20:00:42 UTC (rev 68648)
@@ -19,7 +19,8 @@
%% This work has the LPPL maintenance status `maintained'.
%% The Current Maintainer of this work is Saso Zivanovic.
%%
-%% The files belonging to this work and covered by LPPL are listed in `FILES`.
+%% The files belonging to this work and covered by LPPL are listed in
+%% (<texmf>/doc/generic/advice/)FILES.
%
% \fi
%
@@ -28,14 +29,14 @@
% \relax
%
%<*main>
-%<latex>\ProvidesPackage{advice}[2023/10/10 v1.0.0 Extend commands and environments]
+%<latex>\ProvidesPackage{advice}[2023/10/25 v1.0.1 Extend commands and environments]
%<context>%D \module[
%<context>%D file=t-advice.tex,
-%<context>%D version=1.0.0,
+%<context>%D version=1.0.1,
%<context>%D title=Advice,
%<context>%D subtitle=Extend commands and environments,
%<context>%D author=Saso Zivanovic,
-%<context>%D date=2023-10-10,
+%<context>%D date=2023-10-25,
%<context>%D copyright=Saso Zivanovic,
%<context>%D license=LPPL,
%<context>%D ]
@@ -43,9 +44,14 @@
%<context>\unprotect
%<context>\startmodule[advice]
% \paragraph{Required packages}
+%<plain,context>\input miniltx
%<latex>\RequirePackage{collargs}
%<plain>\input collargs
%<context>\input t-collargs
+% In \hologo{LaTeX}, we also require |xparse|. Even though
+% |\NewDocumentCommand| and friends are integrated into the \hologo{LaTeX}
+% kernel, |\GetDocumentCommandArgSpec| is only available through |xparse|.
+%<latex>\RequirePackage{xparse}
%
% \subsubsection{Installation into a keypath}
%
@@ -959,10 +965,12 @@
}
% \subsubsection{Tracing}
%
+% We implement tracing by adding the tracing information to the handlers after
+% we load them. So it is the handlers themselves which, if and when they are
+% executed, will print out that this is happening.
+%
% \begin{macro}{\AdviceTracingOn,\AdviceTracingOff}
-% We implement tracing by adding the tracing information to the handlers
-% after we load them. So it is the handlers themselves which, if and when
-% they are executed, will print out that this is happening.
+% Enable and disable tracing.
\def\AdviceTracingOn{%
\let\advice at init@i\advice at trace@init at i
\let\advice at init@I\advice at trace@init at I
@@ -972,7 +980,24 @@
\let\advice at init@I\advice at setup@init at I
}
% \end{macro}
-\def\advice at trace#1{\immediate\write16{[tracing advice] #1}}
+% \begin{macro}{\advice at typeout,\advice at trace}
+% The tracing output routine; the typeout macro depends on the format. In
+% \hologo{LaTeX}, we use stream |\@unused|, which is guaranteed to be
+% unopened, so that the output will go to the terminal and the log.
+% \hologo{ConTeXt}, we don't muck about with write streams but simply use Lua
+% function |texio.write_nl|. In \hologo{plainTeX}, we use either Lua or the
+% stream, depending on the engine; we use a high stream number 128 although
+% the good old 16 would probably work just as well.
+%<plain>\ifdefined\luatexversion
+ %<!latex>\long\def\advice at typeout#1{\directlua{texio.write_nl("\luaescapestring{#1}")}}
+%<plain>\else
+ %<latex>\def\advice at typeout{\immediate\write\@unused}
+ %<plain>\def\advice at typeout{\immediate\write128}
+%<plain>\fi
+\def\advice at trace#1{\advice at typeout{[tracing advice] #1}}
+% \end{macro}
+% \begin{macro}{\advice at trace@init at i,\advice at trace@init at I}
+% Install the tracing code.
\def\advice at trace@init at i#1#2{%
\advice at trace{Advising \detokenize\expandafter{\string#2} (\detokenize{#1})}%
\advice at setup@init at i{#1}{#2}%
@@ -1033,6 +1058,7 @@
}%
\def\AdviceInnerHandler{\advice at inner@handler at trace}%
}
+% \end{macro}
%<plain>\resetatcatcode
%<context>\stopmodule
%<context>\protect
Modified: trunk/Master/texmf-dist/tex/context/third/advice/t-advice.tex
===================================================================
--- trunk/Master/texmf-dist/tex/context/third/advice/t-advice.tex 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/tex/context/third/advice/t-advice.tex 2023-10-25 20:00:42 UTC (rev 68648)
@@ -23,7 +23,8 @@
%% This work has the LPPL maintenance status `maintained'.
%% The Current Maintainer of this work is Saso Zivanovic.
%%
-%% The files belonging to this work and covered by LPPL are listed in `FILES`.
+%% The files belonging to this work and covered by LPPL are listed in
+%% (<texmf>/doc/generic/advice/)FILES.
%D \module[
%D file=t-advice.tex,
%D version=1.0.1,
@@ -30,7 +31,7 @@
%D title=Advice,
%D subtitle=Extend commands and environments,
%D author=Saso Zivanovic,
-%D date=2023-09-10,
+%D date=2023-10-24,
%D copyright=Saso Zivanovic,
%D license=LPPL,
%D ]
@@ -37,6 +38,7 @@
\writestatus{loading}{ConTeXt User Module / advice}
\unprotect
\startmodule[advice]
+\input miniltx
\input t-collargs
\pgfkeys{
/handlers/.install advice/.code={%
@@ -410,7 +412,8 @@
\let\advice at init@i\advice at setup@init at i
\let\advice at init@I\advice at setup@init at I
}
-\def\advice at trace#1{\immediate\write16{[tracing advice] #1}}
+ \long\def\advice at typeout#1{\directlua{texio.write_nl("\luaescapestring{#1}")}}
+\def\advice at trace#1{\advice at typeout{[tracing advice] #1}}
\def\advice at trace@init at i#1#2{%
\advice at trace{Advising \detokenize\expandafter{\string#2} (\detokenize{#1})}%
\advice at setup@init at i{#1}{#2}%
Modified: trunk/Master/texmf-dist/tex/generic/advice/advice-tikz.code.tex
===================================================================
--- trunk/Master/texmf-dist/tex/generic/advice/advice-tikz.code.tex 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/tex/generic/advice/advice-tikz.code.tex 2023-10-25 20:00:42 UTC (rev 68648)
@@ -23,7 +23,8 @@
%% This work has the LPPL maintenance status `maintained'.
%% The Current Maintainer of this work is Saso Zivanovic.
%%
-%% The files belonging to this work and covered by LPPL are listed in `FILES`.
+%% The files belonging to this work and covered by LPPL are listed in
+%% (<texmf>/doc/generic/advice/)FILES.
\edef\mmzresetatcatcode{\catcode`\noexpand\@\the\catcode`\@\relax}%
\catcode`\@=11
\def\AdviceCollectTikZArguments{%
Modified: trunk/Master/texmf-dist/tex/latex/advice/advice.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/advice/advice.sty 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/tex/latex/advice/advice.sty 2023-10-25 20:00:42 UTC (rev 68648)
@@ -23,9 +23,11 @@
%% This work has the LPPL maintenance status `maintained'.
%% The Current Maintainer of this work is Saso Zivanovic.
%%
-%% The files belonging to this work and covered by LPPL are listed in `FILES`.
-\ProvidesPackage{advice}[2023/10/10 v1.0.0 Extend commands and environments]
+%% The files belonging to this work and covered by LPPL are listed in
+%% (<texmf>/doc/generic/advice/)FILES.
+\ProvidesPackage{advice}[2023/10/24 v1.0.1 Extend commands and environments]
\RequirePackage{collargs}
+\RequirePackage{xparse}
\pgfkeys{
/handlers/.install advice/.code={%
\edef\auto at install@namespace{\pgfkeyscurrentpath}%
@@ -426,7 +428,8 @@
\let\advice at init@i\advice at setup@init at i
\let\advice at init@I\advice at setup@init at I
}
-\def\advice at trace#1{\immediate\write16{[tracing advice] #1}}
+ \def\advice at typeout{\immediate\write\@unused}
+\def\advice at trace#1{\advice at typeout{[tracing advice] #1}}
\def\advice at trace@init at i#1#2{%
\advice at trace{Advising \detokenize\expandafter{\string#2} (\detokenize{#1})}%
\advice at setup@init at i{#1}{#2}%
Modified: trunk/Master/texmf-dist/tex/plain/advice/advice.tex
===================================================================
--- trunk/Master/texmf-dist/tex/plain/advice/advice.tex 2023-10-25 10:09:47 UTC (rev 68647)
+++ trunk/Master/texmf-dist/tex/plain/advice/advice.tex 2023-10-25 20:00:42 UTC (rev 68648)
@@ -23,7 +23,9 @@
%% This work has the LPPL maintenance status `maintained'.
%% The Current Maintainer of this work is Saso Zivanovic.
%%
-%% The files belonging to this work and covered by LPPL are listed in `FILES`.
+%% The files belonging to this work and covered by LPPL are listed in
+%% (<texmf>/doc/generic/advice/)FILES.
+\input miniltx
\input collargs
\pgfkeys{
/handlers/.install advice/.code={%
@@ -395,7 +397,12 @@
\let\advice at init@i\advice at setup@init at i
\let\advice at init@I\advice at setup@init at I
}
-\def\advice at trace#1{\immediate\write16{[tracing advice] #1}}
+\ifdefined\luatexversion
+ \long\def\advice at typeout#1{\directlua{texio.write_nl("\luaescapestring{#1}")}}
+\else
+ \def\advice at typeout{\immediate\write128}
+\fi
+\def\advice at trace#1{\advice at typeout{[tracing advice] #1}}
\def\advice at trace@init at i#1#2{%
\advice at trace{Advising \detokenize\expandafter{\string#2} (\detokenize{#1})}%
\advice at setup@init at i{#1}{#2}%
More information about the tex-live-commits
mailing list.