diff options
author | Karl Berry <karl@freefriends.org> | 2022-04-23 21:11:35 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-04-23 21:11:35 +0000 |
commit | 5d66b745f10a2f0bfd2c977c8996474805dbc3b2 (patch) | |
tree | 4f5960dd7aeaa7437ad1a6727273c6cee87fe08c /Master/texmf-dist/doc | |
parent | d6e9bde6a8ffa27e45e35126f586e4e5415242b6 (diff) |
zref-clever (23apr22)
git-svn-id: svn://tug.org/texlive/trunk@63114 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/CHANGELOG.md | 23 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/MANIFEST.md | 522 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.pdf | bin | 1255128 -> 1255628 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.tex | 7 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/zref-clever.pdf | bin | 312995 -> 311667 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/zref-clever/zref-clever.tex | 95 |
6 files changed, 69 insertions, 578 deletions
diff --git a/Master/texmf-dist/doc/latex/zref-clever/CHANGELOG.md b/Master/texmf-dist/doc/latex/zref-clever/CHANGELOG.md index 5023b04b7ae..2a3f9bdbc4a 100644 --- a/Master/texmf-dist/doc/latex/zref-clever/CHANGELOG.md +++ b/Master/texmf-dist/doc/latex/zref-clever/CHANGELOG.md @@ -1,6 +1,27 @@ # Changelog -## [Unreleased](https://github.com/gusbrs/zref-clever/compare/v0.2.2-alpha...HEAD) +## [Unreleased](https://github.com/gusbrs/zref-clever/compare/v0.3.0...HEAD) + +## [v0.3.0](https://github.com/gusbrs/zref-clever/compare/v0.2.2-alpha...v0.3.0) (2022-04-22) + +### Changed +- `zref-clever` no longer accepts package options to be set a load-time, + `\zcsetup` must be used instead. The use of load-time options now results + in "Unknown option" LaTeX error. This change requires that users adjust + their documents, and a suitable package warning has been provided so that + affected users know of the change directly and how to adjust. +- Option `check` has been made no-op in the preamble. To load the + corresponding package, just use the standard `\usepackage`. +- (Internal) Use public hyperref's commands for building links instead of the + internal `\hyper@@link`. + +### Deprecated +- Options `titleref` and `vario` have been deprecated. To load the + corresponding packages, just use the standard `\usepackage`. + +### Fixed +- Bug which affected the typesetting with compression in case two ranges for + the same reference type occurred. ## [v0.2.2-alpha](https://github.com/gusbrs/zref-clever/compare/v0.2.1-alpha...v0.2.2-alpha) (2022-02-11) diff --git a/Master/texmf-dist/doc/latex/zref-clever/MANIFEST.md b/Master/texmf-dist/doc/latex/zref-clever/MANIFEST.md deleted file mode 100644 index 50b246d870a..00000000000 --- a/Master/texmf-dist/doc/latex/zref-clever/MANIFEST.md +++ /dev/null @@ -1,522 +0,0 @@ -# Manifest for zref-clever - -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-clever.dtx ‡ -* zref-clever.ins ‡ - -### Typeset documentation source files - -These files are typeset using LaTeX to produce the PDF documentation for the package. - -* zref-clever-code.tex ‡ -* zref-clever.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-clever.sty † -* zref-clever-dutch.lang † -* zref-clever-english.lang † -* zref-clever-french.lang † -* zref-clever-german.lang † -* zref-clever-portuguese.lang † -* zref-clever-spanish.lang † - -### Typeset documents - -The output files (PDF, essentially) from typesetting the various source, demo, -etc., package files. - -* zref-clever-code.pdf ‡ -* zref-clever.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.). - -* zc-LanguageSetup01.lvt -* zc-LanguageSetup02.lvt -* zc-LanguageSetup03.lvt -* zc-RefTypeSetup01.lvt -* zc-RefTypeSetup02.lvt -* zc-RefTypeSetup03.lvt -* zc-class-article01.lvt -* zc-class-book01.lvt -* zc-class-memoir01.lvt -* zc-class-report01.lvt -* zc-class-scrartcl01.lvt -* zc-class-scrbook01.lvt -* zc-class-scrreprt01.lvt -* zc-compat-amsmath01.lvt -* zc-compat-appendices01.lvt -* zc-compat-appendix01.lvt -* zc-compat-breqn01.lvt -* zc-compat-enumitem01.lvt -* zc-compat-koma-script01.lvt -* zc-compat-listings01.lvt -* zc-compat-memoir01.lvt -* zc-compat-subcaption01.lvt -* zc-compat-subfig01.lvt -* zc-fallback01.lvt -* zc-howto-amsmath01.lvt -* zc-howto-enumitem01.lvt -* zc-howto-listings01.lvt -* zc-howto-newfloat01.lvt -* zc-howto-newfloat02.lvt -* zc-howto-newfloat03.lvt -* zc-howto-newfloat04.lvt -* zc-howto-newfloat05.lvt -* zc-howto-newtheorem01.lvt -* zc-howto-newtheorem02.lvt -* zc-howto-newtheorem03.lvt -* zc-howto-newtheorem04.lvt -* zc-howto-zref-vario01.lvt -* zc-howto-zref-xr01.lvt -* zc-label-options01.lvt -* zc-langfile-dutch01.lvt -* zc-langfile-english01.lvt -* zc-langfile-french01.lvt -* zc-langfile-german01.lvt -* zc-langfile-portuguese01.lvt -* zc-langfile-spanish01.lvt -* zc-languages01.lvt -* zc-opt-check01.lvt -* zc-opt-d01.lvt -* zc-opt-g01.lvt -* zc-opt-hyperref01.lvt -* zc-opt-hyperref02.lvt -* zc-opt-hyperref03.lvt -* zc-opt-hyperref04.lvt -* zc-opt-hyperref05.lvt -* zc-opt-lang01.lvt -* zc-opt-lang02.lvt -* zc-opt-lang03.lvt -* zc-opt-lang04.lvt -* zc-opt-lang05.lvt -* zc-opt-lang06.lvt -* zc-opt-nocompat01.lvt -* zc-opt-nocompat02.lvt -* zc-opt-nocompat03.lvt -* zc-opt-ref01.lvt -* zc-opt-ref02.lvt -* zc-opt-titleref01.lvt -* zc-opt-vario01.lvt -* zc-precedence-rules01.lvt -* zc-sort01.lvt -* zc-typeset01.lvt -* zc-workaround-breqn01.lvt -* zc-zcref-options01.lvt -* zc-zcref-options02.lvt -* zc-zcref-options03.lvt -* zc-LanguageSetup01.luatex.tlg -* zc-LanguageSetup01.luatexdev.tlg -* zc-LanguageSetup01.tlg -* zc-LanguageSetup01.xetex.tlg -* zc-LanguageSetup01.xetexdev.tlg -* zc-LanguageSetup02.luatex.tlg -* zc-LanguageSetup02.luatexdev.tlg -* zc-LanguageSetup02.tlg -* zc-LanguageSetup02.xetex.tlg -* zc-LanguageSetup02.xetexdev.tlg -* zc-LanguageSetup03.luatex.tlg -* zc-LanguageSetup03.luatexdev.tlg -* zc-LanguageSetup03.tlg -* zc-LanguageSetup03.xetex.tlg -* zc-LanguageSetup03.xetexdev.tlg -* zc-RefTypeSetup01.luatex.tlg -* zc-RefTypeSetup01.luatexdev.tlg -* zc-RefTypeSetup01.tlg -* zc-RefTypeSetup01.xetex.tlg -* zc-RefTypeSetup01.xetexdev.tlg -* zc-RefTypeSetup02.luatex.tlg -* zc-RefTypeSetup02.luatexdev.tlg -* zc-RefTypeSetup02.tlg -* zc-RefTypeSetup02.xetex.tlg -* zc-RefTypeSetup02.xetexdev.tlg -* zc-RefTypeSetup03.luatex.tlg -* zc-RefTypeSetup03.luatexdev.tlg -* zc-RefTypeSetup03.tlg -* zc-RefTypeSetup03.xetex.tlg -* zc-RefTypeSetup03.xetexdev.tlg -* zc-class-article01.luatex.tlg -* zc-class-article01.luatexdev.tlg -* zc-class-article01.tlg -* zc-class-article01.xetex.tlg -* zc-class-article01.xetexdev.tlg -* zc-class-book01.luatex.tlg -* zc-class-book01.luatexdev.tlg -* zc-class-book01.tlg -* zc-class-book01.xetex.tlg -* zc-class-book01.xetexdev.tlg -* zc-class-memoir01.luatex.tlg -* zc-class-memoir01.luatexdev.tlg -* zc-class-memoir01.tlg -* zc-class-memoir01.xetex.tlg -* zc-class-memoir01.xetexdev.tlg -* zc-class-report01.luatex.tlg -* zc-class-report01.luatexdev.tlg -* zc-class-report01.tlg -* zc-class-report01.xetex.tlg -* zc-class-report01.xetexdev.tlg -* zc-class-scrartcl01.luatex.tlg -* zc-class-scrartcl01.luatexdev.tlg -* zc-class-scrartcl01.tlg -* zc-class-scrartcl01.xetex.tlg -* zc-class-scrartcl01.xetexdev.tlg -* zc-class-scrbook01.luatex.tlg -* zc-class-scrbook01.luatexdev.tlg -* zc-class-scrbook01.tlg -* zc-class-scrbook01.xetex.tlg -* zc-class-scrbook01.xetexdev.tlg -* zc-class-scrreprt01.luatex.tlg -* zc-class-scrreprt01.luatexdev.tlg -* zc-class-scrreprt01.tlg -* zc-class-scrreprt01.xetex.tlg -* zc-class-scrreprt01.xetexdev.tlg -* zc-compat-amsmath01.luatex.tlg -* zc-compat-amsmath01.luatexdev.tlg -* zc-compat-amsmath01.tlg -* zc-compat-amsmath01.xetex.tlg -* zc-compat-amsmath01.xetexdev.tlg -* zc-compat-appendices01.luatex.tlg -* zc-compat-appendices01.luatexdev.tlg -* zc-compat-appendices01.tlg -* zc-compat-appendices01.xetex.tlg -* zc-compat-appendices01.xetexdev.tlg -* zc-compat-appendix01.luatex.tlg -* zc-compat-appendix01.luatexdev.tlg -* zc-compat-appendix01.tlg -* zc-compat-appendix01.xetex.tlg -* zc-compat-appendix01.xetexdev.tlg -* zc-compat-breqn01.luatex.tlg -* zc-compat-breqn01.luatexdev.tlg -* zc-compat-breqn01.tlg -* zc-compat-breqn01.xetex.tlg -* zc-compat-breqn01.xetexdev.tlg -* zc-compat-enumitem01.luatex.tlg -* zc-compat-enumitem01.luatexdev.tlg -* zc-compat-enumitem01.tlg -* zc-compat-enumitem01.xetex.tlg -* zc-compat-enumitem01.xetexdev.tlg -* zc-compat-koma-script01.luatex.tlg -* zc-compat-koma-script01.luatexdev.tlg -* zc-compat-koma-script01.tlg -* zc-compat-koma-script01.xetex.tlg -* zc-compat-koma-script01.xetexdev.tlg -* zc-compat-listings01.luatex.tlg -* zc-compat-listings01.luatexdev.tlg -* zc-compat-listings01.tlg -* zc-compat-listings01.xetex.tlg -* zc-compat-listings01.xetexdev.tlg -* zc-compat-memoir01.luatex.tlg -* zc-compat-memoir01.luatexdev.tlg -* zc-compat-memoir01.tlg -* zc-compat-memoir01.xetex.tlg -* zc-compat-memoir01.xetexdev.tlg -* zc-compat-subcaption01.luatex.tlg -* zc-compat-subcaption01.luatexdev.tlg -* zc-compat-subcaption01.tlg -* zc-compat-subcaption01.xetex.tlg -* zc-compat-subcaption01.xetexdev.tlg -* zc-compat-subfig01.luatex.tlg -* zc-compat-subfig01.luatexdev.tlg -* zc-compat-subfig01.tlg -* zc-compat-subfig01.xetex.tlg -* zc-compat-subfig01.xetexdev.tlg -* zc-fallback01.luatex.tlg -* zc-fallback01.luatexdev.tlg -* zc-fallback01.tlg -* zc-fallback01.xetex.tlg -* zc-fallback01.xetexdev.tlg -* zc-howto-amsmath01.luatex.tlg -* zc-howto-amsmath01.luatexdev.tlg -* zc-howto-amsmath01.tlg -* zc-howto-amsmath01.xetex.tlg -* zc-howto-amsmath01.xetexdev.tlg -* zc-howto-enumitem01.luatex.tlg -* zc-howto-enumitem01.luatexdev.tlg -* zc-howto-enumitem01.tlg -* zc-howto-enumitem01.xetex.tlg -* zc-howto-enumitem01.xetexdev.tlg -* zc-howto-listings01.luatex.tlg -* zc-howto-listings01.luatexdev.tlg -* zc-howto-listings01.tlg -* zc-howto-listings01.xetex.tlg -* zc-howto-listings01.xetexdev.tlg -* zc-howto-newfloat01.luatex.tlg -* zc-howto-newfloat01.luatexdev.tlg -* zc-howto-newfloat01.tlg -* zc-howto-newfloat01.xetex.tlg -* zc-howto-newfloat01.xetexdev.tlg -* zc-howto-newfloat02.luatex.tlg -* zc-howto-newfloat02.luatexdev.tlg -* zc-howto-newfloat02.tlg -* zc-howto-newfloat02.xetex.tlg -* zc-howto-newfloat02.xetexdev.tlg -* zc-howto-newfloat03.luatex.tlg -* zc-howto-newfloat03.luatexdev.tlg -* zc-howto-newfloat03.tlg -* zc-howto-newfloat03.xetex.tlg -* zc-howto-newfloat03.xetexdev.tlg -* zc-howto-newfloat04.luatex.tlg -* zc-howto-newfloat04.luatexdev.tlg -* zc-howto-newfloat04.tlg -* zc-howto-newfloat04.xetex.tlg -* zc-howto-newfloat04.xetexdev.tlg -* zc-howto-newfloat05.luatex.tlg -* zc-howto-newfloat05.luatexdev.tlg -* zc-howto-newfloat05.tlg -* zc-howto-newfloat05.xetex.tlg -* zc-howto-newfloat05.xetexdev.tlg -* zc-howto-newtheorem01.luatex.tlg -* zc-howto-newtheorem01.luatexdev.tlg -* zc-howto-newtheorem01.tlg -* zc-howto-newtheorem01.xetex.tlg -* zc-howto-newtheorem01.xetexdev.tlg -* zc-howto-newtheorem02.luatex.tlg -* zc-howto-newtheorem02.luatexdev.tlg -* zc-howto-newtheorem02.tlg -* zc-howto-newtheorem02.xetex.tlg -* zc-howto-newtheorem02.xetexdev.tlg -* zc-howto-newtheorem03.luatex.tlg -* zc-howto-newtheorem03.luatexdev.tlg -* zc-howto-newtheorem03.tlg -* zc-howto-newtheorem03.xetex.tlg -* zc-howto-newtheorem03.xetexdev.tlg -* zc-howto-newtheorem04.luatex.tlg -* zc-howto-newtheorem04.luatexdev.tlg -* zc-howto-newtheorem04.tlg -* zc-howto-newtheorem04.xetex.tlg -* zc-howto-newtheorem04.xetexdev.tlg -* zc-howto-zref-vario01.luatex.tlg -* zc-howto-zref-vario01.luatexdev.tlg -* zc-howto-zref-vario01.tlg -* zc-howto-zref-vario01.xetex.tlg -* zc-howto-zref-vario01.xetexdev.tlg -* zc-howto-zref-xr01.luatex.tlg -* zc-howto-zref-xr01.luatexdev.tlg -* zc-howto-zref-xr01.tlg -* zc-howto-zref-xr01.xetex.tlg -* zc-howto-zref-xr01.xetexdev.tlg -* zc-label-options01.luatex.tlg -* zc-label-options01.luatexdev.tlg -* zc-label-options01.tlg -* zc-langfile-dutch01.tlg -* zc-langfile-english01.tlg -* zc-langfile-french01.tlg -* zc-langfile-german01.tlg -* zc-langfile-portuguese01.luatex.tlg -* zc-langfile-portuguese01.luatexdev.tlg -* zc-langfile-portuguese01.tlg -* zc-langfile-portuguese01.xetex.tlg -* zc-langfile-portuguese01.xetexdev.tlg -* zc-langfile-spanish01.tlg -* zc-languages01.tlg -* zc-opt-check01.luatex.tlg -* zc-opt-check01.luatexdev.tlg -* zc-opt-check01.tlg -* zc-opt-d01.tlg -* zc-opt-g01.tlg -* zc-opt-hyperref01.luatex.tlg -* zc-opt-hyperref01.luatexdev.tlg -* zc-opt-hyperref01.tlg -* zc-opt-hyperref01.xetex.tlg -* zc-opt-hyperref01.xetexdev.tlg -* zc-opt-hyperref02.luatex.tlg -* zc-opt-hyperref02.luatexdev.tlg -* zc-opt-hyperref02.tlg -* zc-opt-hyperref02.xetex.tlg -* zc-opt-hyperref02.xetexdev.tlg -* zc-opt-hyperref03.luatex.tlg -* zc-opt-hyperref03.luatexdev.tlg -* zc-opt-hyperref03.tlg -* zc-opt-hyperref03.xetex.tlg -* zc-opt-hyperref03.xetexdev.tlg -* zc-opt-hyperref04.luatex.tlg -* zc-opt-hyperref04.luatexdev.tlg -* zc-opt-hyperref04.tlg -* zc-opt-hyperref04.xetex.tlg -* zc-opt-hyperref04.xetexdev.tlg -* zc-opt-hyperref05.luatex.tlg -* zc-opt-hyperref05.luatexdev.tlg -* zc-opt-hyperref05.tlg -* zc-opt-hyperref05.xetex.tlg -* zc-opt-hyperref05.xetexdev.tlg -* zc-opt-lang01.luatex.tlg -* zc-opt-lang01.luatexdev.tlg -* zc-opt-lang01.tlg -* zc-opt-lang01.xetex.tlg -* zc-opt-lang01.xetexdev.tlg -* zc-opt-lang02.luatex.tlg -* zc-opt-lang02.luatexdev.tlg -* zc-opt-lang02.tlg -* zc-opt-lang02.xetex.tlg -* zc-opt-lang02.xetexdev.tlg -* zc-opt-lang03.luatex.tlg -* zc-opt-lang03.luatexdev.tlg -* zc-opt-lang03.tlg -* zc-opt-lang03.xetex.tlg -* zc-opt-lang03.xetexdev.tlg -* zc-opt-lang04.luatex.tlg -* zc-opt-lang04.luatexdev.tlg -* zc-opt-lang04.tlg -* zc-opt-lang04.xetex.tlg -* zc-opt-lang04.xetexdev.tlg -* zc-opt-lang05.luatex.tlg -* zc-opt-lang05.luatexdev.tlg -* zc-opt-lang05.tlg -* zc-opt-lang05.xetex.tlg -* zc-opt-lang05.xetexdev.tlg -* zc-opt-lang06.luatex.tlg -* zc-opt-lang06.luatexdev.tlg -* zc-opt-lang06.tlg -* zc-opt-lang06.xetex.tlg -* zc-opt-lang06.xetexdev.tlg -* zc-opt-nocompat01.luatex.tlg -* zc-opt-nocompat01.luatexdev.tlg -* zc-opt-nocompat01.tlg -* zc-opt-nocompat01.xetex.tlg -* zc-opt-nocompat01.xetexdev.tlg -* zc-opt-nocompat02.luatex.tlg -* zc-opt-nocompat02.luatexdev.tlg -* zc-opt-nocompat02.tlg -* zc-opt-nocompat02.xetex.tlg -* zc-opt-nocompat02.xetexdev.tlg -* zc-opt-nocompat03.luatex.tlg -* zc-opt-nocompat03.luatexdev.tlg -* zc-opt-nocompat03.tlg -* zc-opt-nocompat03.xetex.tlg -* zc-opt-nocompat03.xetexdev.tlg -* zc-opt-ref01.tlg -* zc-opt-ref02.luatex.tlg -* zc-opt-ref02.luatexdev.tlg -* zc-opt-ref02.tlg -* zc-opt-ref02.xetex.tlg -* zc-opt-ref02.xetexdev.tlg -* zc-opt-titleref01.luatex.tlg -* zc-opt-titleref01.luatexdev.tlg -* zc-opt-titleref01.tlg -* zc-opt-titleref01.xetex.tlg -* zc-opt-titleref01.xetexdev.tlg -* zc-opt-vario01.luatex.tlg -* zc-opt-vario01.luatexdev.tlg -* zc-opt-vario01.tlg -* zc-opt-vario01.xetex.tlg -* zc-opt-vario01.xetexdev.tlg -* zc-precedence-rules01.luatex.tlg -* zc-precedence-rules01.luatexdev.tlg -* zc-precedence-rules01.tlg -* zc-precedence-rules01.xetex.tlg -* zc-precedence-rules01.xetexdev.tlg -* zc-sort01.tlg -* zc-typeset01.luatex.tlg -* zc-typeset01.luatexdev.tlg -* zc-typeset01.tlg -* zc-typeset01.xetex.tlg -* zc-typeset01.xetexdev.tlg -* zc-workaround-breqn01.luatex.tlg -* zc-workaround-breqn01.luatexdev.tlg -* zc-workaround-breqn01.tlg -* zc-workaround-breqn01.xetex.tlg -* zc-workaround-breqn01.xetexdev.tlg -* zc-zcref-options01.luatex.tlg -* zc-zcref-options01.luatexdev.tlg -* zc-zcref-options01.tlg -* zc-zcref-options01.xetex.tlg -* zc-zcref-options01.xetexdev.tlg -* zc-zcref-options02.luatex.tlg -* zc-zcref-options02.luatexdev.tlg -* zc-zcref-options02.tlg -* zc-zcref-options02.xetex.tlg -* zc-zcref-options02.xetexdev.tlg -* zc-zcref-options03.luatex.tlg -* zc-zcref-options03.luatexdev.tlg -* zc-zcref-options03.tlg -* zc-zcref-options03.xetex.tlg -* zc-zcref-options03.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-clever/source` directory. - -* zref-clever.dtx -* zref-clever.ins - -### TeX files (TDS) - -All files included in the `zref-clever/tex` directory. - -* zref-clever-dutch.lang -* zref-clever-english.lang -* zref-clever-french.lang -* zref-clever-german.lang -* zref-clever-portuguese.lang -* zref-clever-spanish.lang -* zref-clever.sty - -### Doc files (TDS) - -All files included in the `zref-clever/doc` directory. - -* CHANGELOG.md -* DEPENDS.txt -* MANIFEST.md -* README.md -* zref-clever-code.pdf -* zref-clever-code.tex -* zref-clever.pdf -* zref-clever.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-clever-code.pdf -* zref-clever-code.tex -* zref-clever.dtx -* zref-clever.ins -* zref-clever.pdf -* zref-clever.tex diff --git a/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.pdf b/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.pdf Binary files differindex c77a6ef340c..de4ac178cff 100644 --- a/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.pdf +++ b/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.pdf diff --git a/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.tex b/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.tex index edc439e5c31..e1bc9d02899 100644 --- a/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.tex +++ b/Master/texmf-dist/doc/latex/zref-clever/zref-clever-code.tex @@ -24,7 +24,7 @@ % zref-clever.ins, % zref-clever.tex, % zref-clever-code.tex, -% and the files listed in MANIFEST.md. +% and the files generated from them. % % The released version of this package is available from CTAN. % @@ -44,7 +44,10 @@ % Have \GetFileInfo pick up date and version data and used in the % documentation. -\usepackage[cap,nameinlink=false,check,titleref]{zref-clever} +\usepackage{zref-clever} +\zcsetup{cap,nameinlink=false} +\usepackage{zref-check} +\usepackage{zref-titleref} \begin{document} diff --git a/Master/texmf-dist/doc/latex/zref-clever/zref-clever.pdf b/Master/texmf-dist/doc/latex/zref-clever/zref-clever.pdf Binary files differindex 2b439d1d54c..213e51bf6b6 100644 --- a/Master/texmf-dist/doc/latex/zref-clever/zref-clever.pdf +++ b/Master/texmf-dist/doc/latex/zref-clever/zref-clever.pdf diff --git a/Master/texmf-dist/doc/latex/zref-clever/zref-clever.tex b/Master/texmf-dist/doc/latex/zref-clever/zref-clever.tex index e26992005d6..ee00821c16a 100644 --- a/Master/texmf-dist/doc/latex/zref-clever/zref-clever.tex +++ b/Master/texmf-dist/doc/latex/zref-clever/zref-clever.tex @@ -24,7 +24,7 @@ % zref-clever.ins, % zref-clever.tex, % zref-clever-code.tex, -% and the files listed in MANIFEST.md. +% and the files generated from them. % % The released version of this package is available from CTAN. % @@ -44,7 +44,10 @@ % The package itself *must* be loaded so that \GetFileInfo can pick up date % and version data. Naturally, we also use it. -\usepackage[cap,check,titleref]{zref-clever} +\usepackage{zref-clever} +\zcsetup{cap} +\usepackage{zref-check} +\usepackage{zref-titleref} \usepackage[T1]{fontenc} @@ -300,21 +303,22 @@ you should be ready to accommodate to eventual upstream changes. \section{Loading the package} \zlabel{sec:loading-package} -As usual: +\pkg{zref-clever} can be loaded with the usual: -\begin{zcexample}[escapeinside=`'] -\usepackage`\oarg{options}'{zref-clever} +\begin{zcexample} +\usepackage{zref-clever} \end{zcexample} +The package does not accept load-time options, package options must be set +using \cs{zcsetup} (see \zcref{sec:user-interface}). \section{Dependencies} \pkg{zref-clever} requires \pkg{zref}, and \LaTeX{} kernel 2021-11-15, or -newer. It also needs \pkg{l3keys2e} and \pkg{ifdraft}. Some packages are -leveraged by \pkg{zref-clever} if they are present, but are not loaded by -default or required by it, namely: \pkg{hyperref}, \pkg{zref-check}, and -\pkg{zref}'s \pkg{zref-titleref}, \pkg{zref-hyperref}, and \pkg{zref-xr} -modules. +newer. It also needs \pkg{ifdraft}. Some packages are leveraged by +\pkg{zref-clever} if they are present, but are not loaded by default or +required by it, namely: \pkg{hyperref}, \pkg{zref-check}, and \pkg{zref}'s +\pkg{zref-titleref}, \pkg{zref-hyperref}, and \pkg{zref-xr} modules. \section{User interface} @@ -402,14 +406,13 @@ as a whole; and ``reference format options'', which control the detail of reference formatting, including type-specific and language-specific settings. This section covers the first group (for the second one, see -\zcref{sec:reference-format}). General options can be set globally either as -package options at load-time (see \zcref{sec:loading-package}) or by means of -\cs{zcsetup} in the preamble (see \zcref{sec:user-interface}). They can also -be set locally with \cs{zcsetup} along the document or through the optional -argument of \cs{zcref} (see \zcref{sec:user-interface}). Most general options -can be used in any of these contexts, but that is not necessarily true for all -cases, some restrictions may apply, as described in each option's -documentation. +\zcref{sec:reference-format}). General options can be set globally by means +of \cs{zcsetup} in the preamble (see \zcref{sec:user-interface}). They can +also be set locally with \cs{zcsetup} along the document or through the +optional argument of \cs{zcref} (see \zcref{sec:user-interface}). Most +general options can be used in any of these contexts, but that is not +necessarily true for all cases, some restrictions may apply, as described in +each option's documentation. \bigskip{} @@ -708,16 +711,6 @@ are handled by \LaTeX{}, the fact that this option receives commands as value means this option \emph{can't} be set at load time, as a package option. If you want to set it globally, use \cs{zcsetup} instead. -\DescribeOption{titleref} % -\DescribeOption{vario} % -The \opt{titleref} option receives no value and, when given, loads -\pkg{zref}'s \pkg{zref-titleref} module. Similarly, the \opt{vario} option -loads the \pkg{zref-vario} package. These are a preamble only options. Note -that \pkg{zref-vario} loads \pkg{varioref}, which has known load order -interaction with other packages, prominently with \pkg{hyperref}. Hence, -depending on your document, you may wish to load \pkg{zref-vario} separately, -instead of through the option. - \DescribeOption{note} % The \opt{note} option receives as value some text to be typeset at the end of the whole reference list. It is separated from it by \opt{notesep} (see @@ -725,15 +718,14 @@ the whole reference list. It is separated from it by \opt{notesep} (see \DescribeOption{check} % Provides integration of \pkg{zref-clever} with the \pkg{zref-check} package. -In the preamble, the \opt{check} option receives no value and, when given, -loads \pkg{zref-check}. In the document body, \opt{check} requires a value, -which works exactly like the optional argument of \cs{zcheck}, and can receive -both checks and \cs{zcheck}'s options. And the checks are performed for each -label in \marg{labels} received as argument by \cs{zcref}. See the User -manual of \pkg{zref-check} for details. The checks done by the \opt{check} -option in \cs{zcref} comprise the complete reference, including the \opt{note} -(see \zcref{sec:reference-format}). If \pkg{zref-check} was not loaded in the -preamble, at begin document the option is made no-op and issues a warning. +The option is only functional in the document body and if \pkg{zref-check} has +been loaded. \opt{check} requires a value, which works exactly like the +optional argument of \cs{zcheck}, and can receive both checks and +\cs{zcheck}'s options. And the checks are performed for each label in +\marg{labels} received as argument by \cs{zcref}. See the User manual of +\pkg{zref-check} for details. The checks done by the \opt{check} option in +\cs{zcref} comprise the complete reference, including the \opt{note} (see +\zcref{sec:reference-format}). \DescribeOption{countertype} % The \opt{countertype} option allows to specify the ``reference type'' of each @@ -934,14 +926,8 @@ formatting at low precedence levels, and the users can easily and conveniently override them as desired. ``General'' options (i) can be given by the user in the optional argument of -\cs{zcref}, but also set through \cs{zcsetup} or even, depending on the case, -as package options at load-time (see \zcref{sec:options}).\footnote{The use of - \cs{zcsetup} for global reference format settings is recommended though. - Whether you can use load-time options or not depends on the values of the - options: due to how \LaTeX{} handles package options, if the values of the - options you are setting include \emph{commands} you can't set them at - load-time, and rather \emph{must} use \cs{zcsetup}.} ``Type'' specific -options (ii) are handled by \cs{zcRefTypeSetup} (see +\cs{zcref}, but also set through \cs{zcsetup} (see \zcref{sec:options}). +``Type'' specific options (ii) are handled by \cs{zcRefTypeSetup} (see \zcref{sec:user-interface}). ``Language'' options, whether ``type'' specific (iii) or ``default'' (iv) have their user interface in \cs{zcLanguageSetup}, and have their values populated by the package's built-in language files (see @@ -1547,14 +1533,14 @@ set around a cross-reference ``task'' we'd like to perform with position between the reference and the label being referred to using \pkg{varioref}.} -\pkg{zref-vario}, which can be enabled with package option \opt{vario}, offers -a layer of compatibility with \pkg{varioref} and provides -\texttt{\textbackslash{}z}\dots{} counterparts for the latter's main reference -commands. +The \pkg{zref-vario} package offers a layer of compatibility with +\pkg{varioref} and provides \texttt{\textbackslash{}z}\dots{} counterparts for +the latter's main reference commands. \begin{zchowto}[caption={\pkg{zref-vario}}] \documentclass{article} -\usepackage[vario]{zref-clever} +\usepackage{zref-clever} +\usepackage{zref-vario} \begin{document} \section{Section 1} \zlabel{sec:section-1} @@ -2298,6 +2284,7 @@ were generously provided by (in chronological order): % 2021-09-06: https://github.com/ho-tex/zref/issues/13 % 2021-10-26: https://github.com/latex3/latex2e/issues/687 % 2022-01-12: https://chat.stackexchange.com/transcript/message/60129233#60129233 + % 2022-04-09: https://github.com/latex3/hyperref/issues/229#issuecomment-1093870142 Phelype Oleinik, % 2021-08-20: https://tex.stackexchange.com/q/611370 (comments) % 2021-09-09: https://tex.stackexchange.com/a/614704 @@ -2356,8 +2343,10 @@ Thank you all very much! 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-clever/blob/main/CHANGELOG.md}. An -archive of historical versions of the package is also kept at -\url{https://github.com/gusbrs/zref-clever/releases}. +at \url{https://github.com/gusbrs/zref-clever/blob/main/CHANGELOG.md}. The +change log is also distributed with the package's documentation through CTAN +upon release so, most likely, \texttt{texdoc zref-clever/changelog} should +provide easy local access to it. An archive of historical versions of the +package is also kept at \url{https://github.com/gusbrs/zref-clever/releases}. \end{document} |