1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
|
# Changelog
## [Unreleased](https://github.com/gusbrs/zref-clever/compare/v0.5.1...HEAD)
## [v0.5.1](https://github.com/gusbrs/zref-clever/compare/v0.5.0...v0.5.1) (2024-11-28)
### Fixed
- Use `\protected@edef` to expand references' content at `endrange` processing
functions.
## [v0.5.0](https://github.com/gusbrs/zref-clever/compare/v0.4.9...v0.5.0) (2024-11-25)
### Added
- Swedish localization (see issue
[#35](https://github.com/gusbrs/zref-clever/issues/35)).
### Changed
- The `declension` option from `\zcDeclareLanguage`, the `case` option from
`\zcLanguageSetup`, and the `d` general option (from `\zcref`) have been
renamed to `variants`, `variant`, and `v`, respectively. This is a
"semantic generalization" of the existing infrastructure. In other words,
the package now interprets more broadly type name variants, which can be
used for any language-specific needs and not just declension cases. See
discussion at issue [#35](https://github.com/gusbrs/zref-clever/issues/35).
### Deprecated
- The `declension` option from `\zcDeclareLanguage`, the `case` option from
`\zcLanguageSetup`, and the `d` general option (from `\zcref`) have been
deprecated in favor of their new names.
## [v0.4.9](https://github.com/gusbrs/zref-clever/compare/v0.4.8...v0.4.9) (2024-11-16)
### Changed
- Convert improved `beamer` work-around into compatibility module.
## [v0.4.8](https://github.com/gusbrs/zref-clever/compare/v0.4.7...v0.4.8) (2024-11-07)
### Changed
- Documentation improvements.
- Preemptively avoid empty module when setting l3keys `.inherit:n`
(https://github.com/latex3/latex3/issues/1254).
## [v0.4.7](https://github.com/gusbrs/zref-clever/compare/v0.4.6...v0.4.7) (2024-09-30)
### Changed
- Inhibit missing name warning if `noname` option is in use.
## [v0.4.6](https://github.com/gusbrs/zref-clever/compare/v0.4.5...v0.4.6) (2024-08-23)
### Fixed
- Fix sorting of appendix references.
### Changed
- The `counterresetters` option now receives a full comma separated list of
counters as value, instead of working by incrementally adding values to the
list.
## [v0.4.5](https://github.com/gusbrs/zref-clever/compare/v0.4.4...v0.4.5) (2024-05-20)
### Added
- Provided Russian language file (see PR
[#29](https://github.com/gusbrs/zref-clever/pull/29)).
## [v0.4.4](https://github.com/gusbrs/zref-clever/compare/v0.4.3...v0.4.4) (2024-03-14)
### Changed
- Use `\noeqref` instead of `mathtools`' internals to support `showonlyrefs`
option in `mathtools` compatibility module.
## [v0.4.3](https://github.com/gusbrs/zref-clever/compare/v0.4.2...v0.4.3) (2023-11-14)
### Changed
- Don't use `expl3` public scratch temporary variables.
- Prefer `e-type` expansion.
- Require 2023-11-01 LaTeX kernel.
## [v0.4.2](https://github.com/gusbrs/zref-clever/compare/v0.4.1...v0.4.2) (2023-08-14)
### Changed
- Thanks to better support for `zref` in `memoir`, the corresponding
compatibility module has been simplified and made more robust, without loss
of functionality.
- Use `\label` instead of `\zlabel` in regression tests.
## [v0.4.1](https://github.com/gusbrs/zref-clever/compare/v0.4.0...v0.4.1) (2023-06-19)
### Changed
- Improved Dependencies section in User manual.
### Fixed
- Use safer method to define the `zc@pgfmt` property.
## [v0.4.0](https://github.com/gusbrs/zref-clever/compare/v0.3.6...v0.4.0) (2023-06-14)
### Added
- `labelhook` option, controlling whether to set a `\zlabel` alongside a
standard `\label`. This option uses the kernel's new `label` hook, which
significantly improves and simplifies the task of setting a `\zlabel` in
places where this is not directly supported. The option is enabled by
default, and strongly recommended. It is not expected that this change will
bring backward compatibility problems, `\zlabel`s continue to work just as
before, and the places where a `\label` is required will also continue to
work the same way. The only case I see where you might need to adjust
existing documents is if you already had both `\label`s and `\zlabel`s with
the same names, in which case now you'll have a duplicate `zlabel` and will
indeed have to correct it. Also, you may be interested in taking a look at
the "`\label` or `\zlabel`?" section of the User manual, since the option
opens the possibility of a different approach in label setting in your
documents.
### Changed
- Given the new `labelhook` option and the fact that it requires both the new
`label` hook and the new hooks with options released in the latest LaTeX
kernel, the kernel version required by `zref-clever` has been bumped to
2023-06-01.
### Removed
- Given the new `labelhook` option, the parts of compatibility modules which
provided for setting `\zlabel`s with `\label` in places where the former is
not supported have been removed. These would conflict with the new option,
and the use of the `label` hook for this purpose renders them unnecessary
and is superior in every aspect. Namely, the compatibility modules changed
in this fashion are: `amsmath`, `memoir`, and `listings`.
## [v0.3.6](https://github.com/gusbrs/zref-clever/compare/v0.3.5...v0.3.6) (2023-02-21)
### Fixed
- Avoid "Missing number, treated as zero" error for labels set before first
call to `\refstepcounter`.
## [v0.3.5](https://github.com/gusbrs/zref-clever/compare/v0.3.4...v0.3.5) (2023-02-18)
### Fixed
- In tcolorbox how-to, `hyperref` should be loaded before any `\newtcolorbox`es.
## [v0.3.4](https://github.com/gusbrs/zref-clever/compare/v0.3.3...v0.3.4) (2023-02-13)
### Added
- `tcolorbox` how-to to the User manual.
### Changed
- The `KOMA` compatibility module has been removed, since it was rendered
unnecessary by recent versions of KOMA Script classes.
## [v0.3.3](https://github.com/gusbrs/zref-clever/compare/v0.3.2...v0.3.3) (2023-01-03)
### Added
- New `reftype` option, to allow for local manual override of `countertype`
settings.
- Included some new How-tos to the User manual.
## [v0.3.2](https://github.com/gusbrs/zref-clever/compare/v0.3.1...v0.3.2) (2022-12-27)
### Added
- Italian localization (see issue
[#11](https://github.com/gusbrs/zref-clever/issues/11)).
- Localization guidelines for contributors (in the Code documentation).
- Document UTF-8 input encoding requirement.
- Work-around for `beamer` in the User manual.
### Changed
- Improved consistency of the Dutch language file with `babel` captions (see
PRs [#12](https://github.com/gusbrs/zref-clever/pull/12) and
[#13](https://github.com/gusbrs/zref-clever/pull/13)).
## [v0.3.1](https://github.com/gusbrs/zref-clever/compare/v0.3.0...v0.3.1) (2022-05-28)
### Added
- "`zref-clever` for the impatient" section to User manual.
## [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)
### Changed
- (Internal) Option variables setting was reviewed, ensuring proper scope is
in use and that they are always properly declared. `expl3` debugging
enabled in regression tests.
## [v0.2.1-alpha](https://github.com/gusbrs/zref-clever/compare/v0.2.0-alpha...v0.2.1-alpha) (2022-02-07)
### Added
- Option `endrange` for typesetting terse ranges.
- Option `rangetopair` to control behavior of `range` option when a pair
results from building a range.
- Option `vario` to load package `zref-vario`.
- Reference property `subeq` for the `amsmath` and `breqn` compatibility
modules.
## [v0.2.0-alpha](https://github.com/gusbrs/zref-clever/compare/v0.1.2-alpha...v0.2.0-alpha) (2022-01-28)
### Added
- The reference block formatting has been generalized to allow for more
flexibility in setting the reference structure, with the new option
`refbounds`.
### Fixed
- Fixed handling of type names defined to be empty.
- Fixed distinction of `lastsep` and `pairsep` in cases where the type-block
starts or ends with a range.
### Changed
- The `namefont` and `reffont` options can now be set also in
`\zcRefTypeSetup` and `\zcLanguageSetup`.
- (Internal) Moved from property lists to individually named macros to store
and retrieve options.
### Deprecated
- Options `preposinlink`, `preref`, and `postref` have been deprecated and
replaced by new option `refbounds`.
## [v0.1.2-alpha](https://github.com/gusbrs/zref-clever/compare/v0.1.1-alpha...v0.1.2-alpha) (2022-01-10)
### Added
- Provided Dutch language file (see PR
[#5](https://github.com/gusbrs/zref-clever/pull/5)).
### Changed
- The `gender` key in `\zcLanguageSetup` and in the built-in language files
can receive a comma separated list as value to support types with multiple
valid genders.
- The `cap` and `abbrev` options can now be set also in `\zcRefTypeSetup` and
`\zcLanguageSetup`, so that fine grained control per-type and per-language
is now possible for these options.
- Abandoned the "dictionary/translation" metaphor to refer to language
specific options. Mostly housekeeping, affecting the name-scheme of
functions and variables, but aiming at a clearer documentation in this area,
specially in the longer term.
### Deprecated
- The reference format options `refpre` and `refpos` have been deprecated in
favor or the more aptly named `preref` and `postref`, respectively.
## [v0.1.1-alpha](https://github.com/gusbrs/zref-clever/compare/v0.1.0-alpha...v0.1.1-alpha) (2021-12-07)
### Changed
- Improvements to the French dictionary (see issue
[#1](https://github.com/gusbrs/zref-clever/issues/1)).
- Improvements to documentation.
### Removed
- Dropped the `subappendix` reference type.
## [v0.1.0-alpha](https://github.com/gusbrs/zref-clever/releases/tag/v0.1.0-alpha) (2021-11-24)
### Added
- Initial release.
|