summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/pgfkeysearch
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-01-12 03:01:12 +0000
committerNorbert Preining <norbert@preining.info>2024-01-12 03:01:12 +0000
commit1748d1e662c9618cc16f80d5e67669e9e9d6d4be (patch)
tree7d46019dbae3fa8e0345487ecf524cfc641f1b2a /macros/latex/contrib/pgfkeysearch
parentb14090c9f3c7797e26fed9eb2b83ce144dcb16a3 (diff)
CTAN sync 202401120301
Diffstat (limited to 'macros/latex/contrib/pgfkeysearch')
-rw-r--r--macros/latex/contrib/pgfkeysearch/README.md6
-rw-r--r--macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.pdfbin164138 -> 167464 bytes
-rw-r--r--macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.tex15
-rw-r--r--macros/latex/contrib/pgfkeysearch/latex/pgfkeysearch.sty28
4 files changed, 26 insertions, 23 deletions
diff --git a/macros/latex/contrib/pgfkeysearch/README.md b/macros/latex/contrib/pgfkeysearch/README.md
index 71ff4b251d..4e5a4d42f3 100644
--- a/macros/latex/contrib/pgfkeysearch/README.md
+++ b/macros/latex/contrib/pgfkeysearch/README.md
@@ -52,7 +52,11 @@ The Current Maintainer of this work is Alceu Frigeri
## Changelog
-* Version 1.1 (this)
+* Version 1.2 (this)
+ - More typos.
+ - added two command aliases, see documentation.
+
+* Version 1.1
- More typos.
- renamed some internal variables to better follow the expl3 recommendations.
- exposing the Expl3 commands.
diff --git a/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.pdf b/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.pdf
index 70d2abe150..2aa19408a7 100644
--- a/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.pdf
+++ b/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.pdf
Binary files differ
diff --git a/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.tex b/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.tex
index 8e29e2a3ab..2cad988fe9 100644
--- a/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.tex
+++ b/macros/latex/contrib/pgfkeysearch/doc/pgfkeysearch.tex
@@ -12,7 +12,7 @@
%%
%% The Current Maintainer of this work is Alceu Frigeri
%%
-%% This is version {1.5} {2023/12/29}
+%% This is version {1.2} {2024/01/11}
%%
%% The list of files that compose this work can be found in the README.md file at
%% https://ctan.org/pkg/pgfkeysearch
@@ -32,7 +32,7 @@
\tstitle{
author={Alceu Frigeri\footnote{\tsverb{https://github.com/alceu-frigeri/pgfkeysearch}}},
date={\tsdate},
- title={A Search Extension for pgfkeys\break Version \PkgInfo{pgfkeysearch}{version}}
+ title={The pgfkeysearch Package\break A Search Extension for pgfkeys\break Version \PkgInfo{pgfkeysearch}{version}}
}
\begin{typesetabstract}
@@ -43,10 +43,12 @@ That's exactly the aim of this, by having a way to find a key in a given path (o
\section{Searching for a key}
-\begin{codedescribe}{\pgfkeysearchvalueof,\pgfkeysearchvalueofTF}
+\begin{codedescribe}[code,update=2024/01/11]{\pgfkeysearchvalueof,\pgfkeysearch,\pgfkeysearchvalueofTF,\pgfkeysearchTF}
\begin{codesyntax}%
\tsmacro{\pgfkeysearchvalueof}{path-list,key,macro}
+\tsmacro{\pgfkeysearch}{path-list,key,macro}
\tsmacro{\pgfkeysearchvalueofTF}{path-list,key,macro,if-found,if-not}
+\tsmacro{\pgfkeysearchTF}{path-list,key,macro,if-found,if-not}
\end{codesyntax}
\tsobj[marg]{path-list} is a comma separated list (clist) of paths (can be a single one). \tsobj[marg]{key} is the desired key and \tsobj[marg]{macro} is the macro/command that will receive (store) the key value (if one was found).
@@ -56,7 +58,10 @@ The branch version will also execute either \tsobj[marg,sep={or}]{if-found,if-no
\end{codedescribe}
\begin{tsremark}
- Those commands aren't expandable, that's the reason to have them storing the key value in a macro and not just 'placing the value in the input stream'.
+ \tsobj{\pgfkeysearch,\pgfkeysearchvalueof} are aliases to each other. Same with \tsobj{\pgfkeysearchvalueofTF,\pgfkeysearchTF}.
+\end{tsremark}
+\begin{tsremark}
+ These commands aren't expandable, that's the reason to have them storing the key value in a macro and not just placing the found value in the input stream.
\end{tsremark}
\begin{codestore}[keyval.demo]
@@ -86,6 +91,6 @@ The branch version will also execute either \tsobj[marg,sep={or}]{if-found,if-no
\tsmacro{\pgfkeysearch_multipath_keysearch:nnnTF}{path-list,key,macro,if-found,if-not}
\tsmacro{\pgfkeysearch_keysearch:nnnTF}{single-path,key,macro,if-found,if-not}
\end{codesyntax}
-These are the \tsobj[pkg]{Expl3} version of it (for package writers). In fact, the \tsobj{\pgfkeysearchvalueof} is just a wrapper to \tsobj{\pgfkeysearch_multipath_keysearch:nnnTF}. The \tsobj{\pgfkeysearch_keysearch:nnnTF} is the single path version.
+These are the \tsobj[pkg]{Expl3} version of it, for package writers. In fact, \tsobj{\pgfkeysearchvalueof,\pgfkeysearch,\pgfkeysearchvalueofTF,\pgfkeysearchTF} are just wrappers to \tsobj{\pgfkeysearch_multipath_keysearch:nnnTF}. The \tsobj{\pgfkeysearch_keysearch:nnnTF} is the single path version and it's slightly faster than the more generic multi-path version (for a single path search, of course), given that \tsobj{\pgfkeysearch_multipath_keysearch:nnnTF} calls \tsobj{\pgfkeysearch_keysearch:nnnTF} for each path in \tsobj[marg]{path-list}.
\end{codedescribe}
\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/pgfkeysearch/latex/pgfkeysearch.sty b/macros/latex/contrib/pgfkeysearch/latex/pgfkeysearch.sty
index 1b2144cfe1..598237a6ab 100644
--- a/macros/latex/contrib/pgfkeysearch/latex/pgfkeysearch.sty
+++ b/macros/latex/contrib/pgfkeysearch/latex/pgfkeysearch.sty
@@ -12,7 +12,7 @@
%%
%% The Current Maintainer of this work is Alceu Frigeri
%%
-%% This is version {1.1} {2023/12/29}
+%% This is version {1.2} {2024/01/11}
%%
%% The list of files that compose this work can be found in the README.md file at
%% https://ctan.org/pkg/pgfkeysearch
@@ -23,8 +23,8 @@
\ProvidesExplPackage
{pgfkeysearch}
- {2023/12/29}
- {1.1}
+ {2024/01/11}
+ {1.2}
{pgfkeys Search Extension}
\ExplSyntaxOn
@@ -38,23 +38,15 @@
{
name .code:n = {pgfkeysearch} ,
prefix .code:n = {pgfkeysearch} ,
- date .code:n = {2023/12/29},
- version .code:n = {1.1} ,
- description .code:n = {pgfkeys Search Extension}
+ date .code:n = {2024/01/11},
+ version .code:n = {1.2} ,
+ description .code:n = {pgfkeys~ search~ extension}
}
-\cs_if_exist:NF \__codedesc_pkg_info:nn
+\cs_if_exist:NF \PkgInfo
{
- \cs_new_protected:Npn \__codedesc_pkg_info:nn #1#2
- { \keys_set:nn {#1 / pkg info}{#2} }
- }
-\cs_if_exist:NF \PkgInfo
- { \NewDocumentCommand \PkgInfo {mm} { \keys_set:nn {#1 / pkg info}{#2} } }
-\cs_if_exist:NF \PkgDescription
- {
+ \NewDocumentCommand \PkgInfo {mm} { \keys_set:nn {#1 / pkg info}{#2} }
\NewDocumentCommand \PkgDescription {m}
- {
- \noindent Package~ \textbf{\PkgInfo{#1}{name}}~Version:~\PkgInfo{#1}{version}~ -~ \PkgInfo{#1}{date}\par \emph{\PkgInfo{#1}{description}}~\par
- }
+ { \noindent Package~ \textbf{\PkgInfo{#1}{name}}~Version:~\PkgInfo{#1}{version}~ -~ \PkgInfo{#1}{date}\par \emph{\PkgInfo{#1}{description}}~\par }
}
%%%%%%%
%%% End of cut-n-paste
@@ -154,6 +146,7 @@
\pgfkeysearch_multipath_keysearch:nnnF {#1}{#2}{#3}
{ \tl_set:Nn #3 {} }
}
+\let\pgfkeysearch\pgfkeysearchvalueof
\NewDocumentCommand{\pgfkeysearchvalueofTF}{mmmmm}
{
@@ -164,3 +157,4 @@
#5
}
}
+\let\pgfkeysearchTF\pgfkeysearchvalueofTF