-
Notifications
You must be signed in to change notification settings - Fork 9
/
HISTORY
381 lines (376 loc) · 20.5 KB
/
HISTORY
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
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
--------------------------------------------------------------------------
the ACRO package
Typeset Acronyms
--------------------------------------------------------------------------
Clemens Niederberger
Web: https://github.com/cgnieder/acro
E-Mail: [email protected]
--------------------------------------------------------------------------
Copyright 2012--2022 Clemens Niederberger
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
http://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of LaTeX
version 2008/05/04 or later.
This work has the LPPL maintenance status `maintained'.
The Current Maintainer of this work is Clemens Niederberger.
--------------------------------------------------------------------------
2012 VERSION 0
--------------------------------------------------------------------------
2012/06/22 v0.1 - first public release
2012/06/23 v0.1a - bug fix, added `strict' and `macros' option and creation of
shortcut macros
- added capitalized version of long forms
- added `sort' option
2012/06/24 v0.1b - added \Acf and \Acfp, added option `plural-ending'
2012/06/24 v0.1c - added excluded argument to \printacronyms
2012/06/24 v0.2 - renamed \NewAcronym => \DeclareAcronym
\AcronymFormat => \DeclareAcronymFormat
2012/06/25 v0.2a - new first-style's: `short' and `reversed'
2012/06/25 v0.3 - new list formats: extra-tabular, extra-longtable,
extra-tabular-rev, extra-longtable-rev
- extra precaution when using \printacronyms to avoid errors.
2012/06/27 v0.3a - new option `list-caps', \Acp added
2012/06/29 v0.3b - extended the `text' template to the `acro-first' object
- added `acro-first' instances `plain' and `plain-reversed'
2012/07/16 v0.3c - small adjustments to the documentation
2012/07/23 v0.3d - first CTAN version
2012/07/24 v0.3e - adapted to updated l3kernel
2012/09/28 v0.4 - added means to add citations to acronyms
2012/10/07 v0.4a - new options: "uc-cmd", "list-long-format"
- preliminary language support, needs package `translations'
2012/11/30 v0.5 - added starred variants of the commands that won't mark an
acronym as used
- added \acreset{<id>}
- added preliminary support for pdf strings: in pdf strings
always the singular lowercase short version is inserted
(the equivalent of \acs)
2012/12/14 v0.6 - bug with not-colored links resolved
- bug introduced with the last update (full expansion of the
short entry) resolved
- option `xspace' added
2013/01/02 v0.6a - \acuseall
--------------------------------------------------------------------------
2013 VERSION 1
--------------------------------------------------------------------------
2013/01/16 v1.0 - new syntax of \DeclareAcronym
- new option `version'
- new `accsupp' acronym property
- new `sort' acronym property
- new syntax of \printacronyms
- new default: `sort=true'
- new options `page-ranges', `next-page', `next-pages',
`pages-name', `record-pages'
- no automatic label placement for page number referencing
any more
2013/01/26 v1.1 - bug fix in the plural detection
- new keys `long-pre' and `long-post'
- new keys `index', `index-sort' and `index-cmd'
- new options `index' and `index-cmd'
2013/01/29 v1.1a - added `long-format' key
- renamed `format' key into `short-format', kept `format' for
compatibility reasons
2013/02/09 v1.2 - error message instead of hanging when an undefined acronym
is used
- added `first-long-format' key and `first-long-format' option
- added \acflike and \acfplike
- improvements and bug fixes to the page recording mechanism
- new option `mark-as-used'
- new keys: `short-indefinite', `alt-indefinite' and
`long-indefinite'
- new commands: \iac, \Iac, \iacs, \Iacs, \iaca, \Iaca, \iacl,
\Iacl, \iacf, \Iacf, \iacflike and \Iacflike
2013/04/04 v1.2a - added Portuguese translations
2013/05/06 v1.3 - protected internal commands where appropriate
- new option `sort' to \printacronyms
- renamed options `print-acronyms/header' and `list-header'
into `print-acronyms/heading' and `list-heading'
- fix: added missing group to \printacronyms
- add key `foreign'
- rewritten page-recording:
* most importantly: record them at shipout; this is done
when \acro@used@once or \acro@used@twice are written to
the aux file
* no restrictions regarding \pagenumbering
* options `page-ranges' and `record-pages' are deprecated
* new options `following-page' and `following-pages'
- disable \@noitemerr in the list of acronyms: we don't need
it there but there are occasions when it is annoying
- cleaned the sty file, added a few more comments
2013/05/09 v1.3a - Bug fix: corrected wrong argument checking in \Ac, thanks
to Michel Voßkuhle
2013/05/30 v1.3b - obey \if@filesw
2013/06/16 v1.3c - added \leavevmode to \acro_get:n
2013/07/08 v1.3d - corrected wrong call of \leavevmode in the list
(list-type=list)
2013/08/07 v1.3e - bug fix in the list when testing for used acronyms
- new commands \acifused, \acfirstupper
2013/08/27 v1.4 - new property `list'
2013/09/02 v1.4a - bug fix: used acronyms are added to the list when the list
is printed before the use
- \DeclareAcronym may now be used after \begin{document}
2013/09/24 v1.4b - bug fix: only-used=false works again for only declared but
unused acronyms (only if option single is not used)
2013/11/04 v1.4c - remove \hbox from the written short form
- changed \__acro_make_link:nNN in a way that it doesn't box
its when links are deactivated
2013/11/22 v1.4d - require `l3sort' independently from the `sort' option
instead of at begin document in order to avoid conflicts
with `babel' and `french'
2013/12/18 v1.5 - new option `label=true|false' that
places \label{<prefix>:<id>} the first time an acronym is
used
- new option `pages=first|all' that determines if in the list
of acronyms all appearances are listed or only the first
time; implicitly sets `label=true'
2015/02/26 v1.6 - new `acro-title' instance `none'
- change of expl3's tl uppercasing function (adapt to updates
of l3kernel and friends
- new package option `messages=silent|loud'
- fix issue https://github.com/cgnieder/acro/issue/23/
- fix issue https://github.com/cgnieder/acro/issue/24/
- fix issue https://github.com/cgnieder/acro/issue/28/
- drop support for version 0
2015/04/08 v1.6a - more generalized user command definitions, see
http://tex.stackexchange.com/q/236362/ for an application
2015/05/10 v1.6b - \ProcessKeysPackageOptions ,
- correct bug http://tex.stackexchange.com/q/236860/ :
option `pages = first' works again
--------------------------------------------------------------------------
2015 VERSION 2
--------------------------------------------------------------------------
2015/08/16 v2.0 - fix https://github.com/cgnieder/acro/issue/36
- implement https://github.com/cgnieder/acro/issue/39
- implement https://github.com/cgnieder/acro/issue/40
(=> new option `group-cite-cmd')
- add ideas for https://github.com/cgnieder/acro/issue/41
- implement https://github.com/cgnieder/acro/issue/18
- implement https://github.com/cgnieder/acro/issue/43
- further generalization for defining user commands:
\NewAcroCommand, \NewPseudoAcroCommand and siblings
- bug fix in indefinite versions with first-upper
- add `short-<ending>-form' equivalent to
`long-<ending>-form'
(https://github.com/cgnieder/acro/issue/44)
- implement https://github.com/cgnieder/acro/issue/35
- new option `single-form'
2015/08/25 v2.0a - fix https://github.com/cgnieder/acro/issue/38 and
https://github.com/cgnieder/acro/issue/49
2015/08/29 v2.0b - fix https://github.com/cgnieder/acro/issue/44
- fix https://github.com/cgnieder/acro/issue/45
- implement https://github.com/cgnieder/acro/issue/42
2015/09/05 v2.1 - add list object type `list-of' that prints the list like a
toc or lof, new option `list-short-width',
- correct bug in the `plain' extra style
- implemented `tooltip' property
- remove \tl_to_lowercase:n
2015/10/03 v2.2 - fix https://github.com/cgnieder/acro/issue/52
- fix typo in `list-of' object
- \DeclareAcroListStyle
- \DeclareAcroListHeading
- input `acro.cfg' if present
- all acro commands have an optional argument: \ac*[]{}
2016/01/07 v2.2a - \prop_get:Nn => \prop_item:Nn
2016/01/21 v2.2b - fix issue #59
2016/02/02 v2.2c - fix issue #60
2016/03/14 v2.3 - foreign-format may be a macro taking an argument
- \Aca, \Acsingle
- properties `single' and `single-format', option
`single-format' => issue #62
- property `first-style' => issue #61
- fix issue #64: long-post entry is now added *after* the
endings
- property `foreign-lang'
- fix issue #65
2016/03/25 v2.4 - extend class mechanism: classes can be used like tags
- add idea of `barriers' and list local to those barriers
=> new option `reset-at-barriers'
=> new option `local-to-barriers' for \printacronyms
=> new command \acbarrier
2016/04/14 v2.4a - if undefined acronym is used and `messages = silent' is
active don't through error
2016/05/03 v2.4b - expand `pdfstring' property before saving => issue #69
- \ProvideAcroEnding can be used twice – it then just sets
the defaults
- the option <ending>-ending has a new syntax:
* <ending>-ending = <val> sets all endings to <val>
* <ending>-ending = <val1>/<val2> sets short endings to
<val1> and long endings to <val2>
- a single appearance should be treated like a first
appearance as far as citations are concerned
2016/05/25 v2.5 - some of the entries added to the aux file need to be
written \immediate in order to avoid this trap:
http://tex.stackexchange.com/q/116001/
- cleaner interface for first-style template definitions
- new `acro-first' instances `footnote-reversed' and
`sidenote-reversed'
- new commands \DeclareAcroFirstStyle, \DeclareAcroExtraStyle
and \DeclareAcroPageStyle
- add warning `ending-before-acronyms' to options setting the
defaults of an ending; this should avoid confusion
- property declaration for acronyms should be handled by
internal functions
- improvements in the list template code
- logging info when an acronym is declared
- remove deprecated options
- new option `use-barriers'
- new option `following-pages*'
- option `page-ref' replaced by option `page-style'
2016/05/26 v2.5a - bug fix: remove erroneous group in `<ending>-ending' option
2016/05/30 v2.5b - fix issue #72
2016/07/20 v2.6 - \l__acro_use_acronyms_bool can be used to disable \ac
e.g. in the trial phase of a table like `tabu'; interface:
\acro_switch_off: and \acswitchoff
- fix issue #79
- fix issue #74
- fix error: acronyms with same sort entry are not
overwritten any more in the list of acronyms
2016/08/13 v2.6a - fix issues #80 and #81
2016/08/13 v2.6b - version stepped by accident
2016/08/16 v2.6c - really fixes issue #81
2016/08/30 v2.6d - fix issue #82
2016/09/04 v2.6e - fix issue in http://tex.stackexchange.com/q/270034/
2017/01/22 v2.7 - rename \acro_get_property:nn into \__acro_get_property:nn
- \acro_get_property:nn, \acro_get_property:nnTF,
\acro_if_property:nnTF, retrieve property without error if
not set
- make \__acro_declare_property functions public
- \acro_add_action:n (adds code to \acro_get:n)
2017/02/09 v2.7a - adapt to integration of l3sort into l3kernel
2017/06/21 v2.7b - fix issue #93
2017/08/28 v2.7c - fix issue #96
2018/01/30 v2.8 - fix issue #94
- document `format-include-endings', fix issue #99
- new property `post'
- \aciffirst
- resolve issue #95
2019/02/17 v2.9 - small redefinition of \acro_get_foreign:n which allows
`foreign-sep' to be a &
- fix issue #116
- implemented issue #112
2019/09/23 v2.10 - fix issue #120
- fix isuue #128
- fix issue #129
- fix issue #131
- new: \Acs \Acsp \Aca \Acap
- new: `alt-format'
- new: `uppercase-short'
- a change to how usage is determined (see def. of
\acro_is_used:nTF)
2019/10/02 v2.10a - fix newly introduced issue #135
2019/10/06 v2.10b - fix issue #137
- clearer documentation of `uppercase-short'
- set the default of `uppercase-short' to `true'
2019/10/12 v2.10c - fix issue #139
2019/12/30 v2.10d - fix issue #76
- fix issue #141
- fix issue #143
2020/01/11 v2.11 - new commands \acpsingle and \Acpsingle
- fix issues with optional arguments of the `cite' property
- new properties `before-citation' and `after-citation'
- new options `config-file-name' and `config-file-extension'
- new option `case-sensitive'
- rename the manual file and use a dedicated class for the
manual
- prefer lazy boolean evaluation when possible
2020/01/16 v2.11a - adapt to new l3text module
2020/01/24 v2.11b - fix issue #147
2020/02/03 v2.11c - fix issue #76
2020/03/07 v2.11c - fix issues #149 and #150
--------------------------------------------------------------------------
2020 VERSION 3
--------------------------------------------------------------------------
2020/04/29 v3.0 - complete re-write of acro with new features and all open
issues resolved
2020/05/03 v3.1 - unify licence statements
- fix bug in combination with ``usage''
- repair pdfcomment feature (when did that get lost?)
- improve formatting mechanism
- add `patch' module: patches floats, common content lists,
and tables in their measuring phase
- add option `foreign/display'
- \acroifboolean(TF)
- add missing code in some of the list templates
- improve examples code
2020/05/10 v3.2 - fix units example
- prevent to early expansion of formatting instructions
- fix error in \AcroNeedPackage
- fix wrong usage of `longtabu' in the `longtable' template
- add `supertabular' template
- new: `display properties', this adds
`list/foreign/display'
- add further examples
- \SetupAcroTemplate, \SetupNextAcroTemplate
- properly define and document \AcroTemplateName and
\AcroTemplateType
2020/11/08 v3.2a - fix issue #163
- fix issue #164
- fix issue #166
- fix issue #172
- fix issue #175
- fix issue #176
- fix issue #180
- add `patch' options
2020/11/21 v3.3 - fix issue #183
- fix issue #184
- fix issue #188
- remove double declaration of \g__acro_rerun_bool in
acro2.sty
- change default of `format/replace'
- correct the behavior of the `single' property
- remove property `single-format'
- fix bug in \acro_print_pages:nnn
- allow page option setting in the argument of
\printacronyms (implements issue #189)
2020/12/25 v3.4 - fix issue #194
- new option `list/add'
- new: \acroneedpages
- add option `subsequent-style'
- add property `subsequent-style'
2021/01/16 v3.5 - new property `preset'
- new: \NewAcroPreset and related commands
- new: \acroifstarred(TF), cf. issue #162
- reset endings at start of acronym commands: resolve issue
#191
- new property `uselist'
- add \acrodotfill and use it instead of \dotfill
- new option `link-only-first'
- \AcroPropertiesSet
- file acro-examples.sty
- public \g_acro_acronyms_seq
- \acro_map_acronyms:n , \acro_map_break: , \AcroAcronymsMap ,
and \AcroMapBreak
- extend `index/use' with choice `indexed', document
property `index-cmd'
- remove zref dependency
2022/01/04 v3.6 - add option `case-insensitive'
- make \DeclareAcronym a preample-only command
- implement issue #216
- implement issue #224
- fix typos
- fix issue #229
- add `addsec*' and `addchap*' as heading options
2022/01/27 v3.7 - add \acroendfootnote to the footnote `template'
- drop use of l3kernel lua table, fixes #235
- add error message of \NewAcroTemplate tries to define an
existing template
- add `longtable' patch
2022/04/01 v3.8 - use LaTeX's release mechanism for managing usage for
version 2 or 3
- fix issue #223: inner acronyms don't inherit articles any more
- require `etoolbox' for the patches
- prepare for `translations' v2.0
- reset `table' counter in `longtable' list template
- drop `longtabu' list template
- add `tabularray' and `xltabular' list templates
- add \l_acro_nest_level_int
- new option `acro/templates/colspec'
- use \Hy@raisedlink for raising links (even if this will
effectively disable raising in a longtable which sets
\baselineskip = 0)
- fix issue #212 (record pages only during shipout)
- fix layout errors (mostly missing commas) in some of the
templates
- fix error in examples file