texlive[61488] Master/texmf-dist: acro (4jan22)
commits+karl at tug.org
commits+karl at tug.org
Tue Jan 4 23:27:40 CET 2022
Revision: 61488
http://tug.org/svn/texlive?view=revision&revision=61488
Author: karl
Date: 2022-01-04 23:27:40 +0100 (Tue, 04 Jan 2022)
Log Message:
-----------
acro (4jan22)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/acro/README
trunk/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
trunk/Master/texmf-dist/doc/latex/acro/acro-manual.tex
trunk/Master/texmf-dist/tex/latex/acro/acro.sty
Modified: trunk/Master/texmf-dist/doc/latex/acro/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/acro/README 2022-01-04 00:48:44 UTC (rev 61487)
+++ trunk/Master/texmf-dist/doc/latex/acro/README 2022-01-04 22:27:40 UTC (rev 61488)
@@ -1,5 +1,5 @@
#--------------------------------------------------------------------------
-the ACRO package v3.5 2021/01/16
+the ACRO package v3.6 2022/01/04
Typeset Acronyms
@@ -8,7 +8,7 @@
Web: https://github.com/cgnieder/acro
E-Mail: contact at mychemistry.eu
--------------------------------------------------------------------------
-Copyright 2012--2021 Clemens Niederberger
+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
Modified: trunk/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/acro/acro-manual.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/acro/acro-manual.tex 2022-01-04 00:48:44 UTC (rev 61487)
+++ trunk/Master/texmf-dist/doc/latex/acro/acro-manual.tex 2022-01-04 22:27:40 UTC (rev 61488)
@@ -10,7 +10,7 @@
% Web: https://github.com/cgnieder/acro/
% E-Mail: contact at mychemistry.eu
% --------------------------------------------------------------------------
-% Copyright 2011--2021 Clemens Niederberger
+% Copyright 2011--2022 Clemens Niederberger
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3c
@@ -295,12 +295,11 @@
The option allows you to use the last version prior to the update to
version~3. This may help if you don't have the time to fix issues after
upgrading to the new version.
- \keybool{upgrade}\Default{true}
+ \keybool{upgrade}\Default{false}
When this option is used \acro\ tries to give as much helpful and
meaningful warning or error messages when a deprecated or removed command,
property, or option is used. This is especially useful if you are
- upgrading from version~2. The option will initially be true for a few
- months after the upgrade to version~3.
+ upgrading from version~2.
\end{options}
\subsection{Setup command}\label{sec:setup-command}
@@ -355,10 +354,12 @@
properties. Many properties are also explained in more detail in later
sections of this manual.
\begin{options}
- \keybool{case-sensitive}\Default{false}
+ \keybool{case-sensitive}\Default{true}
When this is set you can write the \ac{id} of the acronym upper- or lower-
or mixed case and it is recognized by \acro\ as the same. This might be
useful when the acronym appears in the page header, for example.
+ \keybool{case-insensitive}\Default{false}
+ \sinceversion{3.6}The inverse of the option \option{case-sensitive}.
\end{options}
\begin{bewareofthedog}
@@ -595,7 +596,7 @@
%% preset
\propval{preset}{set name}\Default
\sinceversion{3.5}Enables to load a set of properties that has been
- defined earlier with \cs{NewAcroPreset}, siehe
+ defined earlier with \cs{NewAcroPreset}, see
section~\vref{sec:presets}.
%% uselist
\propval{uselist}{csv list of acronym ids}\Default
@@ -786,7 +787,7 @@
The single appearance of an acronym is determined by this option:
\begin{options}
\keychoice{single}{\default{true},false,\meta{number}}\Default{false}
- This option determines wether a single appearance of an acronym counts as
+ This option determines whether a single appearance of an acronym counts as
\emph{usage}. It might be desirable in such cases that an acronym is
simply printed as long form and not added to the list of acronym. This is
what this option does. With \meta{number} the minimal number of usages
@@ -843,15 +844,15 @@
\end{commands}
The options controlling the list are these:
\begin{options}
- \keychoice{template}{description,table,longtable,lof,toc}%
+ \keychoice{template}{description,tabular,longtable,supertabular,lof,toc}%
\Module{list}\Default{description}
Choose the template to create the list with. See more on this in
sections~\vref{sec:templates} and~\vref{sec:examples}.
\keybool{sort}\Module{list}\Default{true}
- Decide wether to sort the list of acronyms alphabetically or to print it
+ Decide whether to sort the list of acronyms alphabetically or to print it
in order of definition.
\keychoice{display}{all,used}\Module{list}\Default{used}
- Decide wether to print only the acronyms actually used in the document or
+ Decide whether to print only the acronyms actually used in the document or
all acronyms which have been declared in the preamble.
\keyval{exclude}{csv list of tags}\Module{list}\Default
Set a list of tags to exclude from the list. Only acronyms not
@@ -879,7 +880,7 @@
This only has an effect if the list template supports it. All pre-defined
templates \emph{do} support it.
\keybool{display}\Module{list,locale}\Default{false}
- This options determines wether the language of the foreign form is printed
+ This options determines whether the language of the foreign form is printed
or not.
This only has an effect if the list template supports foreign forms. All
@@ -900,9 +901,10 @@
the list of acronym you can use these options:
\begin{options}
\keychoice{display}{first,all,none}\Module{pages}\Default{none}
- Decide wether to include page numbers in the list of acroynms and wether
- to add the first page or every page. When you choose \code{first} and
- have \pkg{hyperref} loaded you will also get a backlink to that page.
+ Decide whether to include page numbers in the list of acroynms and
+ whether to add the first page or every page. When you choose
+ \code{first} and have \pkg{hyperref} loaded you will also get a
+ backlink to that page.
\keybool{use}\Module{pages,seq}\Default{true}
Turns a two-page range into \meta{num}\,f.\ (\latin{sequens}) and a
three-page range into \meta{num}\,ff.\ (\latin{sequentes}) when set to
@@ -1236,12 +1238,12 @@
There are also some options:
\begin{options}
\keybool{display}\Module{foreign}\Default{true}
- Determine wether to hide or display the foreign form.
+ Determine whether to hide or display the foreign form.
\keybool{display}\Module{list,foreign}\Default{true}
- \sinceversion{3.2}Determine wether to hide or display the foreign form in
+ \sinceversion{3.2}Determine whether to hide or display the foreign form in
the list of acronyms.
\keybool{display}\Module{locale}\Default{false}
- This options determines wether the language of the foreign form is printed
+ This options determines whether the language of the foreign form is printed
or not when the full form of the acronym is printed.
\keybool{display}\Module{list,locale}\Default{false}
The same but for the list of acronyms.
@@ -1368,11 +1370,11 @@
\keyval{cmd}{citation command}\Module{cite}\Default{\cs*{cite}}
Choose the command with which citations ar printed.
\keybool{group}\Module{cite}\Default{false}
- Decide wether to group citations with the short form in the parentheses.
+ Decide whether to group citations with the short form in the parentheses.
The template must support this. \acro's pre-defined templates \emph{do}
support it.
\keychoice{display}{first,all,none}\Module{cite}\Default{first}
- Decide wether to output the citation in the first/full usage only or
+ Decide whether to output the citation in the first/full usage only or
always or never.
\keyval{pre}{text}\Module{cite}\Default{\cs*{nobreakspace}}
Arbitrary code directly output before the citation.
@@ -1931,8 +1933,14 @@
\tmpl{addchap}
Only defined in a \KOMAScript\ class and if \cs*{chapter} is defined. Uses
\cs*{addchap} for the heading.
+ \tmpl{addchap*}
+ \sinceversion{3.6}Only defined in a \KOMAScript\ class and if
+ \cs*{chapter} is defined. Uses \cs*{addchap*} for the heading.
\tmpl{addsec}
Only defined in a \KOMAScript\ class. Uses \cs*{addsec} for the heading.
+ \tmpl{addsec*}
+ \sinceversion{3.6}Only defined in a \KOMAScript\ class. Uses \cs*{addsec*}
+ for the heading.
\tmpl{chapter}
Only defined if \cs*{chapter} is defined. Uses \cs*{chapter} for the heading.
\tmpl{chapter*}
@@ -1953,7 +1961,7 @@
which inserts \meta{code} when used. A template of type \meta{type} with
name \meta{name} must not exist. The default type is \code{acronym}.
\command{RenewAcroTemplate}[\oarg{type}\marg{name}\marg{code}]
- This re-defines a template of type \meta{type} woth the name \meta{name}
+ This re-defines a template of type \meta{type} with the name \meta{name}
which inserts \meta{code} when used. A template of type \meta{type} with
name \meta{name} must exist. The default type is \code{acronym}.
\command{SetupAcroTemplate}[\oarg{type}\marg{name}\marg{code}]
Modified: trunk/Master/texmf-dist/tex/latex/acro/acro.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/acro/acro.sty 2022-01-04 00:48:44 UTC (rev 61487)
+++ trunk/Master/texmf-dist/tex/latex/acro/acro.sty 2022-01-04 22:27:40 UTC (rev 61488)
@@ -8,7 +8,7 @@
% Web: https://github.com/cgnieder/acro/
% E-Mail: contact at mychemistry.eu
% --------------------------------------------------------------------------
-% Copyright 2011--2021 Clemens Niederberger
+% Copyright 2011--2022 Clemens Niederberger
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3c
@@ -27,9 +27,9 @@
% setup package:
\tl_const:Nn \c_acro_package_name_tl {acro}
-\tl_const:Nn \c_acro_date_tl {2021/01/16}
+\tl_const:Nn \c_acro_date_tl {2022/01/04}
\tl_const:Nn \c_acro_version_major_number_tl {3}
-\tl_const:Nn \c_acro_version_minor_number_tl {5}
+\tl_const:Nn \c_acro_version_minor_number_tl {6}
\tl_const:Nn \c_acro_version_subrelease_tl {}
\tl_const:Nx \c_acro_version_number_tl
{
@@ -75,7 +75,7 @@
\msg_new:nnn {acro} {unknown-option}
{
Unknown~ option~ `#1' \\
- I~ dont'~ know~ the~ option~ `#1'.~ Please~ make~ sure~ there~ is~ no~
+ I~ don't~ know~ the~ option~ `#1'.~ Please~ make~ sure~ there~ is~ no~
typo.~ Check~ the~ manual~ for~ help.
}
@@ -190,7 +190,7 @@
debug .bool_gset:N = \g__acro_debug_bool ,
debug .initial:n = false ,
upgrade .bool_gset:N = \g__acro_upgrade_bool ,
- upgrade .initial:n = true ,
+ upgrade .initial:n = false ,
final .bool_gset:N = \g__acro_final_bool ,
final .initial:n = false ,
version .choice: ,
@@ -481,6 +481,7 @@
\cs_generate_variant:Nn \seq_set_split:Nnn {Nne}
\cs_generate_variant:Nn \clist_if_empty:nTF {e}
\cs_generate_variant:Nn \clist_item:nn {e}
+\cs_generate_variant:Nn \clist_count:n {e}
\cs_generate_variant:Nn \int_set:Nn {Nx}
\cs_generate_variant:Nn \tl_set:Nn {Ne}
\cs_generate_variant:Nn \tl_remove_all:Nn {NV}
@@ -747,7 +748,7 @@
\acro_property_make_alias:nn {#6} {#7}
}
-\NewDocumentCommand \MakeAcroPropertyAlias {mm}
+\NewDocumentCommand \MakeAcroPropertyAlias{mm}
{ \acro_property_make_alias:nn {#1} {#2} }
\NewDocumentCommand \NewAcroPreset {m+m}
@@ -778,6 +779,11 @@
\NewDocumentCommand \DeclareAcronym {m+m}
{ \acro_declare_acronym:nn {#1} {#2} }
+% declaring acronyms in the document body does not work,
+% cf. https://tex.stackexchange.com/q/568856/
+% so lets prevent people from doing so:
+\@onlypreamble \DeclareAcronym
+
\NewDocumentCommand \DeclareAcroEnding {mmm}
{ \acro_declare_ending:nnn {#1} {#2} {#3} }
@@ -1009,27 +1015,8 @@
\iow_new:N \l__acro_aux_file_iow
\tl_new:N \l__acro_mdfive_hash_tl
-\acro_at_begin_document:n
- {
- \legacy_if:nT {@filesw}
- {
- \iow_now:Nx \@auxout
- { \token_to_str:N \providecommand \token_to_str:N \ACRO [1] {} }
- }
- \file_get_mdfive_hash:VN
- \c_acro_auxfile_tl
- \l__acro_mdfive_hash_tl
- \iow_open:NV \l__acro_aux_file_iow \c_acro_auxfile_tl
- }
-
\cs_new_protected:Npn \acro_close_aux:
{
- \iow_close:N \l__acro_aux_file_iow
- \file_get_mdfive_hash:VN
- \c_acro_auxfile_tl
- \l__acro_tmpa_tl
- \tl_if_eq:NNF \l__acro_mdfive_hash_tl \l__acro_tmpa_tl
- { \acro_rerun:n {general} }
\legacy_if:nT {@filesw}
{ \iow_now:Nx \@auxout { \token_to_str:N \ACRO {readaux} } }
}
@@ -1037,7 +1024,7 @@
\cs_new_protected:Npn \acro_write_to_aux:n #1
{
\legacy_if:nT {@filesw}
- { \iow_now:Nn \l__acro_aux_file_iow {#1} }
+ { \iow_now:Nn \@auxout {#1} }
}
\cs_generate_variant:Nn \acro_write_to_aux:n {x}
@@ -1978,14 +1965,20 @@
{ \prg_return_false: }
}
-\cs_new_protected:Npn \acro_check_definition:n #1
+\cs_new_protected:Npn \acro_check_definition:nT #1#2
{
- \acro_if_defined:nF {#1}
- { \msg_error:nnn {acro} {undefined} {#1} }
- \acro_boolean_property_if:nnF {#1} {used}
- { \__acro_uselist_if_used:nT {#1} { \acro_use:n {#1} } }
+ \acro_if_defined:nTF {#1}
+ {
+ \acro_boolean_property_if:nnF {#1} {used}
+ { \__acro_uselist_if_used:nT {#1} { \__acro_use:n {#1} } }
+ #2
+ }
+ { \acro_acronym_undefined:n {#1} }
}
+\cs_new_protected:Npn \acro_acronym_undefined:n #1
+ { \msg_error:nnn {acro} {undefined} {#1} }
+
% --------------------------------------------------------------------------
% use and reset:
\bool_new:N \l__acro_use_bool
@@ -2936,7 +2929,8 @@
\bool_if:NT \l__acro_barriers_bool
{
\int_compare:nNnTF
- { \intarray_count:c {g__acro_#1_barriers_intarray} } > 0
+ { \intarray_count:c {g__acro_#1_barriers_intarray} } < \g_acro_barrier_int
+ { \acro_rerun:n {barriers} }
{
\intarray_gset:cnn {g__acro_#1_barriers_intarray}
{ \int_use:N \g_acro_barrier_int }
@@ -2946,7 +2940,6 @@
+1
}
}
- { \acro_rerun:n {barriers} }
}
}
@@ -2953,7 +2946,10 @@
% #1: id
\cs_new:Npn \acro_barrier_usage:n #1
{
- \clist_if_empty:eTF { \acro_property_get:nn {#1} {barriers} }
+ \int_compare:nNnTF
+ { \clist_count:e { \acro_property_get:nn {#1} {barriers} } }
+ <
+ \g_acro_barrier_int
{0}
{
\clist_item:en
@@ -3022,8 +3018,9 @@
\keys_define:nn {acro}
{
- case-sensitive .bool_gset:N = \g__acro_case_sensitive_bool ,
- case-sensitive .initial:n = true ,
+ case-sensitive .bool_gset:N = \g__acro_case_sensitive_bool ,
+ case-insensitive .bool_gset_inverse:N = \g__acro_case_sensitive_bool ,
+ case-sensitive .initial:n = true
}
% ----------------------------------------------------------------------------
@@ -3295,15 +3292,18 @@
\acro_begin:
\l__acro_begin_command_hook_tl
\cs_set:Npn \nospace { \exp:w \exp_end_continue_f:w }
- \acro_check_definition:n {####1}
- \keys_set:nV {acro} \l__acro_options_tl
- \tl_set:Ne \l_acro_id_tl { \acro_case_insensitive:n {####1} }
- \tl_set_eq:NN \AcronymID \l_acro_id_tl
- ##3
- \acro_finalize:ne
- { \l__acro_star_bool }
- { \acro_case_insensitive:n {####1} }
- \l__acro_end_command_hook_tl
+ \acro_check_definition:nT
+ {####1}
+ {
+ \keys_set:nV {acro} \l__acro_options_tl
+ \tl_set:Ne \l_acro_id_tl { \acro_case_insensitive:n {####1} }
+ \tl_set_eq:NN \AcronymID \l_acro_id_tl
+ ##3
+ \acro_finalize:ne
+ { \l__acro_star_bool }
+ { \acro_case_insensitive:n {####1} }
+ \l__acro_end_command_hook_tl
+ }
\acro_end:
}
\use:x
@@ -3842,8 +3842,8 @@
\acro_if_komascript:TF
{
\cs_if_exist:NTF \chapter
- { \keys_set:nn {acro/list}{ heading = addchap } }
- { \keys_set:nn {acro/list}{ heading = addsec } }
+ { \keys_set:nn {acro/list}{ heading = addchap* } }
+ { \keys_set:nn {acro/list}{ heading = addsec* } }
}
{
\cs_if_exist:NTF \chapter
@@ -4411,12 +4411,17 @@
% hyper linking
\bool_new:N \l__acro_hyperref_use_bool
\bool_new:N \l__acro_link_only_first_bool
+\bool_new:N \l__acro_link_back_bool
\cs_new_eq:NN \__acro_hyper_target:nn \use_ii:nn
\cs_new_eq:NN \__acro_hyper_link:nn \use_ii:nn
+\cs_new_eq:NN \__acro_hyper_back_target:nn \use_ii:nn
+\cs_new_eq:NN \__acro_hyper_back_link:nn \use_ii:nn
\cs_generate_variant:Nn \__acro_hyper_target:nn {e}
\cs_generate_variant:Nn \__acro_hyper_link:nn {e}
+\cs_generate_variant:Nn \__acro_hyper_back_target:nn {e}
+\cs_generate_variant:Nn \__acro_hyper_back_link:nn {e}
\cs_new_protected:Npn \__acro_activate_hyperref_support:
{
@@ -4432,6 +4437,8 @@
{ \cs_set_eq:NN \__acro_hyper_link:nn \hyperlink }
\cs_set:Npn \__acro_hyper_target:nn ##1##2
{ \raisebox {3ex} [0pt] { \hypertarget {##1} { } } ##2 }
+ \cs_set_eq:NN \__acro_hyper_back_link:nn \__acro_hyper_link:nn
+ \cs_set_eq:NN \__acro_hyper_back_target:nn \__acro_hyper_target:nn
}
}
@@ -5050,9 +5057,22 @@
\acro_new_patch:n {tabu}
\acro_new_patch:n {ltxtable}
\acro_new_patch:n {caption}
+\acro_new_patch:n {maketitle}
\AtEndPreamble
{
+ % maketitle:
+ \acro_if_patch:nT {maketitle}
+ {
+ \pretocmd \maketitle
+ { \acswitchoff }
+ {}
+ { \msg_error:nnn {acro} {patch} {maketitle} }
+ \apptocmd \maketitle
+ { \acswitchon }
+ {}
+ { \msg_error:nnn {acro} {patch} {maketitle} }
+ }
% floats:
\acro_if_patch:nT {floats}
{
@@ -5219,7 +5239,7 @@
)
}
}
-
+
\NewAcroTemplate {footnote}
{
\acrowrite {short}
@@ -5278,6 +5298,8 @@
{
\NewAcroTemplate[heading] {addsec}
{ \addsec { \acrolistname } }
+ \NewAcroTemplate[heading] {addsec*}
+ { \addsec* { \acrolistname } }
}
\cs_if_exist:NT \chapter
@@ -5290,6 +5312,8 @@
{
\NewAcroTemplate[heading] {addchap}
{ \addchap { \acrolistname } }
+ \NewAcroTemplate[heading] {addchap*}
+ { \addchap* { \acrolistname } }
}
}
@@ -5534,7 +5558,7 @@
{
Fallback = pp\abbrdot ,
English = pp\abbrdot ,
- French = pp\abbrdot ,
+ French = p\abbrdot ,
German = S\abbrdot ,
Italian = pp\abbrdot ,
Portuguese = pp\abbrdot ,
More information about the tex-live-commits
mailing list.