8 files changed, 490 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md b/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md
new file mode 100644
index 00000000000..7702b1e8151
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+## [Unreleased]
+
+## [v0.1.0-alpha](https://github.com/gusbrs/zref-vario/releases/tag/v0.1.0-alpha) (2022-01-31)
+
+### Added
+- Initial release.
diff --git a/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt b/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt
new file mode 100644
index 00000000000..b593a243a79
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt
@@ -0,0 +1,2 @@
+hard zref-clever
+hard varioref
diff --git a/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md b/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md
new file mode 100644
index 00000000000..050277efd7b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md
@@ -0,0 +1,148 @@
+# Manifest for zref-vario
+
+This file is a listing of all files considered to be part of this package.
+It is automatically generated with `l3build manifest`.
+
+
+## Repository manifest
+
+The following groups list the files included in the development repository of the package.
+Files listed with a ‘†’ marker are included in the TDS but not CTAN files, and files listed
+with ‘‡’ are included in both.
+
+### Source files
+
+These are source files for a number of purposes, including the `unpack` process which
+generates the installation files of the package. Additional files included here will also
+be installed for processing such as testing.
+
+* zref-vario.dtx ‡
+* zref-vario.ins ‡
+
+### Typeset documentation source files
+
+These files are typeset using LaTeX to produce the PDF documentation for the package.
+
+* zref-vario-code.tex ‡
+* zref-vario.tex ‡
+
+### Text files
+
+Plain text files included as documentation or metadata.
+
+* CHANGELOG.md ‡
+* MANIFEST.md ‡
+* README.md ‡
+* readme-ctan.md 
+* DEPENDS.txt ‡
+
+### Derived files
+
+The files created by ‘unpacking’ the package sources. This typically includes
+`.sty` and `.cls` files created from DocStrip `.dtx` files.
+
+* zref-vario.sty †
+
+### Typeset documents
+
+The output files (PDF, essentially) from typesetting the various source, demo,
+etc., package files.
+
+* zref-vario-code.pdf ‡
+* zref-vario.pdf ‡
+
+### Test files
+
+These files form the test suite for the package. `.lvt` or `.lte` files are the individual
+unit tests, and `.tlg` are the stored output for ensuring changes to the package produce
+the same output. These output files are sometimes shared and sometime specific for
+different engines (pdfTeX, XeTeX, LuaTeX, etc.).
+
+* zv-basic01.lvt 
+* zv-basic02.lvt 
+* zv-basic03.lvt 
+* zv-basic04.lvt 
+* zv-hyperref01.lvt 
+* zv-languages01.lvt 
+* zv-zcref-options01.lvt 
+* zv-basic01.luatex.tlg 
+* zv-basic01.luatexdev.tlg 
+* zv-basic01.tlg 
+* zv-basic01.xetex.tlg 
+* zv-basic01.xetexdev.tlg 
+* zv-basic02.luatex.tlg 
+* zv-basic02.luatexdev.tlg 
+* zv-basic02.tlg 
+* zv-basic02.xetex.tlg 
+* zv-basic02.xetexdev.tlg 
+* zv-basic03.luatex.tlg 
+* zv-basic03.luatexdev.tlg 
+* zv-basic03.tlg 
+* zv-basic03.xetex.tlg 
+* zv-basic03.xetexdev.tlg 
+* zv-basic04.luatex.tlg 
+* zv-basic04.luatexdev.tlg 
+* zv-basic04.tlg 
+* zv-basic04.xetex.tlg 
+* zv-basic04.xetexdev.tlg 
+* zv-hyperref01.luatex.tlg 
+* zv-hyperref01.luatexdev.tlg 
+* zv-hyperref01.tlg 
+* zv-hyperref01.xetex.tlg 
+* zv-hyperref01.xetexdev.tlg 
+* zv-languages01.tlg 
+* zv-zcref-options01.luatex.tlg 
+* zv-zcref-options01.luatexdev.tlg 
+* zv-zcref-options01.tlg 
+* zv-zcref-options01.xetex.tlg 
+* zv-zcref-options01.xetexdev.tlg 
+
+
+## TDS manifest
+
+The following groups list the files included in the TeX Directory Structure used to install
+the package into a TeX distribution.
+
+### Source files (TDS)
+
+All files included in the `zref-vario/source` directory.
+
+* zref-vario.dtx 
+* zref-vario.ins 
+
+### TeX files (TDS)
+
+All files included in the `zref-vario/tex` directory.
+
+* zref-vario.sty 
+
+### Doc files (TDS)
+
+All files included in the `zref-vario/doc` directory.
+
+* CHANGELOG.md 
+* DEPENDS.txt 
+* MANIFEST.md 
+* README.md 
+* zref-vario-code.pdf 
+* zref-vario-code.tex 
+* zref-vario.pdf 
+* zref-vario.tex 
+
+
+## CTAN manifest
+
+The following group lists the files included in the CTAN package.
+
+### CTAN files
+
+* CHANGELOG.md 
+* DEPENDS.txt 
+* MANIFEST.md 
+* README.md 
+* zref-vario-code.pdf 
+* zref-vario-code.tex 
+* zref-vario.dtx 
+* zref-vario.ins 
+* zref-vario.pdf 
+* zref-vario.tex 
diff --git a/Master/texmf-dist/doc/latex/zref-vario/README.md b/Master/texmf-dist/doc/latex/zref-vario/README.md
new file mode 100644
index 00000000000..a76d0b945c3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/README.md
@@ -0,0 +1,19 @@
+# zref-vario
+
+**Extended LaTeX page cross-references with varioref and zref-clever**
+
+Author: Gustavo Barros
+Maintainer: Gustavo Barros
+
+`zref-vario` offers a compatibility layer for `varioref` to be used alongside
+`zref-clever`.  It provides "`\z...`" counterparts to `varioref`'s main
+reference commands, each of which essentially does some (scoped) setup for
+`varioref`, then calls the original one.
+
+License: LPPL Version 1.3c
+
+Repository: https://github.com/gusbrs/zref-vario
+
+Bug tracker: https://github.com/gusbrs/zref-vario/issues
+
+CTAN: https://ctan.org/pkg/zref-vario
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf
new file mode 100644
index 00000000000..00e63f3389d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex
new file mode 100644
index 00000000000..949376f1972
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex
@@ -0,0 +1,52 @@
+% \iffalse meta-comment
+%
+% File: zref-vario-code.tex
+%
+% This file is part of the LaTeX package "zref-vario".
+%
+% Copyright (C) 2022  Gustavo Barros
+%
+% It may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License (LPPL), either version 1.3c of this
+% license or (at your option) any later version.  The latest version
+% of this license is in the file:
+%
+%    https://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+%
+% This work is "maintained" (as per LPPL maintenance status) by
+% Gustavo Barros.
+%
+% This work consists of the files zref-vario.dtx,
+%                                 zref-vario.ins,
+%                                 zref-vario.tex,
+%                                 zref-vario-code.tex,
+%         and the files listed in MANIFEST.md.
+%
+% The released version of this package is available from CTAN.
+%
+% -----------------------------------------------------------------------
+%
+% The development version of the package can be found at
+%
+%    https://github.com/gusbrs/zref-vario
+%
+% for those people who are interested.
+%
+% -----------------------------------------------------------------------
+%
+% \fi
+
+\documentclass{l3doc}
+
+% Have \GetFileInfo pick up date and version data.
+\usepackage{zref-vario}
+
+\begin{document}
+
+\DocInput{zref-vario.dtx}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf
new file mode 100644
index 00000000000..8ff1c89bca0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex
new file mode 100644
index 00000000000..522e46a2076
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex
@@ -0,0 +1,261 @@
+% \iffalse meta-comment
+%
+% File: zref-vario.tex
+%
+% This file is part of the LaTeX package "zref-vario".
+%
+% Copyright (C) 2022  Gustavo Barros
+%
+% It may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License (LPPL), either version 1.3c of this
+% license or (at your option) any later version.  The latest version
+% of this license is in the file:
+%
+%    https://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+%
+% This work is "maintained" (as per LPPL maintenance status) by
+% Gustavo Barros.
+%
+% This work consists of the files zref-vario.dtx,
+%                                 zref-vario.ins,
+%                                 zref-vario.tex,
+%                                 zref-vario-code.tex,
+%         and the files listed in MANIFEST.md.
+%
+% The released version of this package is available from CTAN.
+%
+% -----------------------------------------------------------------------
+%
+% The development version of the package can be found at
+%
+%    https://github.com/gusbrs/zref-vario
+%
+% for those people who are interested.
+%
+% -----------------------------------------------------------------------
+%
+% \fi
+
+\documentclass{l3doc}
+
+% The package itself *must* be loaded so that \GetFileInfo can pick up date
+% and version data.
+\usepackage{zref-vario}
+
+\usepackage[T1]{fontenc}
+
+\usepackage[sc]{mathpazo}
+\linespread{1.05}
+\usepackage[scale=.88]{tgheros} % sans
+\usepackage[varqu,scaled=1.03]{inconsolata} % tt
+
+\usepackage{listings}
+
+\usepackage{microtype}
+
+\hypersetup{hidelinks}
+
+\NewDocumentCommand\opt{m}{\texttt{#1}}
+
+\lstdefinestyle{code}{
+  language=[LaTeX]TeX,
+  % moretexcs={
+  % }
+}
+\lstdefinestyle{zrefvario}{
+  style=code,
+  % moretexcs={
+  % }
+}
+\lstset{
+  style=zrefvario,
+  basicstyle=\ttfamily\small,
+  columns=fullflexible,
+  keepspaces,
+  xleftmargin=\leftmargin,
+  xrightmargin=.5\leftmargin,
+}
+\lstnewenvironment{zvexample}[1][]{%
+  \renewcommand{\lstlistingname}{Example}%
+  \lstset{#1}%
+}{}
+
+\begin{document}
+
+\GetFileInfo{zref-vario.sty}
+
+\title{%
+  The \pkg{zref-vario} package%
+  \thanks{This file describes \fileversion, released \filedate.}%
+  \texorpdfstring{\\{}\medskip{}}{ - }%
+  User manual%
+  \texorpdfstring{\medskip{}}{}%
+}
+
+\author{%
+  Gustavo Barros%
+  \thanks{\url{https://github.com/gusbrs/zref-vario}}%
+}
+
+\date{\filedate}
+
+\maketitle
+
+\begin{center}
+  {\bfseries \abstractname\vspace{-.5em}\vspace{0pt}}
+\end{center}
+
+\begin{quotation}
+  \pkg{zref-vario} offers a compatibility layer for \pkg{varioref} to be used
+  alongside \pkg{zref-clever}.  It provides ``\texttt{\cs{z}}\dots{}''
+  counterparts to \pkg{varioref}'s main reference commands, each of which
+  essentially does some (scoped) setup for \pkg{varioref}, then calls the
+  original one.
+\end{quotation}
+
+\bigskip{}
+
+\begin{center}
+  \textbf{EXPERIMENTAL}
+\end{center}
+
+\tableofcontents
+
+\clearpage{}
+
+\section{Loading the package}
+
+As usual:
+
+\begin{zvexample}
+\usepackage{zref-vario}
+\end{zvexample}
+
+
+\section{Dependencies}
+
+\pkg{zref-vario} requires \pkg{varioref} and \pkg{zref-clever}.
+
+
+\section{User interface}
+
+\begin{function}{\zvref}
+  \begin{syntax}
+    \cs{zvref}\meta{*}\oarg{options}\marg{label}
+  \end{syntax}
+\end{function}
+
+\begin{function}{\zvpageref}
+  \begin{syntax}
+    \cs{zvpageref}\meta{*}\oarg{options}\marg{label}
+  \end{syntax}
+\end{function}
+
+\begin{function}{\zvrefrange}
+  \begin{syntax}
+    \cs{zvrefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
+  \end{syntax}
+\end{function}
+
+\begin{function}{\zvpagerefrange}
+  \begin{syntax}
+    \cs{zvpagerefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
+  \end{syntax}
+\end{function}
+
+\begin{function}{\zfullref}
+  \begin{syntax}
+    \cs{zfullref}\meta{*}\oarg{options}\marg{label}
+  \end{syntax}
+\end{function}
+
+These user commands work pretty much as their \pkg{varioref}
+counterparts.\footnote{If you are not acquainted with them, see
+  \pkg{varioref}'s documentation.}  Indeed, they are just wrappers around
+them.  As such, differently from \pkg{zref-clever}'s commands, these can
+receive single labels as arguments, not lists of them.  In all of them the
+starred version inhibits hyperlinking, and they (locally) set \pkg{varioref}'s
+\opt{nospace} option, so that the this syntax can be used unambiguously.
+
+All of them have a single optional argument, which can receive any of
+\cs{zcref}'s options, and those are set for calls to \cs{zcref} or
+\cs{zpageref} which are part of the building blocks of the reference formats
+and strings set for \pkg{varioref}.  However, there is indeed some potential
+friction and caveats stemming from the use of these options, which were
+designed to work for single calls of \cs{zcref}, to apply to \emph{pairs} of
+them.  Hence, whether each and every of these options is meaningful, useful,
+or potentially harmful in this context depends on the case, and it is up to
+the user to make proper use of them.  Of course, one can always split the pair
+using \cs{zcref} and then \cs{zvpageref}, \cs{zvpagerefrange}, or
+\cs{zcpageref}, and have more control over each part.  Anyway, the package
+does what it says: passes the options along to the underlying call(s) to
+\cs{zcref}.\footnote{Note that the options given to each call of these user
+  macros are set \emph{before} the call to the original \pkg{varioref}
+  counterpart.  This means that options given to \cs{zcref} or \cs{zpageref}
+  in the strings and formats in \cs{zvLanguageSetup} will have precedence over
+  the former.  Which is useful, so that we can distinguish to some degree the
+  first from the second call of \cs{zcref}/\cs{zpageref} done in the formats,
+  but does not eliminate the limitations which arise from the underlying
+  problem.}
+
+Besides these options, two other are provided corresponding to
+\pkg{varioref}'s commands' optional arguments: \opt{vcurrent} (the first
+optional argument) and \opt{vother} (the second optional argument).  Of
+course, these are only available when the underlying \pkg{varioref} command
+supports them.
+
+\section{Customization}
+
+
+\begin{function}{\zvLanguageSetup}
+  \begin{syntax}
+    \cs{zvLanguageSetup}\marg{language}\marg{options}
+  \end{syntax}
+\end{function}
+
+User interface for customization of ``strings'' and ``formats'' for
+\meta{language}.  \meta{language} must be known to \pkg{zref-clever}.  The
+\meta{options} are familiar to users of \pkg{varioref}:
+\opt{reftextfaceafter}, \opt{reftextfacebefore}, \opt{reftextafter},
+\opt{reftextbefore}, \opt{reftextcurrent}, \opt{reftextfaraway},
+\opt{reftextpagerange}, \opt{reftextlabelrange}, \opt{vrefformat},
+\opt{vrefrangeformat}, and \opt{fullrefformat}.\footnote{For details, see
+  \pkg{varioref}'s documentation.}  Their meaning is the same as the ones they
+have in \pkg{varioref} and, indeed, they work by setting those \pkg{varioref}
+macros to the values given to the corresponding options in
+\cs{zvLanguageSetup}.  If you are setting up a language which has no built-in
+support, you should set at least the whole set of ``\texttt{reftext}\dots{}''
+options.  Language independent default values are provided for the
+``\dots{}\texttt{format}'' options (equivalent to the ones from
+\pkg{varioref}, which are adequate to most use cases), so you may omit them.
+But, if you need to adjust them, the default values can be overridden by
+setting the corresponding options in \cs{zvLanguageSetup}.
+
+
+% \section{Acknowledgments}
+%
+% A number of people have contributed to \pkg{zref-vario}.  Suggestions,
+% ideas, solutions to problems, bug reports or even encouragement were
+% generously provided by (in chronological order):
+%
+% The package's language settings have been provided or improved thanks to:
+%
+% If I have inadvertently left anyone off the list I apologize, and please let
+% me know, so that I can correct the oversight.
+%
+% Thank you all very much!
+
+
+\section{Change history}
+
+A change log with relevant changes for each version, eventual upgrade
+instructions, and upcoming changes, is maintained in the package's repository,
+at \url{https://github.com/gusbrs/zref-vario/blob/main/CHANGELOG.md}.  An
+archive of historical versions of the package is also kept at
+\url{https://github.com/gusbrs/zref-vario/releases}.
+
+\end{document}